Adresse Auto-Complete (Adressdaten automatisch befüllen)

Inhalt

1. Wozu dient das Plugin "Adresse Auto-Complete (Adressdaten automatisch befüllen)"

Das Plugin „Adresse Auto-Complete“ optimiert die Adresseingabe im Check-out Deines JTL-Shops. Kunden profitieren von einer schnelleren und einfacheren Adresseingabe, da bereits nach wenigen Buchstaben passende Adressvorschläge erscheinen. Dies spart wertvolle Zeit und macht den Bestellvorgang reibungsloser. Zudem werden Tippfehler vermieden, was die Wahrscheinlichkeit von Fehlzustellungen erheblich reduziert.

Damit gibt es weniger Rücksendungen und eine effizientere Logistik, da korrekte Adressdaten sofort übernommen werden. Der internationale Versand wird ebenfalls erleichtert, indem das Plugin länderspezifische Adressformate unterstützt und den globalen Bestellprozess optimiert. Die verbesserte Datenqualität sorgt für einen reibungslosen Ablauf in der Versandabteilung und reduziert den Aufwand für manuelle Korrekturen.

Ein vereinfachter Check-out-Prozess senkt zudem die Abbruchrate, steigert die Anzahl erfolgreicher Bestellungen und erhöht die Kundenzufriedenheit. Du profitierst dadurch von einer höheren Conversion Rate und sparst Zeit sowie Kosten durch weniger Verwaltungsaufwand.

2. Was kann das Plugin "Adresse Auto-Complete (Adressdaten automatisch befüllen)"

Das knowmates-Plugin „Adresse Auto-Complete“ ist exklusiv für das Shopsystem JTL-Shop entwickelt und vereinfacht die Eingabe von Rechnungs- und Lieferadressen im Check-out. Durch ein innovatives „Adresse suchen“-Feld erhalten Kunden bereits nach der Eingabe weniger Buchstaben präzise Adressvorschläge in einer Dropdown-Liste. Ein Klick oder Tipp auf die gewünschte Adresse füllt automatisch alle relevanten Adressfelder aus. Dies spart wertvolle Zeit, sorgt für korrekte Eingaben und erhöht die Zustellgenauigkeit Deiner Lieferungen (siehe Abbildung 1 & 2).

Das Plugin nutzt die Google Maps-API, um in Echtzeit gültige Adressen bereitzustellen, und berücksichtigt internationale Adressformate, um den globalen Versand zu erleichtern. Es minimiert Tippfehler sowie ungenaue Eingaben und trägt zu einer effizienteren Versandabwicklung bei.

Abbildung 1: Automatische Befüllung aller Adressfelder

Abbildung 2: Erhöhte Zustellgenauigkeit

3. Systemvoraussetzungen

  • JTL-Shop 5.2, 5.3
  • PHP 8.1, PHP 8.2
  • Template NOVA
  • ionCube Loader in der aktuellsten Version

4. Installation im JTL-Shop

Für Deinen JTL-Shop 5 beziehst Du Plugins über den JTL-Extension Store. Um auf Inhalte des JTL-Extension Stores zugreifen zu können, musst Du zunächst Dein JTL-Konto mit Deinem JTL-Shop 5 verknüpfen. Dies wird normalerweise beim Installationsprozess des Shops bereits abgefragt.

So verknüpfst Du Dein JTL-Konto mit Deinem JTL-Shop 5:

  1. Logge Dich im JTL-Shop-Backend ein.
  2. Navigiere im Menü zu „PLUGINS“ > „Meine Käufe“.
  3. Klicke auf „Konto verknüpfen“.
  4. Logge Dich mit Deinen JTL-Daten ein.
  5. Anschließend siehst Du in „PLUGINS“ > „Meine Käufe“ die Übersicht zu Deinen Lizenzen und Subscriptions.

So buchst Du eine Extension für JTL-Shop 5:

  1. Rufe den JTL-Extension Store auf.
  2. Suche nach dem gewünschten Plugin.
  3. Wähle das Plugin aus und klicke auf „Jetzt auschecken“.
  4. Klicke im folgenden Fenster auf „Anmelden“ und melde Dich mit Deinem zentralen JTL-Login an.
  5. Klicke im JTL-Checkout auf „Jetzt bestellen“, um die Bestellung abzuschließen.
  6. Rufe Dein JTL-Shop-Backend auf. Unter „PLUGINS“ > „Meine Käufe“ befindet sich jetzt im Bereich „Ungebundene Lizenzen“ Deine eben erworbene Lizenz.
  7. Nun ordnest Du das Plugin Deinem Shop zu. Klicke dafür auf „An diesen Onlineshop“ anbinden.
  8. Anschließend findest Du die Lizenz im Bereich „Gebundene Lizenzen“ und die Schaltfläche „Installieren“ steht zur Verfügung. Nach der Installation kannst Du das Plugin im Menü unter „PLUGINS“ > „Plugin-Manager“ in der Registerkarte „Aktiviert“ konfigurieren.

5. Plugin "Adresse Auto-Complete (Adressdaten automatisch befüllen)" einrichten

Rufe das Konfigurationsmenü entweder unter „Plugin-Manager“ > „Aktiviert“ über das entsprechende Zahnrad-Icon auf der rechten Seite oder direkt über „Installierte Plugins“ > „Adresse Auto-Complete“ auf.

Du siehst nun die Plugin-Benutzeroberfläche (siehe Abbildung 3).

Abbildung 3: Benutzeroberfläche vom Plugin „Warenkorb-Button Plus“

Oben rechts befindet sich ein Switch, mit welchem Du zwischen hellem und dunklem Design wechseln kannst.

Triff nun die gewünschten Einstellungen für das Plugin „Adresse Auto-Complete“.

Der Reiter „Einstellungen“ beinhaltet folgende Optionen (siehe Abbildung 4):

Abbildung 4: Reiter Einstellungen

  • Plugin Status (an/aus): Ein- und Ausschalten des Plugins
  • Nutze Google Maps API (an/aus): Ein- und Ausschalten, ob die Google Maps API genutzt werden soll
  • Eintrag im JTL-Consentmanager anzeigen (an/aus): Ein- und Ausschalten, ob der Eintrag im JTL-Consentmanager angezeigt werden soll (den Eintrag kannst Du im Shopbackend unter den Einstellungen zum Consentmanager bearbeiten.)

Verwaltung der Google API-Schlüssel

Hinweis:

Um Autocomplete nutzen zu können, musst Du bei der Google Cloud Console einen API-Schlüssel anlegen. Besuche dazu die Google Cloud Console, erstelle ein neues Projekt oder wähle ein bestehendes aus, und generiere dann unter den API-Einstellungen einen neuen API-Schlüssel. Stelle sicher, dass Du die Google Places API aktiviert hast, um Autocomplete erfolgreich zu verwenden.

Die Anzahl der Abrufe bei Google wird nicht direkt aufgezeichnet, da dies in der Google Cloud Console geschieht. Um die Nutzung Deiner Google Maps API zu überprüfen, besuche bitte die Google Cloud Console. Dort findest Du detaillierte Informationen über die API-Nutzung und kannst die aktuellen Quoten einsehen. Außerdem kannst Du Benachrichtigungen für das Erreichen von Grenzwerten einstellen, um rechtzeitig informiert zu werden.

  • Name des Schlüssels: Benennung des API-Schlüssels zur Wiedererkennung
  • Google API-Schlüssel: Eingabe des API-Schlüssels
  • Aktiv (an/aus): Ein- und Ausschalten des API-Schlüssels (wenn er als “aktiv” gespeichert wird, prüft Google vorerst den API-Schlüssel)
  • Speichern: Speichern des angelegten API-Schlüssels

Der Reiter “Länder beinhaltet folgende Optionen (siehe Abbildung 5):

Abbildung 5: Reiter “Länder”

Hinweis:

Fast alle Speditionen erwarten die Übermittlung von Straße und Hausnummer in separaten Feldern. In JTL Wawi wird jedoch Straße und Hausnummer in nur einem Feld erfasst. Dementsprechend verwenden manche Versanddienstleister eigene Importierfunktionen, wie bspw. die Aufteilung am ersten oder letzten Leerzeichen. Deshalb kann es für den internationalen Versand notwendig sein, die Straßennamen/Hausnummernkombination in der korrekten Reihenfolge zu speichern.

  • Länder, bei denen die Hausnummer vor dem Straßennamen stehen sollen: Auswahl der Länder, in denen die Hausnummer vor dem Straßennamen stehen soll

Hinweis:

Für Länder, in denen auch nach Bundesstaat unterschieden wird, ist es wichtig, dies korrekt in der JTL-Wawi zu erfassen. Dazu muss zwischen dem Kürzel für den Bundesstaat und der PLZ ein Leerzeichen sein. Dann kann der Versanddienstleister dies korrekt trennen und verwenden.

  • Länder, bei denen das Bundesland als Abkürzung übertragen werden soll: Auswahl der Länder, in denen das Bundesland als Abkürzung übertragen werden soll

Der Reiter „Lizenz“ beinhaltet folgende Optionen (siehe Abbildungen 6 & 7):

Abbildung 6: Reiter „Lizenz“ – keine gültige Lizenz vorhanden

  • Lizenz abfragen: Beim Kauf wird für die angegebene Domain eine Lizenz auf dem Lizenz-Server angelegt. Über den Button wird auf diesem geprüft, ob für Deine Domain eine Lizenz des Plugins vorliegt, und welche Art von Lizenz es ist.
  • Plugin für 14 Tage testen: Fordere eine Testphase von 14 Tagen an. Nach diesen 14 Tagen läuft die Test-Lizenz ab.
  • Lizenz kaufen: Eine vollwertige Lizenz über 12 Monate ist im JTL-Extension Store zu erwerben. Hier kannst Du Deine Lizenz auch um 12 oder 24 Monate verlängern.

Abbildung 7: Reiter „Lizenz“ – gültige Lizenz vorhanden

  • Lizenz abfragen: Beim Kauf wird für die angegebene Domain eine Lizenz auf dem Lizenz-Server angelegt. Über den Button wird auf diesem geprüft, ob für Deine Domain eine Lizenz des Plugins vorliegt, und welche Art von Lizenz es ist.
  • Lizenz verlängern: Eine vollwertige Lizenz über 12 Monate ist im JTL-Extension Store zu erwerben. Hier kannst Du Deine Lizenz auch um 12 oder 24 Monate verlängern.

Der Reiter „Über“ beinhaltet folgende Informationen (siehe Abbildung 8):

Abbildung 8: Reiter „Über“ (Versionsnummer exemplarisch)

Im Reiter „Über“ findest Du Informationen zur Plugin-Version, PHP-Version, IonCube-Version, zum Plugin-Autor sowie die (Shop)-Webseite des Autors als auch zwei Buttons, über den Du das Plugin Log leerst bzw. öffnest.