1. WAS DIESES MODUL LEISTET - UND WARUM

Die Suche ist im Onlineshop der schnellste Weg zum Kauf - Besucher, die suchen, wissen meist schon, was sie wollen, und kaufen deutlich häufiger. Doofinder liefert genau dafür eine schnelle, fehlertolerante Suche mit Vorschlägen schon beim Tippen. Damit diese Suche verkauft, braucht sie aber eines: aktuelle, vollständige Produktdaten.

Genau das ist die Aufgabe unseres Moduls. Es übergibt Ihren kompletten Gambio-Katalog an Doofinder - mit Titeln, Beschreibungen, Bildern, Preisen, Marken, Kategoriepfaden, Varianten und Beständen - und hält den Suchindex automatisch aktuell. Sie müssen nichts von Hand exportieren und keine Daten doppelt pflegen.

Dieses Handbuch erklärt nicht nur, welchen Knopf Sie drücken, sondern auch, WARUM ein Schritt nötig ist und was er bewirkt. So verstehen Sie das Zusammenspiel von Shop und Suche und können es gezielt auf Ihren Shop einstellen.

2. FEED ODER API: DIE ZWEI WEGE ZUR SUCHE

Unser Modul kann Doofinder auf zwei Wegen mit Daten versorgen. Beide lassen sich einzeln oder gemeinsam nutzen.

Der Produkt-Feed ist der klassische, robuste Grundweg: Das Modul stellt eine Adresse bereit, die Ihren Katalog als Google-Shopping-XML ausgibt. Doofinder liest diese Adresse in einem selbst gewählten Rhythmus ein. Einmal eingerichtet, läuft das ohne weiteres Zutun - und reicht für viele Shops bereits vollständig aus.

Die Echtzeit-API ist der Weg für maximale Aktualität: Das Modul spricht die Doofinder-Management-API direkt an und aktualisiert einzelne Produkte oder den ganzen Index gezielt - beim Speichern eines Artikels in Sekunden, per Cronjob im festen Takt oder manuell auf Knopfdruck.

Als Faustregel gilt: Der Feed ist die Basis, die API die Kür. Wer selten Änderungen hat, kommt mit dem Feed aus; wer Preise und Bestände häufig ändert und möchte, dass die Suche das sofort widerspiegelt, aktiviert zusätzlich die API.

3. WO SIE DAS MODUL IM BACKEND FINDEN

Das Modul hat im Gambio-Admin zwei Anlaufstellen, beide im Menü "Xycons-Module" (nicht im Gambio-Modul-Center - dort erscheinen die Xycons-Module bewusst nicht):

• Die Einstellungen (Setup): Menü "Xycons-Module" ► "Kundenkonto / Setups". Dort öffnet sich eine Seite mit horizontalen Reitern (TABs) - ein TAB je installiertem Xycons-Modul. Der Reiter trägt jeweils den Namen des Moduls; für dieses Modul ist es der TAB "Doofinder". Hier stehen alle Konfigurationswerte (siehe Kapitel 9).
• Die Arbeitsseite "Doofinder Synchronisation": Menü "Xycons-Module" ► "Doofinder". Das ist die Bedienoberfläche für die Sprach-Zuordnung und den Sync (siehe Kapitel 5).

Kurz gemerkt: Im TAB "Doofinder" unter "Kundenkonto / Setups" stellen Sie das Modul ein; auf der Seite "Doofinder Synchronisation" bedienen Sie es.

4. SCHNELLSTART: IN WENIGEN SCHRITTEN VERBUNDEN

• Modul einschalten. Im Setup-TAB "Doofinder" den Modulstatus auf "Eingeschaltet" stellen. Solange das Modul aus ist, laufen bewusst KEINE Prozesse - weder Feed noch API noch Cronjob (siehe Kapitel 10).
• Feed aktivieren und Token setzen. "Doofinder-Feed aktiv" einschalten und beim "Doofinder Feed Token" einen langen, geheimen Token hinterlegen. Damit ist Ihr Feed unter /doofinder_feed.php?token=IHR_TOKEN&lang=de erreichbar.
• Feed in Doofinder eintragen. In Doofinder eine Datenquelle vom Typ Google-Shopping/XML anlegen und die Feed-Adresse hinterlegen (siehe Kapitel 6).
• Optional: Echtzeit-API aktivieren. API-Trigger einschalten, API-Key, Zone und Indexnamen eintragen und auf der Arbeitsseite je Shopsprache die Doofinder-HashID zuordnen (siehe Kapitel 5 und 7).

Mehr ist für den Start nicht nötig. Die ausgelieferten Standardwerte sind für die meisten Shops direkt sinnvoll.

5. DIE ARBEITSSEITE „DOOFINDER SYNCHRONISATION"

Diese Seite ist die tägliche Schaltzentrale des Moduls. Sie öffnen sie über das Menü "Xycons-Module" ► "Doofinder". Von hier aus ordnen Sie die Shopsprachen ihren Doofinder-Suchen zu und starten die Synchronisation. Die Seite gliedert sich in drei Bereiche.

5.1 STATUSANZEIGE UND ABSCHALT-HINWEIS

Ganz oben sehen Sie auf einen Blick, ob das Modul ("Modulstatus") und die API-Synchronisation eingeschaltet sind. Ist das Modul ausgeschaltet, erscheint an dieser Stelle ein deutlich rot hinterlegter Hinweis - dann ist sofort klar, warum nichts synchronisiert wird und dass die Bedienelemente ohne Wirkung bleiben. Umgestellt wird der Status nicht hier, sondern im Setup-TAB (Kapitel 9).

5.2 SPRACH-HASH-VERWALTUNG

Darunter liegt die Tabelle "Sprach-Hash-Verwaltung". Sie listet jede Shopsprache mit drei Angaben: der Sprache selbst, einem Häkchen "Aktiv" und einem Feld für die "HashID". Jede Sprache hat in Doofinder ihre eigene Such-Engine mit einer eigenen HashID; hier verbinden Sie beide Welten. Setzen Sie das Häkchen bei den Sprachen, die synchronisiert werden sollen, tragen Sie die jeweilige HashID ein und klicken Sie auf "Sprach-Zuordnungen speichern". Nur aktive Sprachen mit hinterlegter HashID werden später abgeglichen (mehr dazu in Kapitel 7).

Woher bekomme ich die HashID? Die HashID vergibt Doofinder für jede Such-Engine (Search Engine) automatisch. Sie finden sie in Ihrem Doofinder-Konto: Legen Sie pro Shopsprache eine eigene Search Engine an (bzw. öffnen Sie eine bestehende) - in deren Übersicht bzw. Einstellungen wird die HashID als kurze Zeichenfolge angezeigt und lässt sich kopieren. Achten Sie darauf, die HashID der Search Engine zur passenden Sprache zu übernehmen (z. B. die HashID der deutschen Suche in die Zeile "Deutsch"). Aus derselben Doofinder-Oberfläche stammen auch die übrigen Verbindungsdaten für das Setup - der API-Key und die Zone (siehe Kapitel 9.3).

5.3 MANUELLER SOFORTSTART MIT FORTSCHRITT UND PROTOKOLL

Der dritte Bereich ist der "Manuelle Doofinder-Sofortstart". Ein Klick auf "Jetzt synchronisieren" startet einen vollständigen Abgleich - genau denselben Vorgang, den auch der Cronjob nutzt. Während des Laufs zeigt ein Fortschrittsbalken live, wie viele Produkte bereits verarbeitet und an Doofinder übertragen wurden; danach erscheint ein Ausführungsprotokoll mit dem Ergebnis oder - im Fehlerfall - der genauen Meldung von Doofinder.

Fehlen der API-Key oder eine aktive Sprach-Zuordnung, ist der Knopf gesperrt und ein Hinweis erklärt, was noch fehlt. So können Sie keinen Lauf starten, der ohnehin nicht funktionieren würde. Der Vollsync baut den neuen Suchindex im Hintergrund auf und schaltet ihn erst um, wenn er vollständig ist - dadurch ist die Suche während des Abgleichs nie unvollständig.

6. DER PRODUKT-FEED IM DETAIL

Der Feed gibt Ihren Katalog im Google-Shopping-XML-Format aus - einem bewährten Standard, den Doofinder direkt einlesen kann. Die Adresse lautet:

/doofinder_feed.php?token=<IHR_FEED_TOKEN>&lang=de

Der Parameter lang wählt die Sprache, in der Titel, Beschreibungen, Preise und Links ausgegeben werden. Zum Testen helfen zwei weitere Parameter: limit (nur die ersten N Einträge) und offset (ab dem N-ten Eintrag). Rufen Sie die Adresse einmal im Browser auf - Sie sollten sauberes XML sehen.

Warum der Token wichtig ist: Der Feed enthält Ihren kompletten Katalog inklusive Preise und Bestände. Der Token ist der Schlüssel, der diesen Export schützt. Verwenden Sie deshalb einen langen, zufälligen Wert (mindestens 32 Zeichen) und geben Sie die Adresse nur an Doofinder weiter. Wird der Token falsch oder gar nicht übergeben, antwortet der Endpunkt mit "Unauthorized".

In Doofinder richten Sie für die jeweilige Sprache eine Google-Shopping-/XML-Datenquelle ein und aktivieren die Variantengruppierung (die Felder für die Gruppierung liefert der Feed bereits mit - siehe Kapitel 8). Danach steuert Doofinder den Einlese-Rhythmus.

7. DIE ECHTZEIT-SYNCHRONISATION ÜBER DIE API

Die API-Synchronisation aktualisiert die Doofinder-Suche direkt - ohne auf den nächsten Feed-Einlesezeitpunkt zu warten. Voraussetzung: Modulstatus und API-Trigger sind eingeschaltet, und es sind API-Key, Zone, Indexname sowie mindestens eine aktive Sprach-Hash-Zuordnung hinterlegt (die Zuordnung pflegen Sie auf der Arbeitsseite, siehe Kapitel 5.2). Den vollständigen Abgleich können Sie auf drei Arten auslösen: manuell auf der Arbeitsseite (Kapitel 5.3), zeitgesteuert per Cronjob und automatisch beim Bearbeiten einzelner Produkte.

7.1 CRONJOB-VOLLSYNC

Für den regelmäßigen, unbeaufsichtigten Komplettabgleich aktivieren Sie in der Gambio-Cronjob-Verwaltung den Doofinder-Cronjob und wählen ein Intervall (stündlich, alle 3/6/12 Stunden oder täglich; Standard ist täglich um 02:15 Uhr). Der Cronjob nutzt exakt denselben Vollsync wie der manuelle Knopf. Ist das Modul oder der API-Trigger ausgeschaltet oder fehlt eine aktive Sprach-Zuordnung, beendet sich der Lauf folgenlos und protokolliert den Grund.

7.2 AUTOMATISCHER SYNC BEIM SPEICHERN UND LÖSCHEN

Das ist der Weg zur echten Sekundenaktualität: Bei aktiven Optionen "Produktsync bei Speicherung" und "Produktsync bei Löschung" aktualisiert das Modul genau den betroffenen Artikel in Doofinder, sobald Sie ihn im Backend speichern oder löschen - ohne den ganzen Index neu aufzubauen. So spiegelt die Suche Preis-, Text- und Bestandsänderungen praktisch sofort wider.

Schlägt ein solcher automatischer Abgleich einmal fehl (etwa weil Doofinder gerade nicht erreichbar ist), wird das Speichern oder Löschen des Produkts dadurch NICHT behindert. Der nächste Vollsync bringt die Suche anschließend wieder auf Stand.

8. WAS IN DER SUCHE LANDET (INHALTE UND VARIANTEN)

Unser Modul überträgt alle verkaufsrelevanten Produktdaten: Produkttitel, Beschreibung, Link zur Produktseite, Bild, Preis (in der Währung Ihres Shops), Verfügbarkeit, Marke, EAN/GTIN, Artikelnummer, die vollständigen Kategoriepfade, Suchbegriffe (Keywords), Lagerbestand und das Datum der letzten Änderung.

Die Verfügbarkeit ergibt sich automatisch aus dem Bestand ("auf Lager" / "nicht auf Lager"). Über die Option "Nicht lieferbare Artikel exportieren" entscheiden Sie, ob Artikel und Varianten mit Bestand null überhaupt in Feed und Sync auftauchen.

Varianten werden korrekt abgebildet: Sowohl Eigenschafts-Kombinationen als auch klassische Artikelattribute erscheinen als jeweils eigener Eintrag und werden über eine gemeinsame Gruppen-ID zusammengefasst (ein Eintrag je Gruppe ist der "Gruppenführer"). So erkennt Doofinder zusammengehörige Varianten als ein Produkt mit Auswahl - statt als lauter Dubletten. Jede Variante trägt ihre eigene Artikelnummer, ihren eigenen Preis und ihre Merkmale (z. B. Farbe, Größe).

9. DAS MODUL-SETUP: ALLE EINSTELLUNGEN IM DETAIL

Das Setup erreichen Sie im Gambio-Admin über das Menü "Xycons-Module" ► "Kundenkonto / Setups" und dort über den TAB "Doofinder". Jeder Wert trägt einen kurzen Infotext; dieses Kapitel ordnet die Werte ein und nennt jeweils den Auslieferungsstandard in (Klammern). 

9.1 GRUNDSCHALTER

Modulstatus (Auslieferungszustand: AUS) Der Hauptschalter. Steht er auf AUS, sind alle Prozesse stillgelegt - Feed, API-Synchronisation, Cronjob und der automatische Produkt-Sync. Die Arbeitsseite zeigt in diesem Fall einen deutlichen roten Hinweis, dass das Modul ausgeschaltet ist.

Lizenzschlüssel Wird beim Kauf hinterlegt und schaltet das Modul vom Testbetrieb auf den uneingeschränkten Betrieb frei.

9.2 PRODUKT-FEED

Doofinder-Feed aktiv (Standard: Ja) Stellt den Feed-Endpunkt bereit. Steht er auf Nein, antwortet die Feed-Adresse mit einer Deaktiviert-Meldung - nützlich, wenn Sie ausschließlich über die API arbeiten.

Doofinder Feed Token (Standard: leer) Der geheime Pflicht-Token für den Feed-Aufruf. Ohne Token ist der Feed gesperrt. Wählen Sie einen langen, zufälligen Wert (siehe Kapitel 6).

Nicht lieferbare Artikel exportieren (Standard: Nein) Legt fest, ob Artikel und Varianten mit Bestand null in Feed und Sync aufgenommen werden. Standardmäßig bleiben ausverkaufte Artikel außen vor.

9.3 API-SYNCHRONISATION

Doofinder API-Trigger aktiv (Standard: Nein) Der Hauptschalter für die direkte API-Synchronisation. Erst wenn er auf Ja steht, arbeiten manueller Sync, Cronjob und automatischer Produkt-Sync.

Doofinder API Key (Standard: leer) Der Management-API-Key aus Ihrem Doofinder-Konto. Er wird für alle schreibenden API-Zugriffe benötigt.

Doofinder Zone (Standard: eu1) Die Region Ihres Doofinder-Kontos, z. B. eu1, us1 oder eu2. Sie ergibt sich aus Ihrer Doofinder-Umgebung.

Doofinder API Indexname (Standard: products) Der Name des Zielindex in Doofinder, in den synchronisiert wird.

Doofinder Sprach-Zuordnung Die Zuordnung von Shopsprache zu Doofinder-HashID. Sie wird nicht hier, sondern komfortabel über die Tabelle auf der Arbeitsseite gepflegt (siehe Kapitel 5.2).

9.4 PRODUKT-SYNC UND TRIGGER

Produktsync bei Speicherung (Standard: Ja) Synchronisiert den betroffenen Artikel direkt über die API, sobald er im Backend gespeichert wird.

Produktsync bei Löschung (Standard: Ja) Entfernt den betroffenen Artikel direkt aus Doofinder, sobald er im Backend gelöscht wird.

Reprocess Endpoint Token (Standard: leer) Der geheime Pflicht-Token für die optionalen Endpunkte zum Anstoßen von Synchronisation und Neuverarbeitung. Ohne Token sind beide gesperrt.

Reprocess Cooldown (Sekunden) (Standard: 300) Die Mindestzeit zwischen zwei Auslösungen der Neuverarbeitung. Sie verhindert, dass ein zu häufig aufgerufener Trigger Doofinder unnötig belastet.

10. HÄUFIGE STOLPERSTEINE

• Modul aus = alles aus. Bei ausgeschaltetem Modulstatus passiert bewusst nichts - kein Feed, keine API, kein Cronjob. Die Arbeitsseite weist mit einem roten Hinweis darauf hin. Wer sich wundert, dass nichts synchronisiert, prüft zuerst diesen Schalter.

• Modul nicht im Modul-Center gefunden. Die Xycons-Module erscheinen nicht im Gambio-Modul-Center, sondern im Menü "Xycons-Module" - die Einstellungen unter "Kundenkonto / Setups" im TAB "Doofinder", die Bedienung unter dem Menüpunkt "Doofinder".

• Feed liefert "Unauthorized". Der Token in der Adresse stimmt nicht mit dem im Setup hinterlegten Feed-Token überein - Werte ohne Leerzeichen vergleichen.

• "Jetzt synchronisieren" ist gesperrt. Es fehlen der API-Key und/oder eine aktive Sprach-Zuordnung mit HashID. Beides hinterlegen, dann ist der Knopf verfügbar.

• Falsche Sprache im Index. Jede Sprache braucht ihre eigene HashID. Prüfen Sie, ob die richtige HashID der richtigen Sprache zugeordnet ist.

• Sync bricht mit Doofinder-Meldung ab. Zone, API-Key, HashID und Indexname prüfen. Das Protokoll auf der Arbeitsseite zeigt die genaue Meldung von Doofinder.

• Feed enthält Preise. Der Feed gibt den kompletten Katalog inklusive Preise aus. Nur mit starkem Token betreiben und die Adresse ausschließlich an Doofinder weitergeben.