Doofinder-Reindex per Cronjob anstoßen

Einrichtung

Schritt für Schritt

1. Die Reindex-Adresse heraussuchen

   Beim Doofinder-Plugin für JTL-Shop 5 steht die Adresse im Plugin-Backend im Tab „Reindex“. Bei anderen Plugins finden Sie sie in deren Einstellungen. In den Shops, die wir aufrufen, begegnen uns vor allem diese Formen:

   JTL-Shop 5:  https://ihr-shop.de/plugins/ws5_doofinder/sync.php?action=reindex
   JTL-Shop 4:  https://ihr-shop.de/includes/plugins/jst_doofinder/sync.php?action=reindex
   Shopware:    https://ihr-shop.de/doofinder/sync/reindex

2. Adresse einmal im Browser aufrufen

   Rufen Sie die Adresse selbst auf, bevor Sie einen Cronjob daraus machen. Richtig ist eine kurze Bestätigung oder eine leere Seite. Fragt der Browser nach Benutzername und Passwort, ist der Reindex mit einem Passwort geschützt. Das kommt bei Shopware-Plugins häufig vor und ist kein Fehler. Die Zugangsdaten kommen im übernächsten Schritt ins Formular.

3. Konto bei Cronjob.de anlegen

   Die Registrierung dauert eine Minute und kostet nichts, Zahlungsdaten sind nicht nötig. Fünf Cronjobs bleiben dauerhaft kostenlos. Die ersten 14 Tage haben Sie alle Funktionen, inklusive Aufrufprotokoll mit der Antwort Ihres Shops.

   Kostenlos starten 14 Tage Unlimited inklusive, keine Zahlungsdaten

4. Cronjob anlegen und Takt wählen

   Tragen Sie die Adresse ein und wählen Sie den Takt. Stündlich deckt den Normalfall ab. Wer Preise und Bestände mehrmals täglich pflegt, nimmt alle 15 Minuten. Den Zeitplan klicken Sie zusammen, tippen ihn als Crontab-Ausdruck ein oder beschreiben ihn in einem Satz.

   0 * * * *

   Diesen Ausdruck können Sie bei Cronjob.de direkt so eintragen – das Zeitplanfeld versteht die Crontab-Schreibweise. Sie müssen sie aber nicht kennen: klicken Sie den Takt stattdessen einfach an.

5. Zugangsdaten hinterlegen, falls verlangt

   Ist der Reindex mit einem Passwort geschützt, tragen Sie Benutzername und Passwort in die beiden Felder Zugangsdaten im Cronjob-Formular ein, nicht in die Adresse. Sonderzeichen sind dort kein Problem. Tragen Sie die Daten doch in der Form benutzer:passwort@ihr-shop.de ein, übernehmen wir sie beim Speichern automatisch in die Felder.

6. Ohne Plugin-Adresse: die Doofinder-API aufrufen

   Laut Doofinder-Doku startet ein POST auf den Endpunkt _process die Verarbeitung aller Datenquellen einer Suchmaschine. Den API-Schlüssel erzeugen Sie im Admin Panel unter Account → API Keys. Die Hashid steht unter Configuration → Search Engines. Die Zone (eu1, us1 oder ap1) ist der Anfang Ihres API-Schlüssels. Im Cronjob-Formular stellen Sie die Methode auf POST und tragen die Kopfzeile ein. Erfolg meldet Doofinder mit Status 201.

   Adresse:          https://eu1-api.doofinder.com/api/v2/search_engines/IHRE-HASHID/_process
   Anfrage-Methode:  POST
   Kopfzeilen:       Authorization: Token IHR-API-SCHLUESSEL

7. Benachrichtigung einschalten

   Hinterlegen Sie unter Benachrichtigungen eine E-Mail-Adresse. Läuft der Reindex nicht mehr durch, weil sich nach einem Shop-Update der Plugin-Pfad geändert hat oder der Server nicht antwortet, erfahren Sie es sofort. Die Fehlerbenachrichtigung per E-Mail gibt es ab dem Tarif Plus, in den ersten 14 Tagen ist sie kostenlos dabei.

Was die fünf Felder eines Ausdrucks wie */5 * * * * bedeuten, steht in der Crontab-Referenz – mit Beispielen und den häufigsten Stolpersteinen. Bauen können Sie den Ausdruck im Crontab-Generator. Ob Sie dafür überhaupt einen Dienst von außen brauchen, zeigt der Vergleich der drei Wege.

Kontrolle

Läuft es wirklich?

Starten Sie den Cronjob einmal von Hand. Im Aufrufprotokoll von Cronjob.de steht jeder Aufruf mit Status und Laufzeit, ab Plus auch mit der Antwort. Beim API-Weg ist Status 201 richtig. Ein guter Gegentest: Ändern Sie im Shop einen Preis und suchen Sie den Artikel nach dem nächsten Reindex. Steht dort der neue Preis, stimmt die Kette.

FAQ

Häufige Fragen zu Doofinder

Wie oft sollte der Doofinder-Reindex laufen?

Stündlich ist für die meisten Shops ein guter Ausgangspunkt, alle 15 Minuten, wenn Preise und Bestände laufend gepflegt werden. Enger bringt selten etwas, weil der Aufbau des Index selbst Zeit braucht. Prüfen Sie in Ihrem Doofinder-Konto, ob Ihr Tarif dafür Grenzen setzt.

Brauche ich überhaupt einen Cronjob, wenn Doofinder selbst indexiert?

Nicht unbedingt. Liest Doofinder Ihren Daten-Feed ein, können Sie im Admin Panel unter „Automatic Indexing“ täglich, alle X Stunden oder zu festen Zeiten wählen. Einen Cronjob brauchen Sie, wenn Ihr Shop-Plugin eine Reindex-Adresse mitbringt, die aufgerufen werden muss, etwa beim JTL-Plugin, oder wenn Sie per API auslösen.

Muss der Reindex nachts laufen?

Nicht zwingend. Sinnvoll ist er nach nächtlichen Importen aus der Warenwirtschaft, sonst indexiert er den alten Stand. Doofinder rät bei Shopware 6 selbst, den vollständigen Reindex kurz nach solchen Importen einzuplanen.

Der Aufruf endet mit Fehler 401 „Not authorized“.

Der Reindex ist dann mit einem Passwort geschützt. Bei Shopware-Shops antwortet der Server oft mit 401 und WWW-Authenticate: Basic, häufig mit dem Bereichsnamen IntediaDoofinder. Das ältere Shopware-Plugin stammt laut Doofinder von Intedia. Tragen Sie Benutzername und Passwort in die Felder Zugangsdaten ein. Die Daten stehen in der Konfiguration des Doofinder-Plugins im Shop-Backend.

Der Aufruf endet mit Fehler 403.

Das ist etwas anderes als 401: Hier hilft kein Passwort, sondern etwas blockiert den Zugriff, etwa ein Verzeichnisschutz, eine Regel in der .htaccess oder eine Firewall. Nehmen Sie genau diese eine Adresse von der Sperre aus. Beim API-Weg heißt 401 oder 403: API-Schlüssel falsch oder ohne Recht für diese Suchmaschine.

Der Aufruf läuft in eine Zeitüberschreitung.

Ein vollständiger Reindex großer Sortimente kann länger dauern, als wir warten: 45 Sekunden im kostenlosen Tarif, 60 Sekunden in den bezahlten. Ob der Shop danach weiterarbeitet, hängt vom Plugin und von der PHP-Einstellung ab. Prüfen Sie im Doofinder-Konto, ob der Index trotzdem fertig wurde. Der API-Weg antwortet sofort, weil Doofinder die Arbeit nur einplant.

Nach einem Shop-Update läuft nichts mehr.

Häufigste Ursache ist ein geänderter Plugin-Pfad, etwa beim Wechsel von JTL-Shop 4 auf 5: Aus /includes/plugins/jst_doofinder/ wird /plugins/ws5_doofinder/. Passen Sie die Adresse im Cronjob an. Mit eingeschalteter Benachrichtigung merken Sie so etwas am selben Tag.

Ich betreue mehrere Shops.

Legen Sie je Shop einen Cronjob an und sortieren Sie sie in Ordner. Die Benachrichtigung lässt sich je Ordner mit einer eigenen Adresse einstellen, praktisch, wenn hinter den Shops verschiedene Kunden stehen.