Internationale Telefonvorwahl (dfphoneintl)
Installation, Einstellungen, Prüfung mit libphonenumber, Speicherformate und Normalisierung vorhandener Nummern des Moduls für internationale Telefonvorwahlen für PrestaShop 1.7.8 bis 9.
Überblick
DataFirefly International Phone Input (dfphoneintl) fügt vor den Feldern Telefon und Mobiltelefon der PrestaShop-Adressen eine Länderauswahl mit Flaggen ein. Die Nummer wird bei der Eingabe formatiert, mit den Nummerierungsdaten von Google libphonenumber geprüft und im gewünschten Format gespeichert.
Neu in 2.0.0: Prüfung mit den Daten von Google libphonenumber (Browser und Server), lokale SVG-Flaggen, per Tastatur bedienbare Combobox, wählbares Speicherformat (E.164, international lesbar, national), Prüfung des Mobiltyps, Werkzeug zur Normalisierung vorhandener Nummern mit Sicherung und Rückgängig, Auswahl im Backoffice, 8 Sprachen und Unterstützung von PrestaShop 1.7.8.
Voraussetzungen
- PrestaShop 1.7.8 bis 9.x (getestet mit 1.7.8.11, 8.2.1 und 9.1.5).
- PHP 7.1 oder neuer (getestet mit PHP 7.4, 8.1 und 8.5).
- Theme Classic, Hummingbird oder ein Theme mit den Feldnamen
phone,phone_mobileundid_country. - Kein externer Dienst: Daten, Flaggen und Skripte liefert Ihr Shop, ohne CDN.
Installation und Update
- Laden Sie
dfphoneintl-2.0.0.zipaus Ihrem DataFirefly-Konto herunter. - Klicken Sie unter Module > Modulverwaltung auf Modul hochladen und ziehen Sie das Zip hinein.
- Öffnen Sie Konfigurieren: Die Seite öffnet sich mit der Übersicht.
Ab 1.0.0 laden Sie das Zip 2.0.0 über das alte Modul. Das Update behält Ihre Einstellungen (aktivierte Felder, bevorzugte Länder als Favoriten) und das Verhalten von 1.0.0: Speicherung in E.164 und tolerante Prüfung. Bereits gespeicherte Nummern werden nicht geändert: Der Reiter Vorhandene Nummern zeigt zuerst eine Vorschau.
Die Auswahl für Kunden
Die Auswahl erscheint in den Adressformularen: Mein Konto > Adressen, Adressschritt des Bestellvorgangs (angemeldeter Kunde oder Gast) und vereinfachter DataFirefly-Checkout. Die Flaggen sind SVG-Bilder und auf allen Systemen lesbar, auch unter Windows.

Die Suche umfasst den Ländernamen in der Sprache des Kunden, den englischen Namen, den ISO-Code und die Vorwahl (+41), ohne Rücksicht auf Akzente. Die Liste ist vollständig per Tastatur bedienbar: Pfeiltasten, Eingabe zum Auswählen, Escape zum Schließen.

Eingabe und Prüfung
Die Nummer wird bei der Eingabe formatiert, ohne dass der Cursor springt. Verlässt der Kunde das Feld, prüft der Server die Nummer mit den vollständigen Daten (zugeteilte Bereiche, mobil oder Festnetz) und zeigt das Ergebnis unter dem Feld.

Eine zu kurze oder zu lange Nummer, eine unbekannte Vorwahl oder eine Festnetznummer im Mobilfeld erhält eine übersetzte Meldung mit dem erwarteten Format. Die Ziffern des Beispiels sind maskiert: Es wird keine echte Nummer angezeigt.

Eine mit +44 oder 0044 eingefügte oder getippte Nummer stellt die Auswahl auf das richtige Land um. Eine ausländische Nummer an einer Adresse in einem anderen Land wird international angezeigt, damit der Server sie immer lesen kann.

Smartphone und Bestellvorgang
Auf dem Smartphone nimmt die Liste die volle Breite ein, die Zeilen sind mindestens 44 px hoch und die Telefontastatur öffnet sich (type="tel", inputmode="tel", autocomplete="tel").

Im Bestellvorgang folgt die Auswahl dem Feld Land, bis der Kunde selbst eine Vorwahl wählt. Per AJAX neu geladene Formulare werden ohne doppelte Initialisierung unterstützt. Das Theme Classic verhält sich gleich.

Die Konfigurationsseite
Die Übersicht fasst die abgedeckten Felder, den Prüfmodus, das Speicherformat und die angebotenen Länder zusammen. Zu prüfende Punkte werden mit einem Link zur betreffenden Einstellung angezeigt, etwa ein Land, dessen Adressformat kein Mobilfeld enthält.

Felder und Prüfung
- Telefon und Mobiltelefon: getrennt aktivierbar.
- Das Mobilfeld akzeptiert nur Mobilnummern: Eine Festnetznummer wird dort abgelehnt. Länder, die Mobil- und Festnetz nicht unterscheiden (USA, Kanada…), werden akzeptiert.
- Mobilnummer erforderlich: Formulare im Shop, für Länder, deren Adressformat das Mobilfeld anzeigt.
- Strenge Prüfung (empfohlen): Eine Nummer, die im Nummernplan ihres Landes nicht existiert, wird mit einer Meldung abgelehnt. Tolerant: Ein Hinweis erscheint, Speichern bleibt möglich.
- Serverprüfung beim Verlassen des Feldes. Nichts wird gespeichert oder protokolliert.

Speicherformat
Wählen Sie den Wert, der in die Adresse geschrieben wird und den Versanddienstleister, Etiketten, Exporte, ERP und SMS-Module lesen:
- E.164:
+33199001234, das Format von SMS- und WhatsApp-Gateways und der meisten APIs; - International lesbar:
+33 1 99 00 12 34; - National:
01 99 00 12 34. Eine Nummer aus einem anderen Land als die Adresse bleibt international, sonst wäre kein Rückruf möglich.
Das Modul speichert außerdem die E.164-Nummer und die Eingabe des Kunden in einer eigenen Tabelle. Für die Anzeige in Bestell-E-Mails kann ein anderes Format gewählt werden, ohne die Adresse zu ändern. PDF-Rechnungen zeigen das Speicherformat.

Angebotene Länder und Standardland
Bieten Sie alle Länder an (ein Kunde kann eine Nummer aus einem anderen Land als der Lieferadresse angeben), nur die aktiven Länder des Shops oder eine Liste. Favoriten erscheinen zuerst, in der von Ihnen festgelegten Reihenfolge. Das Land der Auswahl wird so bestimmt:
- das Land der Adresse;
- bei einer neuen Adresse und aktivierter Option das Land des Besuchers (PrestaShop-Geolokalisierung, sonst Browsersprache);
- das Standardland des Shops.
Live-Vorschau
Der Reiter Live-Vorschau nutzt dieselbe Auswahl und dieselbe Serverprüfung wie Ihre Kunden. Wählen Sie Adressland und Feld, tippen Sie eine Nummer oder klicken Sie auf ein fiktives Beispiel: Sie sehen Typ, die drei Formate, den gespeicherten Wert und gegebenenfalls die Meldung.


Vorhandene Nummern normalisieren
Der Reiter Vorhandene Nummern schreibt bereits gespeicherte Nummern im Speicherformat neu:
- Filtern Sie bei Bedarf (E-Mail des Kunden, Länder, Felder, gelöschte Adressen) und klicken Sie auf Analysieren. Die Analyse ist schreibgeschützt.
- Der Bericht zählt bereits saubere, neu zu schreibende und ungültige Nummern, mit einer Vorher-/Nachher-Vorschau.
- Diese Nummern neu schreiben sichert jeden Wert vor der Änderung. Ungültige Nummern werden nie neu geschrieben. Das Änderungsdatum der Adressen wird nur auf Wunsch aktualisiert.

Jeder Vorgang steht im Verlauf. Seine Sicherung lässt sich als CSV herunterladen und der Vorgang kann rückgängig gemacht werden: Eine seitdem vom Kunden geänderte Nummer bleibt erhalten.

Starten Sie die Analyse zuerst an einer Stichprobe (Filter nach E-Mail oder Land) und laden Sie die CSV-Sicherung vor einer vollständigen Neuschreibung herunter.
Backoffice und weitere Kanäle
Die Auswahl und dieselbe Prüfung gelten für das Formular Kunden > Adressen im Backoffice (PrestaShop 1.7.8 bis 9), für eine aus einer Bestellung bearbeitete Adresse und für die DataFirefly-Bestellerfassung.

Adressen aus dem Webservice, CSV-Importen oder anderen Modulen laufen bei aktiviertem Modul ebenfalls durch das Modul: Eine gültige Nummer wird im Speicherformat geschrieben, eine ungültige bleibt unverändert.
Kompatibilität
- Themes Classic und Hummingbird, nativer Bestellvorgang, Gastbestellung, dynamischer Länderwechsel.
- Vereinfachter Checkout und Address Lookup von DataFirefly: eine Auswahl pro Feld, ihre Einstellungen bleiben unverändert.
- DataFirefly-Bestellerfassung: Auswahl in ihren Telefonfeldern.
- Ein Feld kann mit dem Attribut
data-dfpi-offauf einem Elternelement von der Auswahl ausgenommen werden.
Für Entwickler
E.164-Nummer eines Adressfeldes, unabhängig vom Speicherformat:
Dfphoneintl::getE164($idAddress, 'phone_mobile'); // '+33199001234' oder ''
Verwendete Hooks: actionFrontControllerSetMedia, actionValidateCustomerAddressForm, actionObjectAddressAddBefore / UpdateBefore / AddAfter / UpdateAfter / DeleteAfter, actionObjectCustomerDeleteAfter, actionCustomerAddressFormBuilderModifier, actionAdminControllerSetMedia, actionEmailSendBefore, actionDeleteGDPRCustomer, actionExportGDPRData.
Personenbezogene Daten und Leistung
- Keine Telefonnummer wird in die PrestaShop-Protokolle geschrieben.
- Die Modultabelle wird mit der Adresse, mit dem Kunden und durch das offizielle DSGVO-Modul gelöscht.
- Die Dateien werden nur auf Seiten mit Adressformular und auf den Adressseiten des Backoffice geladen. Komprimierte Größe (gzip): Bibliothek 35,6 KB, Skript 9,5 KB, CSS 1,9 KB, Flaggen 44,5 KB einmalig geladen.
Fehlerbehebung
Die Auswahl erscheint nicht
- Prüfen Sie, ob das Modul aktiviert und das Feld unter Einstellungen angehakt ist.
- Das Mobilfeld erscheint nur, wenn das Adressformat des Landes
phone_mobileenthält (International > Länder & Zonen > Länder). - Wenn Ihr Shop CSS und JS bündelt (CCC), leeren Sie nach einem Update den Cache unter Erweiterte Einstellungen > Leistung.
Eine Nummer wird abgelehnt
Öffnen Sie die Live-Vorschau mit demselben Land und Feld: Der genaue Grund wird angezeigt. Manche für Film und Fernsehen reservierte oder noch nicht zugeteilte Bereiche fehlen in den Nummerierungsdaten und werden bei strenger Prüfung abgelehnt.
Deinstallation
Die Deinstallation löscht die Einstellungen, den Normalisierungsverlauf und dessen Sicherungen. Die in den Adressen gespeicherten Nummern bleiben unverändert.
Lizenzen Dritter
Das Modul enthält libphonenumber-js 1.13.15 (MIT), giggsey/libphonenumber-for-php 8.13.55 (Apache-2.0), die Google-libphonenumber-Daten v9.0.41 (Apache-2.0) und country-flag-icons 1.6.20 (MIT). Die vollständigen Texte stehen in THIRD_PARTY_LICENSES.md im Stammverzeichnis des Moduls.
Support
E-Mail-Support und Updates 12 Monate inklusive. 14 Tage Geld-zurück-Garantie auf alle DataFirefly-Module.