Custom Integrations
Custom Integrations ist ein optionales Modul, mit dem Sie eigene Inline-Code-Snippets in den Head- oder Footer-Bereich Ihres Shops einfügen können. Jedem Snippet wird eine Einwilligungskategorie zugewiesen, und es wird über das Gate des Einwilligungsmanagers ausgegeben, sodass es erst läuft, nachdem der Besucher diese Kategorie erteilt hat. So können Sie Codes für Tools wie Meta Pixel, TikTok, Matomo oder Google Consent Mode auf eine Weise laden, die die Entscheidung des Besuchers respektiert.
Den Code liefern Sie selbst. Das Plugin sendet keine ausgehende HTTP-Anfrage aus PHP und hat keine Endpunkte von Drittanbietern fest hinterlegt. Dies sind Werkzeuge, die Ihnen helfen, Ihre eigenen Snippets verantwortungsvoll zu laden, sie stellen keine Rechtsberatung dar und garantieren für sich genommen kein bestimmtes rechtliches Ergebnis.
Aktivieren des Moduls
Section titled “Aktivieren des Moduls”Das Modul ist standardmäßig deaktiviert. Aktivieren Sie es unter WooCommerce > Polski > Module (im Abschnitt “Custom Integrations”). Nach der Aktivierung werden Snippets im Frontend des Shops ausgegeben, niemals im Adminbereich. Die Verwaltung der Einstellungen erfordert die Berechtigung manage_woocommerce.
Funktionsweise
Section titled “Funktionsweise”Jedes Snippet wird durch den Einwilligungsmanager kontrolliert. Anstelle eines sofort ausführbaren Skripts wird ein Platzhalter auf der Seite ausgegeben, und der Frontend-Controller des Einwilligungsmanagers ersetzt ihn erst durch ein funktionierendes Skript, nachdem die passende Kategorie erteilt wurde. Snippets in der Kategorie “Notwendig” werden immer aktiviert.
| Aspekt | Verhalten |
|---|---|
| Platzierung | Head-Snippets werden in wp_head ausgegeben, Footer-Snippets in wp_footer (Priorität 30). |
| Nur Frontend | Snippets werden niemals im Adminbereich ausgegeben. |
| Einwilligungs-Gate | Jedes Snippet durchläuft das Gate des Einwilligungsmanagers und wartet auf die Erteilung seiner Kategorie. |
| Notwendig | Snippets in der Kategorie “Notwendig” laufen immer, ohne auf eine Einwilligung zu warten. |
| Kein PHP-Verkehr | Das Plugin sendet keine HTTP-Anfrage vom Server, es wird ausschließlich Ihr eigener Code geladen. |
Snippet-Felder
Section titled “Snippet-Felder”Die Snippet-Liste ist wiederholbar, sodass Sie so viele Snippets hinzufügen können, wie Sie benötigen. Jede Zeile hat die folgenden Felder:
| Feld | Beschreibung |
|---|---|
| Bezeichnung | Ein menschenlesbarer Name für das Snippet, damit Sie es in der Liste wiedererkennen. Optional. |
| Platzierung | head oder footer. Standardwert ist Footer. |
| Einwilligungskategorie | Die Kategorie des Einwilligungsmanagers, die erteilt werden muss, bevor das Snippet läuft. Ein nicht erkannter Wert wird als “Notwendig” behandelt. |
| Code | Das Snippet selbst. Zeilen mit leerem Code werden übersprungen. |
Wie der Code verarbeitet wird
Section titled “Wie der Code verarbeitet wird”Wenn Ihr Snippet in ein einzelnes <script>...</script>-Tag eingeschlossen ist, wird sein innerer Inhalt extrahiert und als Skriptinhalt an das Gate übergeben. Wenn Sie reines JavaScript ohne Tag einfügen, wird es als Inline-Skriptinhalt behandelt. Jegliches Markup außerhalb des <script>-Tags wird verworfen, sodass nur der Skriptinhalt das Gate erreicht (der Platzhalter bleibt text/plain, bis die Einwilligung erteilt wird).
Einstellungen
Section titled “Einstellungen”Die Einstellungen befinden sich auf der Modulkarte unter WooCommerce > Polski > Module. Die Snippet-Liste wird als eine einzige wiederholbare Einstellung gespeichert.
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Snippet-Liste | (leer) | Eine wiederholbare Liste von Snippets (Bezeichnung, Platzierung, Kategorie, Code). |
Fehlerbehebung
Section titled “Fehlerbehebung”Ein Snippet läuft nicht - prüfen Sie, ob der Besucher die dem Snippet zugewiesene Einwilligungskategorie erteilt hat. Snippets außer “Notwendig” warten auf die Einwilligung. Stellen Sie sicher, dass auch der Einwilligungsmanager aktiv ist.
Ein Snippet erscheint nicht im Seitenquelltext - stellen Sie sicher, dass das Code-Feld nicht leer und das Modul aktiviert ist. Snippets werden nicht im Adminbereich ausgegeben, prüfen Sie daher das Frontend des Shops.
Ein Teil des Codes verschwindet - nur der Skriptinhalt erreicht das Gate. Markup und Code außerhalb eines einzelnen <script>...</script>-Tags werden verworfen. Fügen Sie JavaScript ein oder schließen Sie es in ein einzelnes <script>-Tag ein.
Probleme melden: github.com/wppoland/polski/issues