Konfiguration: Allgemein, Organisation & Rückgabe
Nach der Installation findest du die Einstellungen im JTL-Backend unter Plugins → Plugin-Manager → Structured Data (JSON-LD). Die Konfiguration ist auf mehrere Tabs verteilt. Diese Seite beschreibt die drei reinen Einstellungs-Tabs Allgemein, Organisation und Rückgabe. Die Tabs mit eigenen Verwaltungsmasken behandeln die Seiten Standorte und Versand & Zahlung.
Tab „Allgemein”
Hier schaltest du das Plugin scharf und legst fest, welche Schema-Typen auf welchen Seiten ausgegeben werden. Die Standardwerte sind so gewählt, dass das Plugin direkt nach der Aktivierung sinnvoll arbeitet.
| Einstellung | Standard | Wirkung |
|---|---|---|
| Plugin aktivieren | Ja | Gibt das JSON-LD im Storefront aus. Bei „Nein” passiert nichts. |
| JSON formatiert ausgeben (Debug) | Nein | Rückt die Ausgabe ein (lesbar). Im Produktivbetrieb deaktiviert lassen. |
| Cache aktivieren | Ja | Speichert den gerenderten Produktknoten je Artikel/Kundengruppe/Sprache zwischen. |
| WebSite + SearchAction (Startseite) | Ja | Aktiviert die Google-Sitelinks-Suchleiste. |
| BreadcrumbList ausgeben | Ja | Pfad-Darstellung in den Suchergebnissen. |
| ItemList (Kategorie/Suche) | Ja | Schlanke Liste der gelisteten Produkt-URLs. |
| Article (News-Detail) | Ja | Article-Schema für News-Beiträge. |
| FAQPage (CMS-Seiten) | Ja | Nur aktiv, wenn der Seiteninhalt den Marker <!--msd:faq--> enthält. |
| JTL-Microdata entfernen | Ja | Entfernt die NOVA/JTL-Microdata-Hüllen, sodass nur dieses JSON-LD bleibt. |
| Max. Einzel-Reviews pro Produkt | 5 | 0 = nur AggregateRating, keine einzelnen Review-Knoten. |
| acceptedPaymentMethod ausgeben | Ja | Zahlungsarten je Offer. Google wertet das nicht aus — spart ~1–2 KB pro Produkt. |
| Beschreibung: Fallback-Zeichenlimit | 2000 | Zeichen aus der Langbeschreibung, wenn keine Kurzbeschreibung gepflegt ist. 0 = kein Fallback. |
| Debug: Graph ins Log schreiben | Nein | Schreibt den Graph 1×/Min. pro Schlüsselseite ins Shop-Log. Nur zur Fehlersuche. |
| Debug: vollständiges Payload ins Log | Nein | Schreibt das komplette JSON-LD ins Log. Nie im Produktivbetrieb. |
Microdata-Entfernung greift global
Diese Option entfernt ausschließlich die itemscope/itemtype-Hüllen — jedes itemprop bleibt erhalten, damit die NOVA-Preislogik (jtl.article.js) und PayPal Express weiterhin meta[itemprop=price] / span[itemprop=sku] lesen können. Sie wirkt auf jeder Storefront-Seite, solange das Plugin aktiv ist — unabhängig von den seitentyp-spezifischen Schaltern darüber. Da der Organisations-Knoten ohnehin auf jeder Seite als JSON-LD ausgegeben wird, bleibt immer mindestens eine Datenquelle erhalten.
Folge: Schaltest du oben einen Seitentyp ab (z. B. Article), wird die zugehörige NOVA-Microdata auf diesen Seiten trotzdem entfernt, ohne durch ein gleichwertiges JSON-LD ersetzt zu werden. Solche Schalter also nur deaktivieren, wenn du das jeweilige Rich-Result wirklich nicht brauchst.
Debug-Optionen nach der Fehlersuche wieder ausschalten
„JSON formatiert ausgeben” und die beiden Debug-Log-Optionen sind reine Diagnose-Werkzeuge. Das vollständige Payload im Log kann Preise und Bewertungstexte enthalten — ein Datenschutzrisiko. Im Live-Betrieb gehören alle drei auf „Nein”.
Tab „Organisation”
Diese Daten beschreiben dein Unternehmen als zentrale Entität. Der Organisations-Knoten erscheint auf jeder Seite; alle anderen Knoten verweisen per @id auf ihn. Je vollständiger diese Angaben sind, desto stärker das Signal für den Google Knowledge Graph und KI-Suchsysteme.
| Feld | Hinweise |
|---|---|
| Firmenname | Offizieller Name wie im Impressum. Leer = JTL-Shopname wird automatisch verwendet. |
| Unternehmensbeschreibung | 1–3 Sätze (ca. 150–300 Zeichen). Wird von KI-Übersichten stark zur Einordnung genutzt. |
| Telefon (E.164) | Internationale Schreibweise ohne Leerzeichen, z. B. +4922112345678. |
| Logo-URL (optional) | Nur ausfüllen, wenn das Shop-Logo nicht automatisch erkannt wird. Absolute HTTPS-URL, quadratisch, ≥ 112×112 px. |
| sameAs-Verknüpfungen | Eine URL pro Zeile: Wikipedia, Wikidata, Facebook, Instagram, LinkedIn, YouTube, X, Google Business. |
| Suche: URL-Vorlage | Pfad für die Sitelinks-Suchleiste. Platzhalter {search_term_string}. Leer = JTL-Standard /navi.php?suche={search_term_string}. |
| Servicegebiet | ISO-Ländercodes, kommagetrennt (z. B. DE, AT, CH). Standard: DE. |
Was das Plugin automatisch absichert
Eine Logo-URL wird nur übernommen, wenn sie eine gültige http(s)-Adresse ist. sameAs-Zeilen, die keine gültige URL sind, werden verworfen. Beim Servicegebiet bleiben nur korrekte zweistellige Ländercodes übrig; ist nichts Gültiges angegeben, fällt das Plugin auf DE zurück.
Tab „Rückgabe”
Die hier hinterlegten Bedingungen werden als MerchantReturnPolicy in jedes Angebot übernommen. Sie betreffen ausschließlich die schema.org-Ausgabe — nicht den tatsächlichen Shop-Betrieb oder deine rechtlichen Pflichten.
| Feld | Standard | Werte |
|---|---|---|
| Geltungsland | DE | ISO-3166-1 alpha-2, z. B. DE, AT, CH. |
| Rückgabefrist (Tage) | 14 | EU-Minimum: 14. Großzügigere Fristen (30/60/100) können die Conversion verbessern. |
| Rücksendekosten | Kostenlos für den Kunden | FreeReturn oder „Kunde trägt Rücksendekosten” (ReturnShippingFees). |
| Rückgabemethode | Per Post / Paketdienst | ReturnByMail, ReturnInStore oder ReturnAtKiosk. |
Rückgabebedingungen wirken vertrauensbildend
„Kostenlose Rückgabe” und eine großzügige Frist werden in Google-Shopping-Anzeigen und Rich Results angezeigt und beeinflussen die Kaufentscheidung spürbar. Hinterlege Werte, die deinen tatsächlichen Bedingungen entsprechen.