Installation
- Laden Sie die ZIP-Datei in der Administration unter Erweiterungen > Meine Erweiterungen hoch oder kopieren Sie den Ordner nach
custom/plugins/.
- Installieren und aktivieren Sie die Erweiterung. Auf der Kommandozeile:
bin/console plugin:refresh
bin/console plugin:install --activate SgAddressCheck
bin/console cache:clear
- Öffnen Sie Erweiterungen > Meine Erweiterungen > Adressprüfung > Konfigurieren.
Konfiguration
Alle Einstellungen können je Verkaufskanal abweichen.
| Einstellung | Standard | Wirkung |
|---|
| Aktiv | an | Schaltet alle Prüfungen für den Verkaufskanal ein oder aus. |
| Zu prüfende Länder | leer | Leer prüft alle Länder, sonst nur die ausgewählten. |
| Straße muss eine Hausnummer enthalten | an | Das Feld Straße braucht mindestens eine Ziffer. |
| Ort darf keine Ziffern enthalten | an | Lehnt Ortsnamen wie 80331 München ab. |
| Eigenes Muster für die Straße | leer | PCRE-Muster mit Begrenzern, z. B. /^\D+\s\d+\w?$/u. Ersetzt die Hausnummernprüfung; ungültige Muster werden ignoriert. |
Die Prüfungen laufen auf dem Server: bei der Registrierung, im Adressbuch und bei Adressänderungen im Checkout. Sie gelten damit auch für Headless- und Store-API-Clients.
Fehlermeldungen
Die Texte sind Textbausteine und lassen sich unter Einstellungen > Textbausteine ändern:
| Schlüssel | Standardtext (Deutsch) |
|---|
error.VIOLATION::SG_STREET_HOUSE_NUMBER_MISSING | Bitte gib eine Hausnummer an. |
error.VIOLATION::SG_CITY_CONTAINS_DIGITS | Der Ort darf keine Ziffern enthalten. Bitte trage die Postleitzahl im Feld „PLZ“ ein. |
Häufige Fragen
Werden bereits gespeicherte Adressen geprüft?
Nein. Die Prüfung greift, wenn eine Adresse angelegt oder geändert wird. Bestehende Adressen bleiben unverändert, bis Kunden sie bearbeiten.
Manche Adressen in einem Land haben keine Hausnummer. Was tun?
Beschränken Sie die Prüfung über „Zu prüfende Länder“ auf die Länder, in denen eine Hausnummer üblich ist, oder hinterlegen Sie ein eigenes Muster für die Straße.
Gilt die Prüfung auch für Headless-Shops und die Store API?
Ja. Die Prüfung läuft auf dem Server und nicht nur im Browser, daher gilt sie für jede Oberfläche, die Adressen über Shopware speichert.
Sendet die Erweiterung Daten an Dritte?
Nein. Die Erweiterung prüft die Eingaben lokal in Ihrem Shop, ruft keine externen Dienste auf und speichert außer ihrer Konfiguration nichts.
Was passiert bei der Deinstallation?
Shopware entfernt die Konfiguration, außer Sie wählen „Benutzerdaten behalten“. Weitere Daten legt die Erweiterung nicht an.
Änderungen
- 0.1.0
- Erste Version: Hausnummernprüfung im Feld Straße und Ziffernprüfung im Feld Ort, pro Land und Verkaufskanal.
