Shopware‑Plugin · Kostenlos · MIT‑Lizenz
Hausnummer: Prüfung oder eigenes Feld je Land
Technischer Name: MidSynHouseNumber
Kunden vergessen die Hausnummer – das Paket kommt zurück. Dieses Plugin verhindert das, ohne Ihre Adressdaten umzubauen: Je Land entscheiden Sie, ob das Straßenfeld geprüft wird oder ein eigenes Feld „Hausnummer“ erscheint.
- Shopware 6.6 und 6.7
- Version 1.0.0
- MIT-Lizenz
Ablauf
So funktioniert es
01 · Land
Land öffnen
Einstellungen → Länder → Land öffnen → Tab „Adress-Einstellungen“ → Karte „Hausnummer“. Ohne Einstellung bleibt alles wie bisher.
02 · Modus
Prüfen oder eigenes Feld
Straßenfeld per Regex prüfen (Vorlage oder eigener Regex, mit Testfeld) oder ein eigenes Feld „Hausnummer“ anzeigen. Opt-out und Fehlertext je Sprache sind wählbar.
03 · Shop
Prüfung beim Kunden
Registrierung, Gast-Checkout und Adressbuch prüfen die Adresse auf dem Server. Lieferadressen ohne Hausnummer werden spätestens auf der Bestellbestätigung abgefangen.
Funktionen
Was das Plugin kann
Eine Prüfung der Hausnummer wird im Shopware-Feedback-Portal gewünscht. Zum Wunsch im Feedback-Portal
- 01
Regex-Prüfung je Land
Vorlagen „muss eine Ziffer enthalten“, „Straße, dann Hausnummer“ und „Hausnummer, dann Straße“ oder ein eigener Regex – inklusive Testfeld in der Administration.
- 02
Eigenes Feld „Hausnummer“
Die Nummer wird beim Speichern ins Straßenfeld übernommen, vor oder hinter der Straße. Rechnungen, Versandlabels und Schnittstellen sehen weiterhin ein Straßenfeld.
- 03
Opt-out
Je Land zuschaltbar: „Meine Adresse hat keine Hausnummer“. Solche Bestellungen erhalten das Tag „Hausnummer prüfen“ – z. B. als Auslöser im Flow Builder.
- 04
Prüfung im Checkout
Gespeicherte Lieferadressen ohne Hausnummer werden auf der Bestellbestätigung abgefangen – auch Adressen, die andere Plugins anlegen. Die Bestellung ist gesperrt, bis die Adresse korrigiert ist.
- 05
Auf dem Server, auch Headless
Die Prüfung läuft über die Shopware-Validierung und wirkt damit auch über die Store-API.
VIOLATION::MIDSYN_HOUSE_NUMBER_MISSING - 06
Fehlertext je Land und Sprache
Eigener Hinweistext je Land über den Sprachumschalter; leer bedeutet Standardtext. Ein fehlerhafter Regex macht die Regel inaktiv, er sperrt den Shop nicht.
Screenshots
So sieht es aus
Aufnahmen aus Shopware-Testinstallationen.
Administration: Modus, Position, Opt-out, Fehlertext und Testfeld je Land.
Eigenes Feld: Österreich: eigenes Feld „Hausnummer“ mit Opt-out.
Regex-Prüfung: Deutschland: Hinweis am Straßenfeld, wenn die Nummer fehlt.
Checkout: Gespeicherte Lieferadresse ohne Nummer wird vor der Bestellung abgefangen.
Qualität
Geprüft auf Shopware 6.6 und 6.7
Testlauf vom 01.10.2026 mit dem ausgelieferten Plugin-Paket (Stand 85b93d8, inhaltsgleich mit Release v1.0.0).
| Prüfung | Shopware 6.6.10.27 | Shopware 6.7.14.2 |
|---|---|---|
| PHP-Unit-Tests (PHPUnit) | 64 Tests bestanden | 64 Tests bestanden |
| JavaScript-Tests (Jest) | 69 Tests bestanden | 69 Tests bestanden |
| Plugin-Prüfung (shopware-cli validate) | keine Befunde | keine Befunde |
| Integrationstests (Admin, Formulare, Checkout, Tag) | 5 von 5 bestanden | 5 von 5 bestanden |
| Browser-Tests Storefront (Playwright) | 8 von 8 bestanden | 8 von 8 bestanden |
| Browser-Tests Administration (Playwright) | 5 von 5 bestanden | 5 von 5 bestanden |
| Deinstallieren und Neuinstallieren | bestanden | bestanden |
Testprotokoll anzeigen
- Geprüft wurde das ausgelieferte Plugin-ZIP auf frisch installierten Shops (Produktionsmodus), alles in einem Durchgang ohne Wiederholungen.
- PHP-Unit-Tests unter PHP 8.2, Shops unter PHP 8.3 (6.6) und PHP 8.4 (6.7), Datenbank MariaDB 10.11.
- Nicht geprüft: echte Express-Zahlarten (getestet ist nur die Erkennung der Routen) und MySQL (nur MariaDB 10.11).
- Log-Prüfung ohne ungewollte Einträge des Plugins.
Kompatibilität
Systemvoraussetzungen
| Komponente | Voraussetzung | Hinweis |
|---|---|---|
| Shopware | 6.6 und 6.7 | Eine Plugin-Version für beide Versionen |
| PHP | ab 8.2 | Getestet mit 8.2, 8.3 und 8.4 |
| Datenbank | MariaDB 10.11 getestet | MySQL nicht geprüft |
| Daten | keine eigenen Tabellen | Einstellungen am Land, Zusatzfelder an der Adresse, ein Tag |
| Theme | Standard-Theme | Block component_address_form_street muss erhalten bleiben |
Grenzen
- Express-Zahlarten: Legt ein anderes Plugin den Kunden über eine eigene Route an, wird die Adresse dort nicht abgelehnt, sondern auf der Bestellbestätigung abgefangen. Getestet ist nur die Erkennung der Routen, nicht mit echten Express-Zahlarten-Konten.
- Adressen, die direkt über die Admin-API importiert werden, prüft das Plugin nicht.
- Die Rechnungsadresse wird nur in den Formularen geprüft, nicht im Checkout.
- Themes, die den Block component_address_form_street vollständig ersetzen, zeigen das Hausnummernfeld nicht; die Prüfung auf dem Server greift trotzdem.
- Getestet mit MariaDB 10.11; MySQL wurde nicht geprüft.
Schnellstart
Installation
Variante A: in der Administration
- ZIP herunterladen – MidSynHouseNumber-1.0.0.zip
- Hochladen: Erweiterungen → Meine Erweiterungen → „Erweiterung hochladen“ und die ZIP-Datei wählen.
- Installieren und aktivieren über das Kontextmenü der Erweiterung.
- Einstellen: Einstellungen → Länder → Land öffnen → Tab „Adress-Einstellungen“ → Karte „Hausnummer“.
Variante B: per Konsole
ZIP nach custom/plugins/ entpacken, dann:
bin/console plugin:refresh
bin/console plugin:install --activate MidSynHouseNumber
bin/console cache:clear- Deinstallation ohne „Daten behalten“ entfernt die Einstellungen an den Ländern, die Zusatzfelder an Adressen und das Tag. Die Straßenfelder bleiben vollständig.
Versionen
Änderungsprotokoll
- v1.0.0
Erste Version: Hausnummer je Land per Regex prüfen oder als eigenes Feld erfassen, Opt-out, Prüfung der Lieferadresse im Checkout, Bestell-Tag „Hausnummer prüfen“.
MIT-Lizenz – kostenlos, auch gewerblich
Sie dürfen das Plugin in privaten und gewerblichen Shops einsetzen, anpassen und weitergeben. Es wird ohne Gewährleistung bereitgestellt; der Lizenztext liegt dem Download bei.
Anpassung gewünscht?
Sie brauchen eine Erweiterung oder eine Anpassung an Ihren Shop? Schreiben Sie mir.
Kontakt aufnehmenShopware-Plugins
Weitere kostenlose Plugins
Passwort anzeigen
Barrierefreier Button zum Anzeigen und Verbergen in allen Passwortfeldern der Storefront.
MidSynPasswordVisibilityDetails zu Passwort anzeigenFlow-Mails: CC, BCC und Antwortadresse
CC, BCC und eine echte Antwortadresse (Reply-To) für die Flow-Aktion „E-Mail senden“.
MidSynFlowMailRecipientsDetails zu Flow-Mails: CC, BCC und AntwortadresseProdukt-Downloads
Anleitungen, Datenblätter und Videos je Produkt – im Shop als eigener Tab „Downloads“.
MidSynProductDownloadsDetails zu Produkt-Downloads