Adressprüfung
● Läuft live in diesem ShopPrüft Adressen im ganzen Shop: Postleitzahl und Ort, optionales Feld für die Hausnummer und Adressvorschläge mit Google Places, im Browser und auf dem Server.
- Version 1.0.0
- Shopware 6.6.x – 6.7.x
- Hersteller Kuhlware
- Postleitzahl für mehr als 30 Länder prüfen, im Browser und auf dem Server
- Ort zur Postleitzahl vorschlagen (DE, AT, CH) und bei Abweichung warnen
- Optionales eigenes Feld für die Hausnummer, gespeichert im normalen Straßenfeld
- Adressvorschläge mit Google Places beim Tippen, Key bleibt auf dem Server
- Wirkt in Registrierung, Checkout, Kundenkonto und Adressbuch, pro Verkaufskanal einstellbar
Die Adressprüfung sorgt dafür, dass in deinem Shop vollständige und plausible Adressen ankommen. Sie arbeitet in allen Adressformularen: bei der Registrierung, im Checkout, im Kundenkonto und im Adressbuch.
Die Postleitzahl wird für mehr als 30 Länder auf ihr Format geprüft. Für Deutschland, Österreich und die Schweiz schlägt das Plugin den passenden Ort vor und weist darauf hin, wenn Postleitzahl und Ort nicht zusammenpassen. Der Kunde übernimmt den Vorschlag mit einem Klick. Die Daten liegen im Plugin, dafür verlässt nichts den Shop.
Auf Wunsch zeigt das Plugin neben der Straße ein eigenes Feld für die Hausnummer. Beide Werte werden zusammen im Straßenfeld gespeichert, Bestellungen, Rechnungen, Versanddienstleister und andere Plugins arbeiten unverändert weiter. Eine fehlende Hausnummer kannst du als Hinweis anzeigen oder verlangen.
Adressvorschläge mit Google Places
Optional schlägt Google Places vollständige Adressen vor, während der Kunde die Straße tippt. Ein Klick füllt Straße, Hausnummer, Postleitzahl, Ort und Land. Die Anfrage läuft über deinen Server, der API-Key gelangt nie in den Browser, und die Zahl der Anfragen ist begrenzt.
Prüfung auch auf dem Server
Die wichtigsten Regeln gelten nicht nur im Browser, sondern auch beim Speichern: ein ungültiges Postleitzahlen-Format, eine fehlende Hausnummer oder ein nicht passender Ort lassen sich je nach Einstellung nicht mehr absenden. So gelangen auch über andere Wege keine fehlerhaften Adressen in dein System.
Externe Services: Standardmäßig keine. Nur wenn du Adressvorschläge mit Google Places aktivierst, sendet dein Server den getippten Adresstext mit deinem API-Key an die Google Places API. Der Key gelangt nicht in den Browser.
Funktionen
- Format der Postleitzahl für mehr als 30 Länder prüfen
- Ort zur Postleitzahl vorschlagen und per Klick übernehmen (DE, AT, CH)
- Hinweis oder Sperre, wenn Postleitzahl und Ort nicht zusammenpassen
- Eigenes Feld für die Hausnummer, Straße und Nummer werden zusammen gespeichert
- Fehlende Hausnummer als Hinweis anzeigen oder verlangen (je Land einstellbar)
- Adressvorschläge mit Google Places inklusive Tastatursteuerung
- Vorschläge füllen Straße, Hausnummer, Postleitzahl, Ort und Land
- Server-Key bleibt im Backend, Anfragen werden begrenzt
- Prüfung beim Speichern auf dem Server, nicht nur im Browser
- Funktioniert in Registrierung, Checkout, Kundenkonto und Adress-Dialog
- Eigene Fehlermeldungen in Deutsch und Englisch
- Einstellungen pro Verkaufskanal
Installation
- Plugin im Plugin-Manager installieren und aktivieren. Danach Cache leeren und das Theme neu kompilieren.
- Unter Erweiterungen > Meine Erweiterungen > Adressprüfung > Konfigurieren die Adresshilfe wählen: aus, lokal oder mit Google Places.
- Für Google Places einen Server-Key der „Places API (New)“ eintragen und auf deine Server-IP beschränken.
- Prüfungen einstellen: Postleitzahl-Format, Verhalten bei nicht passendem Ort und bei fehlender Hausnummer, optional das eigene Feld für die Hausnummer.
- Eine Adresse im Shop testen, zum Beispiel im Kundenkonto unter Adressen.
FAQ
Wird die Hausnummer wirklich in einem eigenen Feld gespeichert?
Nein. Das Feld ist eine Eingabehilfe: Straße und Hausnummer werden beim Speichern wieder zusammen im normalen Straßenfeld abgelegt. Dadurch laufen Bestellungen, Rechnungen, Versand und andere Plugins unverändert weiter.
Was passiert mit dem Google-Key und den Daten?
Der Key liegt nur auf dem Server. Der getippte Text geht von deinem Server an die Google Places API, bitte nenne das in deiner Datenschutzerklärung. Ohne Google arbeitet das Plugin komplett lokal.
Für welche Länder funktioniert der Ortsvorschlag?
Für Deutschland, Österreich und die Schweiz, die Daten stammen von GeoNames (CC BY 4.0). Das Format der Postleitzahl wird für mehr als 30 Länder geprüft.
Kann ich die Prüfung nur als Hinweis einstellen?
Ja. Bei nicht passendem Ort und fehlender Hausnummer wählst du zwischen aus, Hinweis und verlangen. Das Format der Postleitzahl lässt sich ein- und ausschalten.
Funktioniert das auch im One-Page-Checkout?
Ja. Dort nutzt der Browser die eigene Adresshilfe des Checkouts, die Prüfung auf dem Server gilt aber auch dort.
Changelog
1.0.0 08.11.2026 Shopware 6.6.x – 6.7.x
Hinzugefügt
- Prüfung der Postleitzahl für mehr als 30 Länder in allen Adressformularen: Registrierung, Checkout, Kundenkonto und Adressbuch
- Ortsvorschlag für deutsche, österreichische und Schweizer Postleitzahlen mit Hinweis, wenn Postleitzahl und Ort nicht zusammenpassen, per Klick übernehmen
- Optionales eigenes Feld für die Hausnummer; Straße und Nummer werden zusammen im Straßenfeld gespeichert
- Hinweis oder Pflicht bei fehlender Hausnummer, je Land einstellbar
- Optionale Adressvorschläge mit Google Places beim Tippen der Straße, die Straße, Hausnummer, Postleitzahl, Ort und Land füllen
- Die Regeln werden auch beim Speichern geprüft, fehlerhafte Adressen lassen sich so auch auf anderem Weg nicht absenden
- Einstellungen pro Verkaufskanal, Texte auf Deutsch und Englisch
