Grumeria für JTL-Shop einrichten

Voraussetzungen

1. Ein Grumeria-Konto mit einer Such-Engine. Die ersten 14 Tage sind kostenlos.
2. JTL-Shop 5.7.2 bis 5.8.0 mit PHP 8.3 und den PHP-Erweiterungen XMLReader und XMLWriter.
3. Ein laufender JTL-Aufgabenplaner (Shop-Cron) für regelmäßige Exporte.
4. Die Adresse deines Shops, um sie in Grumeria freizugeben.

Installation

1. Das Plugin im JTL-Extension-Store beziehen und installieren – oder das Direkt-ZIP im Plugin-Manager hochladen.
2. Ein vorhandenes Plugin regulär aktualisieren, nicht deinstallieren. Einstellungen, Engine-ID und Feed-Link bleiben erhalten.
3. Das Plugin öffnen. Unter „Einrichtung → Produktfeed“ steht der geschützte Feed-Link. Für den Feed ist noch keine Engine-ID nötig.

Produktfeed erstellen

1. „JTL-Exportformate öffnen“ und das Format „Grumeria Produktsuche“ wählen. Sprache, Währung, Kundengruppe und ein festes Lieferland prüfen – je Such-Engine eine feste Kombination.
2. Den Export vollständig erstellen. Enthalten sind Produkte und kaufbare Varianten, Merkmale, Artikelattribute und Funktionsattribute mit mehreren Werten, Kategorien, Bilder, Beschreibungen, Hersteller, GTIN, Preise, Angebote, Grundpreise und Lieferstatus.
3. Im JTL-Aufgabenplaner einen wiederkehrenden Export einrichten, zum Beispiel täglich. Bei häufigen Preis- oder Bestandsänderungen ein kürzeres Intervall wählen.
4. Optional unter „Funktionsattribute im Feed“ einzelne Felder abwählen, die den Shop nicht verlassen sollen. Geschützte Felder wie Zugangsdaten, Einkaufspreise, Lieferanten, Margen oder interne Notizen werden nie exportiert.

JTLs tabellarische Exportvorschau ist für CSV gedacht und zeigt bei XML-Feeds fehlende Spaltenüberschriften an. Das ist kein Fehler: Zur Kontrolle im Plugin „XML-Feed öffnen“ oder die Vorschau in Grumeria nutzen.

Felder und Filter in Grumeria wählen

1. In Grumeria unter „Produktdaten“ eine XML-Datenquelle anlegen, den Feed-Link eintragen und die Vorlage „Grumeria JTL-Plugin“ wählen.
2. „Felder laden & Vorschau“: Merkmale, Artikelattribute, Funktionsattribute und Variantenwerte erscheinen getrennt, jeweils mit Beispielwerten.
3. Für jedes Feld festlegen, ob es durchsuchbar, filterbar oder sortierbar ist. Nichts wird ungefragt aktiv. Beschreibungen einem durchsuchbaren Feld zuordnen.
4. Speichern und vollständig importieren. Danach unter „Filter“ die gewünschten Filter anlegen und benennen.
5. Drei Artikel mit dem Shop vergleichen: einen regulären Artikel, eine Variante und ein Angebot – dazu einen Artikel „auf Bestellung“.

Suche im Shop aktivieren

1. In Grumeria unter „Darstellung“ die Adresse deines Shops freigeben. https://shop.example und https://www.shop.example sind unterschiedliche Adressen.
2. In den Plugin-Einstellungen die 26-stellige Engine-ID eintragen. Den Standard-Selektor beibehalten oder an dein Template anpassen und den Shop-Cache leeren.
3. Kein weiteres Grumeria-Snippet parallel einbauen.
4. Die Suche testen. Sie funktioniert ohne Tracking-Cookies und ohne Einwilligung. Fällt Grumeria einmal aus, bleibt die normale JTL-Suche aktiv.

Optionale Suchstatistik

Bei Installation oder Update legt JTL den Eintrag „Grumeria Suchstatistik“ im Consent Manager an. Erst nach ausdrücklicher Zustimmung werden Suchbegriffe, Ergebnisansichten und Klicks für die Statistik erfasst. Widerruf, Do-Not-Track und Global Privacy Control schalten die Statistik ab; die Suche bleibt nutzbar.

Optional meldet das Plugin auf der Bestellabschluss-Seite bis zu 50 Produkt-IDs als Kaufsignal – ohne Namen, Adressen, Bestellnummern oder Bestellwerte. Diese Funktion ist standardmäßig ausgeschaltet und braucht zusätzlich die Statistik-Einwilligung.

Updates

1. Updates regulär installieren, nicht deinstallieren. Feed-Link, Engine-ID und alle Einstellungen bleiben erhalten.
2. Ab Version 1.3.0 sind Funktionsattribute standardmäßig im Feed. Eine Auswahl aus Version 1.2.0 bleibt beim Update exakt erhalten.
3. Nach einer Änderung der Feldauswahl den Export neu erstellen und in Grumeria neu importieren.

Fehlersuche

HTTP 403 beim Abruf des Feeds

Häufig sperrt das Hosting PHP-Dateien in Plugin-Ordnern. Nur den Endpunkt frontend/feed.php freigeben, niemals das ganze Plugin-Verzeichnis.

„Keine Spaltenüberschrift gefunden“ in JTL

Die Tabellenvorschau ist für CSV gedacht. Der XML-Feed ist trotzdem gültig – im Plugin „XML-Feed öffnen“ oder in Grumeria die Vorschau nutzen.

Hinweis zum Lieferland

Im Exportformat ein festes Lieferland wählen, damit Preise bei jedem Export gleich berechnet werden.

Die Suche zeigt alte Preise

Aufgabenplaner und Shop-Cron prüfen. Schlägt ein Abruf fehl, bleibt in Grumeria der letzte vollständige Stand aktiv.

Die Suche erscheint nicht im Shop

Engine-ID, freigegebene Shop-Adresse und Selektor prüfen und den Shop-Cache leeren.

Noch kein Grumeria-Konto?

14 Tage kostenlos testen – ohne Kreditkarte. Der Feed-Assistent führt dich durch die Einrichtung.

Fragen zur Einrichtung? Schreib uns an hello@grumeria.com.