Für unser endereco-Plugin für JTL 5 ist eine neue Version verfügbar. Dieses Update umfasst unter anderem eine verbesserte Absicherung der Schnittstelle, konfigurierbare Bezeichnungen für Adresskorrekturen in der WaWi und Unterstützung für JTL-Shop 5.8 und PHP 8.5.
- Version 1.4.0: kompatibel mit JTL-Shop 5.3.0 bis 5.8.2 und PHP 8.1 bis 8.5
Wichtig: JTL-Shop 5.1, 5.2 sowie PHP 7.4 und 8.0 werden ab dieser Version nicht mehr unterstützt. Wenn du noch eine dieser Versionen nutzt, aktualisiere sie unbedingt, bevor du das Update ausführst.
Was ist neu?
- Konfigurierbare Bezeichnungen in der WaWi: Wenn das Plugin einen Korrekturhinweis in den Auftragskommentar schreibt, wurden dort bisher feste Bezeichnungen für die einzelnen Adressfelder verwendet. Ab jetzt kannst du für jede Komponente eine eigene Bezeichnung festlegen: Land, Bundesland, PLZ, Ort, Straße, Hausnummer, Adresszusatz. Außerdem kannst du einen Platzhalter für leere Werte definieren. Korrekturen am Bundesland und beim Adresszusatz werden jetzt ebenfalls angezeigt. Die Standardwerte sind auf Deutsch vorbelegt.
- Neue Fehlermeldungen: Das Plugin zeigt jetzt lokalisierte Hinweise für fehlende oder nicht auflösbare Hausnummern, Packstation- und Postfilial-Adressen sowie fehlende oder ungültige Postnummern. Dein Kunde sieht also genauer, was nicht stimmt.
Sicherheitsverbesserungen
Zwei Änderungen, die im Hintergrund laufen und dich im Alltag nicht betreffen, deinen Shop aber sicherer machen:
- API-Key abgesichert: Die Kommunikation mit der endereco-API läuft jetzt vollständig serverseitig.
- Sichere Übernahme von Adresskorrekturen: Übernimmt dein Kunde im Checkout einen Korrekturvorschlag, speichert das Plugin die Adresse in seinem Kundenkonto. Dabei wird jetzt geprüft, dass die Änderung wirklich aus einer laufenden Sitzung in deinem Shop kommt und nur Adressen des angemeldeten Kunden betrifft. Alle anderen Anfragen werden abgelehnt.
Weitere Verbesserungen
- JS-SDK auf Version 1.14.5 aktualisiert: Die neue Version behebt widersprüchliche Ergebnisanzeigen der Adressprüfung, fehlende Status-Informationen nach Namenskorrekturen und fehlerhafte Anzeigen bei erneut bearbeiteten Adressen.
- JTL-Shop 5.8 und PHP 8.5: Das Plugin unterstützt jetzt offiziell auch die neuesten Versionen.
Behobene Fehler
- Adressstatus bei deaktivierten Feldern: Optionale Felder wie Bundesland oder Adresszusatz beeinflussten den Prüfstatus, obwohl sie im Formular deaktiviert waren. Das ist nun behoben.
- Packstation-/Postfilial-Adresstyp: Der auf der Seite gewählte Adresstyp wird jetzt vor der ersten Prüfung korrekt übernommen.
- Bundesland-Feld nach Seitenladevorgang: Der gespeicherte Status des Bundesland-Felds wird jetzt auch nach dem erneuten Laden der Seite korrekt angezeigt.
- Echtzeitprüfungen auf PHP 8.5: Eine Deprecation-Warnung auf PHP 8.5 konnte dazu führen, dass alle Echtzeitprüfungen im Frontend abbrachen. Das ist behoben.
Update-Hinweis
Beim Update werden zwischengespeicherte Prüfdaten (Prüfstatus und ggf. Korrekturvorschläge) aus älteren Versionen gelöscht, weil sie nicht mit der neuen JS-SDK kompatibel sind. Sie werden bei der nächsten Prüfung automatisch neu erstellt; für deine Kunden sichtbare Daten gehen dabei nicht verloren.
Die Datei io.php und die zugehörige .htaccess werden beim Update automatisch entfernt. Falls das fehlschlägt, sollten die Dateien manuell gelöscht werden.
Wir empfehlen, das Update zuerst in einer Testumgebung durchzuführen. Die vollständigen Release Notes findest du auf unserer Seite unter Release Notes für JTL 5.
Mehr über endereco erfahren
Alles rund um unsere Adressvalidierung, unsere Integrationen für verschiedene Shopsysteme und die JTL-Anbindung findest du auf unserer Webseite.