Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:faqyellowmap_ox7



Installations-und Konfigurationsanleitung für OXID ab Version 7.0.x - 7.1.x
YellowMap AG - CAS-Weg 1-5 - 76131 Karlsruhe\\

Das Plugin im OXID Solution Hub: https://solutionhub.oxid-esales.com/address-autocomplete-und-verification/
Das Plugin auf Github: https://github.com/YellowMap/addressverification-plugin-oxid-v7 (public)

Voraussetzungen

Um das Plugin nutzen zu können, benötigen Sie einen SmartMaps-API-Key.

Einfach und risikolos testen: bis 6.000 Autocomplete und Verifikationen pro Monat kostenlos.
Erhalten Sie Ihren SmartMaps-API-Key kostenlos hier: https://www.smartmaps.net/preise/#reg-form

Installation

Composer

Verbinden Sie sich mit einer Konsole mit dem Webserver, navigieren Sie zum Basisordner des Shops (wo sich die composer.json-Datei befindet)
Führen Sie das folgende Kommando aus

composer require yellowmap/addressverification-plugin-oxid-v7

Aktivieren Sie das OXID Plugin mit folgendem Befehl:

vendor/bin/oe-console oe:module:activate ymaddressverification

Manuell

Erstellen Sie im Verzeichnis {shoproot}/vendor die Ordner yellowmap/addressverification-plugin-oxid-v7.
Extrahieren Sie die das Plugin-Zip-Paket und laden Sie die Daten aus dem Ordner addressverification-plugin-oxid-v7-*Versionnummber* in den eben erstellten Ordner addressverification-plugin-oxid-v7
- Aktualisieren Sie die composer.json im Shoproot des Shops. Fügen Sie den folgenden Block hinzu:

  "autoload": {
    "psr-4": {
      "YellowMap\\YMAddressVerification\\": "./vendor/yellowmap/addressverification-plugin-oxid-v7"
    }
  }

Installieren Sie das Plugin mit folgendem Befehl:

vendor/bin/oe-console oe:module:install vendor/yellowmap/addressverification-plugin-oxid-v7

Installieren Sie die Modul Assest mit folgendem Befehl:

vendor/bin/oe-console oe:module:install-assets

Generieren Sie die autoload-Dateien neu, indem Sie nachfolgenden Befehl ausführen

composer dump-autoload

Aktivieren Sie das OXID Plugin mit folgendem Befehl:

vendor/bin/oe-console oe:module:activate ymaddressverification

Nach der Installation

Temp Verzeichnis leeren

Leeren Sie das Temp Verzeichnis (tmp) in Ihrem OXID eShop Hauptverzeichnis. Die enthaltene .htaccess-Datei darf dabei aber NICHT gelöscht werden!

SmartMaps Plugin aktivieren

Aktivieren Sie das SmartMaps Plugin im OXID Administrationsbereich unter Erweiterungen –> ModuleSmartMaps Address Autocomplete & Verification, falls Sie dies noch nicht über die Command Line gemacht haben.

Konfiguration

Loggen Sie sich in den Admin Ihres OXID eShops ein und hinterlegen Sie Ihren SmartMaps-API-Key unter
Erweiterungen –> Module –> SmartMaps Address Autocomplete & Verification –> Einstell.


Funktionsweise

Wenn der Kunde auf einem Formular landet, in dem nach einer Adresse gefragt wird (Registrierung, Gast-Checkout, Benutzerprofiladressen), erweitert das SmartMaps-Plugin das Straßenfeld.
In diesem Feld kann der Kunde die Adressdaten (Straße, Postleitzahl, Hausnummer …) eingeben und das Plugin wird auf der Grundlage der Eingabe Ergebnisse vorschlagen.



Wenige Buchstaben reichen aus, um Kunden mit der Address Autocomplete-Funktion zu begeistern - DSGVO-konform und mit einem umfangreichen kostenfreien Kontingent. Die integrierte Normalisierung und Verifikation führen zu geprüften Adressen und damit zu weniger Rückläufer sowie geringeren Kosten. Ab der Eingabe der ersten Zeichen werden die passenden Vorschläge für die Liefer- und Rechnungsadresssuche geliefert. Der Kunde spart Zeit bei der Eingabe, der Komfort führt schnell zum Erfolg und weniger Abbrecher sind die Folge.

Das Plugin integriert sich direkt in den Checkout-Prozess.

Hinweis zur Länderbeschränkung

Standardmäßig werden die Vorschläge auf das/die unter Stammdaten –> Grundeinstellungen –> Einstell. –> Global„ konfigurierte(n) Land/Länder beschränkt.

Wenn das Länderfeld des Formulars gesetzt ist (Auswahl eines Landes oder nach der ersten Autovervollständigung), ist die Suche jetzt auf dieses Land beschränkt.
Sollte kein Land ausgewählt sein, z. B. durch das Zurücksetzen der Länderdropdown-Liste auf “-„, gilt das Standardverhalten.

public/faqyellowmap_ox7.txt · Zuletzt geändert: 2024/04/11 10:15 von markusmichalski