JTL Shop 5 Plugin

• JTL-Shop 5.5.0 – 5.9.9
• Ein AUSGEZEICHNET.org Account mit Zugriff auf das Kundencenter
• Für Feature „Automatische Einladung": ein AUSGEZEICHNET.org API-Schlüssel (im Kundencenter erstellbar)
• Für „Manuelle Shop-Bewertungseinladung" (Tools & Setup): AUSGEZEICHNET.org PROFESSIONAL-Plan

1. Admin-Backend → Plugins → Übersicht → Plugin hochladen
2. ausgezeichnet_jtl5.zip auswählen und hochladen
3. Plugin in der Liste aktivieren
4. Beim ersten Aktivieren legt das Plugin automatisch die Tabelle xplugin_ausgezeichnet_jtl5_invites an (Migration Migration20260629000001). Das ist die Tracking-Tabelle für die automatische Einladung (siehe Abschnitt 2.4) – hier ist keine manuelle Aktion nötig.

Tab Tools & Setup öffnen (letzter Reiter des Plugins) → Abschnitt „Konfigurationsstatus" zeigt für jedes Pflichtfeld ✓/✗.

• Schwebendes Siegel/Badge „Dynamic Seal" und „Trust Badge" schließen sich gegenseitig aus – nur eines aktivieren.
• Review Modal / Collector / Slider / Carousel Jeweils eigenständig aktivierbar. Erfordern ein Platzhalter-Element im Shop-Template (ID/Attribut laut AUSGEZEICHNET.org Dashboard) – ohne passenden Platzhalter erscheint nichts, obwohl das Skript geladen wird.
• Produkt-Bewertungswidget Zeigt Bewertungen auf Produktseiten, liest SKU/GTIN aus den Produkt-Datenattributen des Templates. Darstellungstyp (Badge/Hero/Horizontal) separat wählbar.
• Review Collector (Legacy) Nur auf ausdrückliche Empfehlung des AUSGEZEICHNET.org Supports aktivieren.
• Ausgeschlossene Seiten Eine URL-Teilzeichenkette pro Zeile (z. B. /bestellvorgang, /mein-konto, /warenkorb). Auf passenden Seiten werden keine Widgets geladen – die Einwilligungs-Checkbox (siehe 2.3) wird davon nicht beeinflusst und weiterhin angezeigt.

Option A – Automatisch injizieren (empfohlen)

1. Tab Tools & Setup öffnen
2. Abschnitt „E-Mail Bewertungsblock – Auto-Setup" → Button „▶ Bewertungsblock einfügen" klicken
3. Das Plugin hängt an die ausgewählten E-Mail-Templates (temailvorlage) einen mit markierten Smarty-Snippet an
4. Über „✕ Bewertungsblock entfernen" lässt sich das wieder rückgängig machen

Die Tabelle in diesem Abschnitt zeigt, welche der drei Templates (Bestellbestätigung, Versandbestätigung, Rechnung) bereits injiziert sind.

Option B – Manuell im Template einbinden

In ein beliebiges E-Mail-Template einfügen:

{ausgezeichnet_email_block kBestellung=$oBestellung->kBestellung collmethod="pos"}

• collmethod="pos" → Point of Sale (z. B. Bestellbestätigung / Rechnung)
• collmethod="af" → After Fulfillment (z. B. Versandbestätigung)

• Automatische Einladung aktiviert Hauptschalter.
• Trigger: Nach Zahlung/Rechnung Löst aus, wenn die Bestellung Status „In Bearbeitung" erhält.
• Trigger: Nach Versand/Abschluss Löst aus, wenn die Bestellung Status „Versandt/Abgeschlossen" erhält. Sinnvoll bei digitalen Produkten oder wenn „In Bearbeitung" übersprungen wird.
• Verzögerung in Tagen (0–30) Wartezeit, die AUSGEZEICHNET.org selbst einhält, bevor die Einladungs-E-Mail verschickt wird (z. B. 7 Tage, damit das Paket ankommen kann).
• Collection Method „After Fulfillment" oder „Point of Sale" – nur für die Shop-Bewertungseinladung relevant.
• Shop-Bewertungseinladung senden Eine Einladung pro Bestellung für die Gesamt-Shop-Bewertung.
• Produkt-Bewertungseinladungen senden Eine Einladung pro Bestellposition (SKU/Artikelnummer, Fallback: interne Artikel-ID).
• Einwilligung erforderlich Wenn aktiviert: Checkbox im Checkout, standardmäßig nicht vorangehakt (Opt-in). Wenn deaktiviert: alle Kunden gelten als eingewilligt.

Beim Bestellabschluss (Hook HOOK_BESTELLABSCHLUSS_INC_BESTELLUNGINDB_ENDE) legt das Plugin pro Bestellung genau einen Datensatz in xplugin_ausgezeichnet_jtl5_invites an (E-Mail, Name, Einwilligung, Status). Beim Statuswechsel (Hook HOOK_BESTELLUNGEN_XML_BESTELLSTATUS) prüft das Plugin diesen Datensatz:

• Kein Datensatz vorhanden → Bestellung existierte vor Plugin-Installation, Einladung wird übersprungen (Log-Eintrag „notice")
• bConsent = 0 → Kunde hat nicht eingewilligt, keine Einladung
• bSent = 1 → bereits gesendet, keine doppelte Einladung (auch bei mehrfachem Statuswechsel)

Erst wenn die API-Aufrufe erfolgreich waren, wird bSent = 1 und dGesendet gesetzt.

• Konfigurationsstatus: Live-Übersicht, ob Organisation-ID, Kontonummer, Bewertungs-ID, Bewertungs-URL und API-Schlüssel gesetzt sind
• E-Mail Bewertungsblock – Auto-Setup: siehe 2.2a
• Manuelle Shop-Bewertungseinladung: Einmalige Einladung an eine beliebige E-Mail-Adresse, unabhängig vom Bestellprozess. Erfordert einen konfigurierten API-Schlüssel und den AUSGEZEICHNET.org PROFESSIONAL-Plan.

Widgets erscheinen nicht

• Organisation-ID prüfen
• Aktuelle Seiten-URL gegen die Liste „Ausgeschlossene Seiten" prüfen
• Bei Modal/Collector/Slider/Carousel: nötiges Platzhalter-Element im Template prüfen

E-Mail-Bewertungslink erscheint nicht

• Bewertungs-URL, Kontonummer und Bewertungs-ID müssen gesetzt sein (Status-Tabelle in Tools & Setup)
• Bei Methode 2.2a: prüfen, ob das Template als ✓ Ja markiert ist

Automatische Einladung wird nicht versendet

• Hauptschalter aktiv?
• Mindestens ein Trigger aktiv? (Warnhinweis in Tools & Setup beachten)
• API-Schlüssel gesetzt?
• Einwilligung des Kunden vorhanden? (bConsent)
• Wurde bereits gesendet? (bSent)
• Log auf HTTP-Fehler der AUSGEZEICHNET.org API prüfen

Änderungen wirken nicht sofort

• Seite neu laden bzw. Browser-/Shop-Cache leeren, falls Seiten aus dem Cache ausgeliefert werden

• Kein automatischer Retry bei fehlgeschlagenen Einladungs-API-Aufrufen (siehe 2.4)
• Die Einwilligungs-Checkbox wird anhand von URL-Mustern (/bestellvorgang, /checkout) bzw. Smarty-Seitentyp erkannt; bei stark angepassten Checkout-Templates ggf. die CSS-Selektoren in OutputFilterHook::maybeInjectConsentCheckbox() anpassen
• Manuelle Einladung (Tools & Setup) und automatische Produkt-/Shop-Bewertungseinladungen erfordern unterschiedliche AUSGEZEICHNET.org Plan-Stufen – im Zweifel im Kundencenter prüfen