Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Das Plugin stellt seine Daten nur auf den folgenden Storefront-Seiten bereit. Auf allen anderen Seiten wird nichts geladen und kein Formular verändert.
| Seite | Route |
|---|---|
| Checkout, Bestellübersicht | frontend.checkout.confirm.page |
| Warenkorb | frontend.checkout.cart.page |
| Mein Konto, Adressübersicht | frontend.account.address.page |
| Mein Konto, Adresse anlegen | frontend.account.address.create.page |
| Mein Konto, Adresse bearbeiten | frontend.account.address.edit.page |
| Anmeldung | frontend.account.login.page |
| Registrierung | frontend.account.register.page |
Die Registrierungsseite des Checkouts (
frontend.checkout.register.page) steht nicht in dieser Liste. Dort bleibt das Adressformular unverändert.
Die Vorschlagsliste schließt sich auch, wenn das Straßenfeld den Fokus verliert.
| SmartMaps-Eigenschaft | Shopware-Feld | Verhalten |
|---|---|---|
street und houseNo |
address[street] |
Straße und Hausnummer werden mit Leerzeichen verbunden. Ohne Hausnummer wird nur die Straße eingetragen. |
zip |
address[zipcode] |
wird nur gesetzt, wenn SmartMaps eine PLZ liefert |
city |
address[city] |
wird nur gesetzt, wenn SmartMaps eine Stadt liefert |
country |
address[countryId] |
Zuordnung über den ISO-Code (siehe unten) |
state |
address[countryStateId] |
Zuordnung über den Namen des Bundeslandes (siehe unten) |
Nach dem Eintragen löst das Plugin im jeweiligen Feld Browser-Events aus (input, bei Textfeldern und Land zusätzlich change), damit Shopware-JavaScript und Formularvalidierung die neuen Werte mitbekommen.
Das Plugin sucht in der Länderauswahl zuerst die Option, deren Attribut data-iso dem ISO-Code entspricht. Findet es keine, vergleicht es den Text der Option mit dem ISO-Code. Findet es auch dort nichts, bleibt die Länderauswahl unverändert.
Das Bundesland-Feld wird erst gefüllt, wenn die Auswahl nach dem Länderwechsel geladen ist. Dafür prüft das Plugin im Abstand von 200 Millisekunden, höchstens 10 Mal. Danach wählt es die Option, deren Text dem Namen des Bundeslandes entspricht (ohne Beachtung der Groß- und Kleinschreibung). Gibt es keinen Treffer, bleibt die Auswahl unverändert.
component_address_form (Adressformular) sowie base_head_stylesheet und base_body_script der Basisvorlage per sw_extends.div mit dem Attribut data-smartmaps-autocomplete gehüllt.name gefunden: input[name$="[street]"], input[name$="[zipcode]"], input[name$="[city]"], select[name$="[countryId]"] und select[name$="[countryStateId]"]. Ein Theme, das diese Namen ändert oder das Adressformular-Template ersetzt, muss angepasst werden.