FAQ & Troubleshooting
Häufige Fragen
Brauche ich IonCube oder einen API-Schlüssel?
Nein. Das Plugin wird unverschlüsselt ausgeliefert und benötigt weder einen IonCube-Loader noch externe Dienste oder API-Schlüssel. Es läuft auf jeder Standard-JTL-Hosting-Umgebung ab JTL-Shop 5.3.0 mit PHP 8.1+.
Verändert das Plugin meine Preise oder den Warenkorb?
Nein. Beim Entfernen der JTL-Microdata werden ausschließlich die itemscope/itemtype-Hüllen entfernt — jedes itemprop bleibt erhalten. Die NOVA-Preislogik (jtl.article.js) und PayPal Express lesen weiterhin meta[itemprop=price] und span[itemprop=sku]. Preis-, Warenkorb- und Bezahlfunktionen laufen unverändert.
Search-Console-Fehler zu fehlendem Preis (price / priceSpecification.price) — was tun?
Dieser Fehler stammt typischerweise aus der unvollständigen Microdata des NOVA-Templates, nicht aus diesem Plugin. Stelle sicher, dass die Option „JTL-Microdata entfernen” im Tab Allgemein aktiv ist (Standard). Sie beseitigt die konkurrierende, fehlerhafte Datenquelle. Prüfe anschließend im Validierungs-Tab, dass pro Seite nur noch genau ein JSON-LD-Block ausgegeben wird.
Der Validierungs-Tab findet mehrere JSON-LD-Blöcke.
Das Plugin liefert pro Seite genau einen konsolidierten Block. Weitere Blöcke stammen von einem anderen Plugin oder einer Template-Anpassung. Identifiziere und entferne diese zusätzlichen Snippets, damit die Seite eine einzige, kohärente Datenquelle hat.
Warum erscheint mein Produkt nicht als Rich Result bei Google?
Strukturierte Daten sind die technische Voraussetzung — die Anzeige entscheidet Google selbst und braucht oft Zeit. Prüfe zuerst mit dem Rich Results Test, ob die Daten valide sind (0 Fehler). Stelle sicher, dass Pflichtfelder gepflegt sind (Preis, Verfügbarkeit) und beobachte die Search Console über mehrere Tage.
Wie aktiviere ich eine FAQPage auf einer CMS-Seite?
Setze den Marker <!--msd:faq--> irgendwo in den HTML-Inhalt der Seite. Das Plugin parst dann jede <h2>/<h3>, die auf „?” endet, und nimmt den unmittelbar folgenden <p>-Absatz als Antwort. Ohne Marker wird kein FAQPage-Knoten erzeugt.
Muss ich Zahlungsmethoden manuell konfigurieren?
In der Regel nicht. Das Plugin liest deine aktiven JTL-Zahlungsmodule automatisch aus und ordnet sie dem passenden schema.org-Typ zu. Eine Überschreibung ist nur nötig, wenn ein Modul als „nicht erkannt” angezeigt wird oder du Label bzw. URI anpassen möchtest.
Warum hat mein Vaterartikel keine GTIN?
Ein Vaterartikel ist eine ProductGroup und damit kein einzelnes Trade-Item — schema.org sieht hier keine GTIN vor. Pflege Barcodes je Variante an den Kindartikeln; sie erscheinen dann als gtin13 in hasVariant[]. Ungültige Barcodes werden über eine GS1-Prüfziffernkontrolle automatisch ausgelassen.
Meine Änderungen erscheinen nicht sofort in der Ausgabe.
Bei aktivem Cache kann die alte Ausgabe kurz bestehen bleiben. Das Plugin invalidiert nur seinen eigenen Cache und erneuert die Ausgabe bei strukturellen Änderungen automatisch. Zur Fehlersuche kannst du den Cache im Tab Allgemein vorübergehend deaktivieren.
Funktioniert das Plugin mit meinem angepassten Template?
Ja, sofern es sich um das NOVA-Template oder ein davon abgeleitetes Child-Template handelt. Das Plugin hängt die Ausgabe über den Smarty-Output-Filter an und ist nicht auf spezifische Template-Dateien angewiesen.
Was passiert nach Ablauf meiner Lizenz?
Die zuletzt installierte Version läuft unverändert weiter. Du erhältst nach Ablauf keine neuen Versionen, Sicherheitsupdates oder Support mehr. Es entsteht kein automatisches Abo — die Lizenz verlängert sich nur, wenn du es möchtest. (Details: siehe Lizenz.)