PS PrestaShop Anfänger

Header/Footer Code-Injektor (CSS/JS): vollständige Anleitung

CSS-, JS- und HTML-Code einfügen: Installation, Positionen, Seiten-Targeting, Testmodus, Duplizieren und Multishop für PrestaShop 8 und 9.

Aktualisiert Modulversion 1.1.0

Überblick

Der Header/Footer Code-Injektor fügt CSS-, JavaScript- oder HTML-Code in Ihren PrestaShop-Shop ein, ohne die Theme-Dateien zu ändern. Jeder Codeblock ist ein Snippet, das im Back-Office verwaltet wird, mit eigener Position, Zielseiten, Einfügereihenfolge und Status.

Typische Einsätze: Google Tag Manager, Google Analytics, Meta Pixel, Verifizierungs-Tags (Search Console, Pinterest), eigenes CSS, Chat-Widget.

Installation

  1. Laden Sie das Archiv dfcodeinjector.zip aus Ihrem DataFirefly-Konto herunter.
  2. Öffnen Sie im Back-Office Module > Modul-Manager, klicken Sie auf Modul hochladen und legen Sie das Archiv ab.
  3. Klicken Sie auf Konfigurieren, um die Snippet-Liste zu öffnen.

Kompatibel mit PrestaShop 8.0 bis 9.x und Multishop. Oberfläche auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.

Update von Version 1.0.0

Laden Sie das neue Archiv über den Modul-Manager hoch: Das Update läuft automatisch und Ihre Snippets bleiben erhalten. Ein Snippet, das auf bestimmte Seiten beschränkt war, erhält das Targeting Nur die ausgewählten Seiten, alle anderen Alle Seiten.

Ein Snippet anlegen

Klicken Sie in der Liste auf Snippet hinzufügen.

Formularfelder

  • Name: interner Name, zum Beispiel „Google Tag Manager“.
  • Position: wo der Code eingefügt wird (siehe unten).
  • Code: der vollständige Code samt Tags. Er wird unverändert eingefügt. In diesem Feld fügt die Tab-Taste 4 Leerzeichen ein; mit Escape und danach Tab wechseln Sie zum nächsten Feld.
  • Targeting, Seiten und Weitere Seiten: die Seiten, auf denen das Snippet gilt.
  • Reihenfolge: Einfügereihenfolge innerhalb einer Position. Bleibt das Feld leer, wird das Snippet ans Ende gesetzt.
  • Testmodus: beschränkt das Einfügen auf die Wartungs-IP-Adressen.
  • Aktiv: aktiviert oder deaktiviert das Snippet, ohne es zu löschen.
  • Shop (nur Multishop): alle Shops oder ein einzelner.

Die drei Positionen

  • Header (head-Tag): Styles, Meta-Tags, Verifizierungs-Tags, Hauptskript von GTM. Hook displayHeader.
  • Body-Anfang: direkt nach dem öffnenden body-Tag, für den noscript-Teil von GTM. Hook displayAfterBodyOpeningTag.
  • Body-Ende: direkt vor dem schließenden body-Tag, für Tracking- und Chat-Skripte. Hook displayBeforeBodyClosingTag.

Ruft Ihr Theme die Hooks für Body-Anfang oder Body-Ende nicht auf, fügt das Modul den Code an derselben Stelle direkt in das fertige HTML der Seite ein (Hook actionOutputHTMLBefore). Alle drei Positionen funktionieren also mit jedem Theme, ohne Einstellung.

Seiten-Targeting

Das Feld Targeting bietet drei Modi: Alle Seiten, Nur die ausgewählten Seiten oder Alle Seiten außer den ausgewählten.

Die Liste Seiten enthält 30 PrestaShop-Seiten: Startseite, Kategorie, Produktseite, CMS, Suche, Warenkorb, Bestellvorgang, Bestellbestätigung, Anmeldung, Mein Konto, Bestellverlauf, Kontakt, 404-Seite usw. Das Feld Weitere Seiten nimmt weitere technische Seitennamen auf, durch Kommas getrennt. Für eine Modulseite lautet das Format module-modulname-controller.

Den technischen Namen einer Seite finden Sie im Quelltext: Im Classic-Theme und seinen Ableitungen ist es das Attribut id des body-Tags.

Testmodus

Ein Snippet im Testmodus wird nur für die IP-Adressen eingefügt, die unter Shop-Parameter > Allgemein > Wartung (Feld Wartungs-IP) hinterlegt sind. CIDR-Bereiche sind möglich. So prüfen Sie ein Tag im Live-Shop, ohne dass ein Besucher es erhält, und schalten den Testmodus danach aus, um es zu veröffentlichen.

Snippet duplizieren

Das Menü jeder Zeile der Liste bietet Duplizieren. Die Kopie wird deaktiviert angelegt und ans Ende gesetzt: Prüfen Sie sie, bevor Sie sie aktivieren.

Beispiele

Google Tag Manager

GTM benötigt zwei Snippets:

  1. „GTM head“, Position Header, mit dem ersten von Google bereitgestellten Skript:
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){ ... })(window,document,'script','dataLayer','GTM-XXXXXX');</script>
<!-- End Google Tag Manager -->
  1. „GTM body“, Position Body-Anfang, mit dem noscript-Teil von Google.

Conversion-Pixel

Position Body-Ende, Targeting Nur die ausgewählten Seiten, Seite Bestellbestätigung. Das Pixel löst nur nach einem Kauf aus.

Eigenes CSS

Position Header, CSS in einem style-Tag:

<style>
.header-banner { background:#0f172a; color:#fff; }
</style>

Verifizierungs-Tag

Für die Search Console oder ein soziales Netzwerk, Position Header:

<meta name="google-site-verification" content="IHR_CODE" />

Multishop

Bei aktiviertem Multishop legt das Feld Shop fest, ob ein Snippet in allen Shops oder nur in einem läuft. Bei einer Installation mit nur einem Shop ist das Feld ausgeblendet und das Snippet gilt für den ganzen Shop.

Fehlerbehebung

  • Der Code erscheint nicht: Prüfen Sie, ob das Snippet aktiv ist, ob der Testmodus aus ist (oder Ihre IP unter den Wartungs-IPs steht) und ob die aktuelle Seite zum Targeting gehört.
  • Ein Full-Page-Cache-Modul ist installiert: Leeren Sie dessen Cache nach jeder Änderung an einem Snippet.
  • Das Snippet erscheint nicht auf einer Modulseite: Prüfen Sie den unter Weitere Seiten eingetragenen technischen Namen, er muss exakt dem der Seite entsprechen.
  • Zwei Skripte laufen in der falschen Reihenfolge: Passen Sie das Feld Reihenfolge an.

Der Code wird ohne jede Filterung eingefügt. Prüfen Sie die Syntax (korrekt geschlossene Tags) und nutzen Sie den Testmodus, bevor Sie ihn in einem Produktiv-Shop aktivieren.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren