Im PrestaShop-Shop installieren

Das Modul, der Handshake, die erste Indexierung und die Aktivierung des Suchpanels, in der richtigen Reihenfolge.

Das Buskara-Modul für PrestaShop macht drei Dinge: es verbindet den Shop mit Ihrem Konto, hält den Katalog indexiert und fügt das Skript des Suchpanels in die Seiten ein. Das Modul zu installieren ändert nichts am Shop: das Suchpanel erscheint den Besuchern erst am Ende dieses Leitfadens, wenn der Katalog indexiert ist.

1. Der API-Schlüssel

Das Konto entsteht ohne jeden Schlüssel, und der erste kommt von allein: gleich nach der Registrierung führt Buskara Sie durch drei Schritte (Modul herunterladen, Schlüssel kopieren, auf den Shop warten), und im zweiten wird er ausgestellt und angezeigt. Wenn Sie den Bildschirm geschlossen haben, bevor Sie ihn kopiert hatten, gehen Sie zurück auf /ativar und fordern Sie einen neuen an.

Der vollständige Schlüssel (bk_live_…) erscheint ein einziges Mal: kopieren Sie ihn in diesem Moment. Die Liste zeigt danach nur noch das Präfix und wann er zuletzt benutzt wurde. Für weitere Schlüssel (einen pro Shop zum Beispiel) öffnen Sie im Panel das Kontoprofil, Reiter Integrationen.

Jeder Schlüssel in der Liste hat drei mögliche Wege. Widerrufen kappt sofort alles, was ihn gerade benutzt, und ist umkehrbar: ein widerrufener Schlüssel wird über den Button daneben reaktiviert, mit demselben Wert wie vorher. Löschen dagegen ist endgültig, weil der Wert nirgends gespeichert ist; wenn Sie den Schlüssel löschen, den der Shop benutzt, stellen Sie einen neuen aus und fügen ihn wieder ins Modul ein.

2. Installieren und verbinden

1. Installieren Sie das Modul Buskara im Back-Office von PrestaShop und öffnen Sie die Konfiguration.
2. Solange der Shop nicht verbunden ist, zeigt das Modul einen Willkommensbildschirm mit zwei Feldern: fügen Sie dort den API-Schlüssel ein und prüfen Sie die Buskara-Adresse (https://buskara.com).
3. Klicken Sie auf Shop verbinden.

Das Modul erstellt keine Schlüssel und denkt sich auch keine aus: es bekommt den, den Ihr Konto ausgestellt hat. Wer das Modul installiert, bevor er ein Konto hat, findet auf demselben Bildschirm den Button, um eines anzulegen.

Dieser letzte Klick ist der Handshake: der Shop stellt sich vor (URL, Versionen, Shops, Sprachen und Währungen) und bekommt seine Kennung zurück, den öffentlichen Suchschlüssel und eine Suchmaschine pro Shop × Sprache × Währung. In diesem Moment erscheint der Shop im Panel, unter Suche → Shops; es gibt nichts von Hand anzulegen. Und ab hier zeigt die Konfiguration des Moduls alles Weitere: Status, Indexierung, Aussehen und geteilte Daten.

Die Zahl der verbundenen Shops ist ein Limit des Plans. Wird der Handshake deswegen abgelehnt, nennt die Meldung den Plan und das Limit; einen Shop erneut zu verbinden, den es schon gibt, wird nie blockiert.

3. Die erste Indexierung

Klick im Modul auf Alles neu indexieren. Der Katalog geht in Stapeln raus, und im Panel (Suche → Shops) sehen Sie den Fortschritt: In der Warteschlange, Wird indexiert… (gesendet / gesamt) und schließlich Aktuell, mit der Gesamtzahl der Dokumente.

Bei einem großen Katalog kann der Button an die maximale Ausführungszeit von PHP stoßen. Für diese Fälle bringt das Modul eine Alternative über die Kommandozeile mit, die dieses Limit nicht hat:

php modules/buskara/cli/reindex.php

Nach der ersten vollständigen Indexierung erledigt sich der Alltag auf drei Wegen von selbst:

• In Echtzeit: ein Produkt speichern, löschen oder seinen Bestand ändern schiebt die Änderung sofort raus.
• Periodische Synchronisierung: die Plattform fordert die Neuindexierung in regelmäßigen Zyklen beim Shop an. Dafür muss die Adresse https://ihr-shop/module/buskara/sync von außen erreichbar sein; achten Sie auf Firewalls und Basic-Auth in Vorproduktionsshops.
• Manuell: der Button oder das CLI, wenn Sie es erzwingen wollen.

4. Testen, ohne es jemandem zu zeigen

Bevor Sie das Suchpanel für alle einschaltest, nutz das Feld Debug-IPs im Modul: steht Ihre IP darin, bekommen nur Sie das Suchpanel, und Sie können im Produktivshop nach Herzenslust ausprobieren.

Die Kehrseite ist wichtig: solange in diesem Feld IPs stehen, bekommt sonst niemand das Suchpanel. Wenn eines Tages "die Suche aus dem Shop verschwunden ist", ist das die erste Stelle, an der Sie nachsiehst.

5. Das Suchpanel einschalten

Die erste vollständige Indexierung, die Produkte in den Index legt, schaltet das Suchpanel von selbst ein. Ab diesem Moment lädt jede Seite des Shops eine einzige Script-Tag, und die Suche ist die von Buskara: die Leiste des Themes bleibt an ihrem Platz, aber wer antwortet, sind wir.

Bis dahin ist der Schalter des Suchpanels mit Absicht aus. Ihn einzuschalten, solange der Index noch leer ist, gäbe Ihren Kunden eine Suche, die nichts findet, und das ist schlimmer als gar keine. Der Schalter bleibt in der Konfiguration des Moduls, und er gehört Ihnen: schalten Sie ihn aus, bleibt er aus, und keine spätere Indexierung schaltet ihn ohne Sie wieder ein.

Wenn der Standardselektor (input[name='s']) die Leiste Ihres Themes nicht erwischt, passen Sie den Selektor der Suchleiste an. Bei Themes mit eigener Suche auf dem Handy ist es normal, dass auch die Selektoren für Buttons, die die Suche öffnen und Während der Suche im Shop ausblenden gefüllt werden müssen; das wird im Datenblatt des Shops im Panel eingestellt und ist im Leitfaden zu Aussehen und Integration ins Theme erklärt.

Die übrigen Optionen des Moduls

• Preise mit MwSt. und Bildgröße: wie die Produkte im Index ankommen.
• Produkte ohne Bestand: trotzdem indexieren, in den Ergebnissen zurückstufen oder verstecken.
• Daten, die der Shop teilt: drei optionale Signale, die das Produkt besser machen. Das Verkaufsvolumen pro Produkt speist die Sortierung "meistverkauft" und das Aufspüren unsichtbarer Bestseller; der Einkaufspreis liefert Margen in Analytics; die Bestellungen verbinden die Suche mit dem Umsatz (siehe den Leitfaden zu Analytics). Die Freigabe von Verkäufen oder Kosten zu ändern verlangt eine vollständige Neuindexierung, damit der Index es abbildet; das Modul weist darauf hin.
• Artikel und Inhalte: auch den Blog bzw. das CMS in einer eigenen Suchmaschine indexieren, die in den Ergebnissen auftaucht, ohne den Produkten den Platz wegzunehmen.
• Sterne: woher die auf den Karten gezeigten Bewertungen kommen (automatische Erkennung der üblichen Module).

Wenn etwas schiefgeht

• Der Shop erscheint nicht im Panel: der Handshake ist fehlgeschlagen. Prüfen Sie den Endpunkt und den Schlüssel (ohne überzählige Leerzeichen) und klicken Sie erneut auf Mit Buskara verbinden.
• "Wird indexiert" kommt nie ans Ende: nehmen Sie das CLI; der Button stößt bei großen Katalogen an die Ausführungszeit von PHP.
• Das Suchpanel erscheint nicht: in dieser Reihenfolge, ist der Schalter des Suchpanels an? Ist das Feld mit den Debug-IPs leer? Ist der Shop im Buskara-Panel Aktiv (und nicht Pausiert)?
• Das Suchpanel erscheint, aber die Leiste des Themes antwortet weiter: der Selektor der Leiste erwischt nicht das richtige Input; sehen Sie sich das Theme an und passen Sie ihn an.

Das Modul zu deinstallieren löscht die gesamte lokale Konfiguration. Der Index auf der Seite von Buskara bleibt; nur der Shop hört auf, ihn zu füttern.