Das Modul installieren und aktivieren:

cd [shopware6 root folder]
php bin/console plugin:refresh
php bin/console plugin:install ZweidigitalTiktokPlugin
php bin/console plugin:activate ZweidigitalTiktokPlugin
php bin/console cache:clear

Das Modul kann aber auch direkt über das Shopware Administrations Panel installiert werden.

Frontend kompilieren:

Mit diesem Shopware 6 Befehl wird das Javascript des Front- und Backends kompiliert:

cd [shopware6 root folder]
./bin/build-js.sh

Dieser Schritt ist zwingend notwendig, damit das Modul funktioniert.

Das Plugin umfasst folgende Konfigurationsmöglichkeiten:

• Verkaufskanal Auswahl
• TikTok Pixel IDs
  (Mehrere ID können durch Komma getrennt angegeben werden)
• Preisübermittlung mit/ohne Versandkosten
• Brutto-/Netto-Preise übergeben
• (SW5 only, SW6 orientiert sich an der Shopeinstellung)
• Artikelidentifikation über Artikelnummer oder interne ID
• Datenschutzmodus
  • Shopware Cookie Consent Tool (Opt-in)
  • Shopware Cookie Consent Tool (Opt-out)
  • Opt-In/-Out über externe Lösung (Javascript-Code)
  • Aktiv ohne Hinweis

Wird ein anderes Tool für den Consent verwenden, wie z.B. der Google Tag Manager, CookieBot oder Usercentrics, muss das Plugin entsprechend eingestellt werden im Backend. Es können folgende Javascripte zur Aktivivierung/Deaktivierung verwendet werden.

Mit dem diesem JavaScript kann der Pixel manuell gestartet werden (Opt-In):

Shopware 5:

$(document).ready(function () {
$.publish(‚plugins/ZweidigitalTiktokPlugin/remoteEnable‘);
});

Shopware 6:

window.addEventListener(‚load‘, function() {
const plugin = PluginManager.getPluginInstanceFromElement(document,
‚ZweidigitalTiktokPlugin‘);
if (typeof plugin === ‚object‘ && typeof plugin.remoteEnable === ‚function‘)
{ plugin.remoteEnable();
}
});

Mit dem diesem JavaScript kann der Pixel gestoppt werden (Opt-Out):

Shopware 5:

$.publish(‚plugins/ZweidigitalTiktokPlugin/remoteDisable‘);

Shopware 6:

window.addEventListener(‚load‘, function() {

const plugin = PluginManager.getPluginInstanceFromElement(document,
‚ZweidigitalTiktokPlugin‘);
if (typeof plugin === ‚object‘ && typeof plugin.remoteDisable === ‚function‘) {
plugin.remoteDisable();
}
});

Bei den meisten Cookie Lösungen von externen Anbietern, wie z.B. CookieBot oder Usercentrics (CMP) muss der oben gezeigte JavaScript Code Teil zwischen < script > Tags gesetzt werden, die bestimmte Attribute erfordern. Das kann im Fall von Usercentrics (CMP) zum Beispiel so aussehen:

<script data-usercentrics=„TikTok Pixel„ type=„text/plain„> // Hier JavaScript zum Starten des Facebook Pixel’s einfügen </script>