Plugin installieren, aktualisieren und migrieren
Zuletzt aktualisiert: 5. November 2026
Das V3-Plugin kann neu installiert oder über eine bestehende V1-/V2-Installation aktualisiert werden. Einstellungen und Suchdaten werden kontrolliert vorbereitet, bevor V3 aktiv wird.
Ziel
Sie führen Installation oder Update aus und erkennen, wann die V3-Suche vollständig bereit ist.
Voraussetzungen
- JTL-Shop ab der vom aktuellen Pluginpaket genannten Mindestversion
- PHP 8.1 oder neuer
- Eine vollständige Shop- und Datenbanksicherung
- Das aktuelle normale oder EXS-Paket aus dem vorgesehenen Bezugsweg
- Berechtigung: JTL-Shop-Administrator
Netzwerkfreigaben für Cloudflare, Imunify360 und Hosting-Firewalls
Wenn Cloudflare, Imunify360, ModSecurity, eine Hosting-Firewall oder ein anderer Bot-Schutz vorgeschaltet ist, müssen die folgenden Verbindungen erlaubt sein. Die Freigaben sollten immer so eng wie beschrieben erfolgen.
Aktuelle eazyFind-Server
| DNS-Name | IPv4 | IPv6 | Aufgabe |
|---|---|---|---|
de01.eazyfind.me |
49.12.152.199 |
2a01:4f8:fff0:15f::1021 |
Suche, API und synchrone Dienste |
de02.eazyfind.me |
49.12.152.205 |
2a01:4f8:fff0:15f::1027 |
Scheduler, Worker und Analysen |
Für noch nicht vollständig umgestellte V1-/V2-Installationen müssen zusätzlich die IPv4-Adressen 49.13.245.45 und 49.13.245.61 sowie der DNS-Name search01.eazyfind.me erlaubt bleiben. Verwenden Sie IPv4 und IPv6, sofern Ihr System beide Protokolle nutzt.
Eingehender Sync zum Shop
Der Serverabgleich erreicht den Shop ausschließlich über:
- Methode:
POST - Pfad:
/plugins/zhz_eazyfindme/webhook-sync.php - Cache: immer umgehen
- Schutzprüfung: keine Managed Challenge, Bot-Prüfung, Turnstile-Prüfung oder Ratenbegrenzung für diese genaue Kombination aus Methode, Pfad und eazyFind-IP-Adressen
Bei einer Shopinstallation in einem Unterverzeichnis muss dieses dem Webhook-Pfad vorangestellt werden. Die Signaturprüfung im Plugin bleibt trotz der Firewallfreigabe aktiv.
Cloudflare-Ausdruck für aktuelle und ältere Pluginstände:
(http.request.method eq "POST" and http.request.uri.path eq "/plugins/zhz_eazyfindme/webhook-sync.php" and ip.src in {49.12.152.199 2a01:4f8:fff0:15f::1021 49.12.152.205 2a01:4f8:fff0:15f::1027 49.13.245.45 49.13.245.61})
Ausgehende Verbindungen vom Shop
Die Hosting-Firewall und gegebenenfalls die Content-Security-Policy müssen Folgendes zulassen:
- HTTPS zu
de01.eazyfind.meundde02.eazyfind.meüber TCP-Port443 - WebSocket für die Live-Suche:
wss://de01.eazyfind.me/layer/1/websocket - während der V1-/V2-Übergangszeit zusätzlich HTTPS zu
search01.eazyfind.me
Browser-Dateien und lokale Endpunkte
Diese Dateien werden von der eigenen Shopdomain geladen. Cloudflare darf sie ausliefern, aber nicht durch Rocket Loader umsortieren oder durch eine Challenge ersetzen:
/plugins/zhz_eazyfindme/frontend/js/bundles/eazyfind-shared.bundle.js/plugins/zhz_eazyfindme/frontend/js/bundles/eazyfind-modal.bundle.js/plugins/zhz_eazyfindme/frontend/js/mobile/eazyfind-mobile.js/plugins/zhz_eazyfindme/frontend/js/legacy/zhz-search-override.js
Die Browser-POST-Endpunkte /plugins/zhz_eazyfindme/session-track.php und /plugins/zhz_eazyfindme/render-product-cards.php dürfen nicht gecacht und nicht durch Turnstile oder eine JavaScript-Challenge unterbrochen werden. Diese beiden Endpunkte werden nicht nach Server-IP freigegeben, weil echte Shopbesucher sie aufrufen; die Sicherheitsprüfung des Plugins bleibt aktiv.
Legen Sie keine pauschale Freigabe für den gesamten Pluginordner an. Für den Server-Sync wird ausschließlich der exakte Webhook-Pfad mit
POSTund den eazyFind-IP-Adressen freigegeben.
So gehen Sie vor
- Erstellen Sie vor dem Update eine Sicherung von Shopdateien und Datenbank.
- Laden Sie das zu Ihrer Lizenz passende Pluginpaket in der JTL-Pluginverwaltung hoch.
- Installieren beziehungsweise aktualisieren Sie ZHZ EazyFind. Ändern Sie die Plugin-ID nicht.
- Öffnen Sie die Pluginverwaltung erneut und kontrollieren Sie Version und Aktivstatus.
- Öffnen Sie das eazyFind-Dashboard. Bei einer Migration werden Shop, Zugang und vorhandene Einstellungen automatisch zugeordnet.
- Warten Sie, bis der vorbereitende Vollsync und die Migrationsprüfungen erfolgreich sind. Bis zur Freigabe bleibt der bisherige Suchweg aktiv.
- Testen Sie die gespeicherten Vergleichssuchen. Prüfen Sie besonders Produktname, Artikelnummer, Preise, Kundengruppen, Sprache und Domain.
- Aktivieren Sie V3 erst, wenn das Dashboard die Bereitschaft bestätigt. Bei automatisch freigegebenen Migrationen erfolgt die Umschaltung nach bestandenen Prüfungen.
Ergebnis prüfen
Das Plugin zeigt die aktuelle Version, der Vollsync ist abgeschlossen, die Vergleichssuchen sind plausibel und der Shop verwendet das konfigurierte V3-Suchmodal.
Häufige Probleme
| Problem | Lösung |
|---|---|
| „V3 ist noch nicht vollständig bereit“ | Öffnen Sie den Sync- und Migrationsstatus. Beheben Sie den dort genannten Fehler und lassen Sie die Prüfung erneut laufen. |
| Nach dem Update fehlen Produkte | Starten Sie einen Vollsync und prüfen Sie Ausschlussattribute sowie Kundengruppensichtbarkeit. |
| Pluginpaket wird abgelehnt | Verwenden Sie das unveränderte Release-ZIP und prüfen Sie JTL- sowie PHP-Mindestversion. |
| Einstellungen wirken anders | Vergleichen Sie den aktiven Shop, die Sprache und die V3-Einstellungsbereiche. Alte Modaloptionen werden nicht mehr verwendet. |
Nächster Schritt
Lesen Sie Synchronisation und Indexstatus prüfen und führen Sie danach reale Suchtests im Shop aus.
Produktversion: eazyFind V3 / Plugin 3.2.100 Zuletzt geprüft: 05.11.2026