PS PrestaShop Anfänger

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.

Aktualisiert Modulversion 2.0.0

Ü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_mobile und id_country.
  • Kein externer Dienst: Daten, Flaggen und Skripte liefert Ihr Shop, ohne CDN.

Installation und Update

  1. Laden Sie dfphoneintl-2.0.0.zip aus Ihrem DataFirefly-Konto herunter.
  2. Klicken Sie unter Module > Modulverwaltung auf Modul hochladen und ziehen Sie das Zip hinein.
  3. Ö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.

Geöffnete Länderauswahl vor dem Feld Telefon: SVG-Flaggen, Vorwahlen und Favoriten zuerst
Länderauswahl für die Telefonnummer

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.

Suche nach einem Land über seinen Namen in der Sprache des Kunden, ohne Rücksicht auf Akzente
Ländersuche

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.

Nummer bei der Eingabe formatiert und von der Serverprüfung bestätigt: gültig, mit ihrem Typ
Gültige Nummer, vom Server geprüft

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.

Nummer zu kurz: übersetzte Meldung unter dem Feld mit dem erwarteten Format, Ziffern maskiert
Fehler: Nummer zu kurz

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.

Internationale Nummer eingefügt: die Auswahl wechselt automatisch zum richtigen Land
Eingefügte internationale Nummer

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").

Auf dem Smartphone: Liste in voller Breite, große Tippflächen und Telefontastatur
Auswahl auf dem Smartphone

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.

Hummingbird-Bestellvorgang als Gast: Adressschritt mit Auswahl und geprüfter Nummer
Hummingbird-Bestellvorgang

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.

Modulübersicht: abgedeckte Felder, Prüfung, Speicherformat und zu prüfende Punkte
Modulübersicht

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.
Einstellungen für Felder und Prüfung: streng oder tolerant, nur Mobilnummern, Serverprüfung
Einstellungen für Felder und Prüfung

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.

Wählbares Speicherformat (E.164, international lesbar, national) und Format in E-Mails
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:

  1. das Land der Adresse;
  2. bei einer neuen Adresse und aktivierter Option das Land des Besuchers (PrestaShop-Geolokalisierung, sonst Browsersprache);
  3. 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.

Live-Vorschau: britische Nummer an einer französischen Adresse, gelesen, geprüft und in E.164 gespeichert
Live-Vorschau
Vorschau: eine Festnetznummer im Feld Mobiltelefon wird mit klarer Meldung abgelehnt
Festnetz im Mobilfeld abgelehnt

Vorhandene Nummern normalisieren

Der Reiter Vorhandene Nummern schreibt bereits gespeicherte Nummern im Speicherformat neu:

  1. Filtern Sie bei Bedarf (E-Mail des Kunden, Länder, Felder, gelöschte Adressen) und klicken Sie auf Analysieren. Die Analyse ist schreibgeschützt.
  2. Der Bericht zählt bereits saubere, neu zu schreibende und ungültige Nummern, mit einer Vorher-/Nachher-Vorschau.
  3. 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.
Normalisierungsbericht der vorhandenen Nummern: sauber, neu zu schreiben, ungültig, Vorher / Nachher
Normalisierungsbericht

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.

Normalisierungsverlauf: CSV-Sicherung und Rückgängigmachen eines Vorgangs
Verlauf und Rückgängig

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.

Adresse im Backoffice: Auswahl bei Telefon und Mobiltelefon, Fehler und erkannte australische Mobilnummer
Adresse im Backoffice

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-off auf 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_mobile enthä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.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren