Indicatif Téléphone International (dfphoneintl)
Installation, réglages, validation libphonenumber, formats d'enregistrement et normalisation des numéros existants du module d'indicatif téléphonique international pour PrestaShop 1.7.8 à 9.
Présentation
DataFirefly International Phone Input (dfphoneintl) ajoute un sélecteur de pays avec drapeau devant les champs Téléphone et Téléphone mobile des adresses PrestaShop. Le numéro est mis en forme pendant la saisie, vérifié avec les données de numérotation de Google libphonenumber, puis enregistré dans le format de votre choix.
Nouveautés de la 2.0.0 : validation par les données Google libphonenumber (navigateur et serveur), drapeaux SVG locaux, combobox accessible au clavier, choix du format d’enregistrement (E.164, international lisible, national), contrôle du type mobile, outil de normalisation des numéros existants avec sauvegarde et annulation, sélecteur dans le back-office, 8 langues et prise en charge de PrestaShop 1.7.8.
Prérequis
- PrestaShop 1.7.8 à 9.x (testé sur 1.7.8.11, 8.2.1 et 9.1.5).
- PHP 7.1 ou plus (testé en PHP 7.4, 8.1 et 8.5).
- Thème Classic, Hummingbird ou thème qui garde les noms de champs
phone,phone_mobileetid_country. - Aucun service externe : les données, les drapeaux et les scripts sont servis par votre boutique, sans CDN.
Installation et mise à jour
- Téléchargez
dfphoneintl-2.0.0.zipdepuis votre compte DataFirefly. - Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et déposez le zip.
- Ouvrez Configurer : la page s’ouvre sur la vue d’ensemble.
Depuis la 1.0.0, le zip 2.0.0 se dépose par-dessus l’ancien module. La mise à jour garde vos réglages (champs activés, pays préférés devenus favoris) et conserve le comportement de la 1.0.0 : enregistrement en E.164 et validation souple. Les numéros déjà enregistrés ne sont pas modifiés : l’onglet Numéros existants vous montre d’abord un aperçu.
Le sélecteur côté client
Le sélecteur apparaît sur les formulaires d’adresse : Mon compte > Adresses, étape adresse du tunnel de commande (client connecté ou invité) et checkout simplifié DataFirefly. Les drapeaux sont des images SVG, lisibles sur tous les systèmes, y compris Windows.

La recherche porte sur le nom du pays dans la langue du client, le nom anglais, le code ISO et l’indicatif (+41), sans tenir compte des accents. La liste se manipule entièrement au clavier : flèches, Entrée pour choisir, Échap pour fermer.

Saisie et vérification
Le numéro est mis en forme pendant la saisie, sans que le curseur ne saute. Quand le client quitte le champ, le serveur vérifie le numéro avec les données complètes (plages attribuées, mobile ou fixe) et affiche le résultat sous le champ.

Un numéro trop court, trop long, à l’indicatif inconnu ou fixe dans le champ mobile reçoit un message traduit, avec le format attendu. Les chiffres de l’exemple sont masqués (0• •• •• •• ••) : aucun vrai numéro n’est affiché.

Un numéro collé ou saisi avec +44 ou 0044 fait passer le sélecteur sur le bon pays. Un numéro étranger saisi sur une adresse française est affiché en format international, pour qu’il reste lisible par le serveur.

Mobile et tunnel de commande
Sur mobile, la liste occupe toute la largeur, les lignes font au moins 44 px et le clavier téléphonique s’ouvre (type="tel", inputmode="tel", autocomplete="tel").

Dans le tunnel de commande, le sélecteur suit le champ Pays tant que le client n’a pas choisi lui-même un indicatif. Les formulaires rechargés en AJAX sont pris en charge, sans double initialisation.


La page de configuration
La vue d’ensemble résume les champs couverts, le mode de validation, le format d’enregistrement et les pays proposés. Les points à vérifier sont listés avec un lien vers le réglage concerné, par exemple un pays dont le format d’adresse ne contient pas le champ mobile.

Champs et validation
- Téléphone et Téléphone mobile : activables séparément.
- Le champ mobile n’accepte que des mobiles : un fixe y est refusé. Les pays qui ne distinguent pas mobiles et fixes (États-Unis, Canada…) sont acceptés.
- Mobile obligatoire : formulaires du front-office, pour les pays dont le format d’adresse affiche le champ mobile.
- Validation stricte (recommandée) : un numéro qui n’existe pas dans le plan de numérotation de son pays est refusé avec un message. Souple : un avertissement s’affiche, mais l’enregistrement reste possible.
- Vérification serveur en direct quand le client quitte le champ. Rien n’est enregistré ni journalisé.

Format d’enregistrement
Choisissez la valeur écrite dans l’adresse, celle que lisent vos transporteurs, étiquettes, exports, ERP et modules SMS :
- E.164 :
+33199001234, le format des passerelles SMS, WhatsApp et de la plupart des API ; - International lisible :
+33 1 99 00 12 34; - National :
01 99 00 12 34. Un numéro d’un autre pays que l’adresse reste international, sinon il ne pourrait pas être rappelé.
Le module conserve aussi, dans sa propre table, le numéro E.164 et la saisie d’origine du client. Un format distinct peut être choisi pour l’affichage dans les e-mails de commande, sans modifier l’adresse. Les factures PDF affichent le format d’enregistrement.

Pays proposés et pays par défaut
Proposez tous les pays (le client peut donner un numéro d’un autre pays que l’adresse de livraison), seulement les pays actifs de la boutique ou une liste choisie. Les favoris s’affichent en tête, dans l’ordre que vous définissez. Le pays du sélecteur est déterminé ainsi :
- le pays de l’adresse ;
- pour une nouvelle adresse et si l’option est activée, le pays du visiteur (géolocalisation PrestaShop, sinon langue du navigateur) ;
- le pays par défaut de la boutique.
Aperçu interactif
L’onglet Aperçu interactif utilise le même sélecteur et la même vérification serveur que vos clients. Choisissez le pays de l’adresse et le champ, saisissez un numéro ou cliquez sur un exemple fictif : vous voyez le type, les trois formats, la valeur enregistrée et le message éventuel.


Normaliser les numéros existants
L’onglet Numéros existants réécrit les numéros déjà enregistrés au format d’enregistrement :
- Filtrez si besoin (e-mail du client, pays, champs, adresses supprimées), puis cliquez sur Analyser. L’analyse est en lecture seule.
- Le rapport compte les numéros déjà propres, à réécrire et non valides, avec un aperçu avant / après.
- Réécrire ces numéros sauvegarde chaque valeur avant de la modifier. Les numéros non valides ne sont jamais réécrits. La date de modification des adresses n’est mise à jour que si vous le demandez.

Chaque opération figure dans l’historique. Sa sauvegarde se télécharge en CSV et l’opération peut être annulée : un numéro modifié depuis par le client est conservé.

Lancez d’abord l’analyse sur un échantillon (filtre par e-mail ou par pays) et téléchargez la sauvegarde CSV avant une réécriture complète.
Back-office et autres canaux
Le sélecteur et la même validation s’appliquent au formulaire Clients > Adresses du back-office (PrestaShop 1.7.8 à 9), à l’adresse modifiée depuis une commande et au créateur de commande DataFirefly.

Les adresses enregistrées par le webservice, les imports CSV ou d’autres modules passent aussi par le module pendant qu’il est activé : un numéro valide est écrit au format d’enregistrement, un numéro non valide est laissé tel quel.
Compatibilité
- Thèmes Classic et Hummingbird, tunnel natif, invité, changement de pays dynamique.
- Checkout simplifié et Address Lookup DataFirefly : un seul sélecteur par champ, sans modifier leurs réglages.
- Créateur de commande DataFirefly : sélecteur sur ses champs téléphone.
- Un champ peut être exclu du sélecteur avec l’attribut
data-dfpi-offsur l’un de ses parents.
Pour les développeurs
Numéro E.164 d’un champ d’adresse, quel que soit le format d’enregistrement :
Dfphoneintl::getE164($idAddress, 'phone_mobile'); // '+33199001234' ou ''
Hooks utilisés : actionFrontControllerSetMedia, actionValidateCustomerAddressForm, actionObjectAddressAddBefore / UpdateBefore / AddAfter / UpdateAfter / DeleteAfter, actionObjectCustomerDeleteAfter, actionCustomerAddressFormBuilderModifier, actionAdminControllerSetMedia, actionEmailSendBefore, actionDeleteGDPRCustomer, actionExportGDPRData.
Données personnelles et performance
- Aucun numéro de téléphone n’est écrit dans les journaux PrestaShop.
- La table du module est effacée avec l’adresse, avec le client et par le module RGPD officiel.
- Les fichiers ne sont chargés que sur les pages avec un formulaire d’adresse et sur les pages d’adresse du back-office. Poids compressé (gzip) : bibliothèque 35,6 Ko, script 9,5 Ko, CSS 1,9 Ko, drapeaux 44,5 Ko chargés une fois.
Dépannage
Le sélecteur ne s’affiche pas
- Vérifiez que le module est activé et que le champ est coché dans Réglages.
- Le champ mobile n’apparaît que si le format d’adresse du pays contient
phone_mobile(International > Zones géographiques > Pays). - Si votre thème combine les CSS et JS (CCC), videz le cache dans Paramètres avancés > Performances après une mise à jour.
Un numéro est refusé
Ouvrez l’Aperçu interactif avec le même pays et le même champ : le motif exact s’affiche. Certaines plages réservées à la fiction ou pas encore attribuées n’existent pas dans les données de numérotation et sont donc refusées en validation stricte.
Désinstallation
La désinstallation supprime les réglages, l’historique de normalisation et ses sauvegardes. Les numéros enregistrés dans les adresses restent tels quels.
Licences tierces
Le module embarque libphonenumber-js 1.13.15 (MIT), giggsey/libphonenumber-for-php 8.13.55 (Apache-2.0), les données Google libphonenumber v9.0.41 (Apache-2.0) et country-flag-icons 1.6.20 (MIT). Les textes complets sont dans THIRD_PARTY_LICENSES.md, à la racine du module.
Support
Support par e-mail et mises à jour inclus pendant 12 mois. Garantie satisfait ou remboursé 14 jours sur tous les modules DataFirefly.