Prefijo Telefónico Internacional (dfphoneintl)
Instalación, ajustes, validación libphonenumber, formatos de guardado y normalización de los números existentes del módulo de prefijo telefónico internacional para PrestaShop 1.7.8 a 9.
Presentación
DataFirefly International Phone Input (dfphoneintl) añade un selector de país con bandera delante de los campos Teléfono y Teléfono móvil de las direcciones de PrestaShop. El número se formatea mientras se escribe, se comprueba con los datos de numeración de Google libphonenumber y se guarda en el formato que elija.
Novedades de la 2.0.0: validación con los datos de Google libphonenumber (navegador y servidor), banderas SVG locales, combobox accesible con el teclado, formato de guardado a elegir (E.164, internacional legible, nacional), control del tipo móvil, herramienta de normalización de los números existentes con copia de seguridad y deshacer, selector en el back office, 8 idiomas y compatibilidad con PrestaShop 1.7.8.
Requisitos
- PrestaShop 1.7.8 a 9.x (probado en 1.7.8.11, 8.2.1 y 9.1.5).
- PHP 7.1 o superior (probado en PHP 7.4, 8.1 y 8.5).
- Tema Classic, Hummingbird o un tema que conserve los nombres de campo
phone,phone_mobileeid_country. - Ningún servicio externo: los datos, las banderas y los scripts los sirve su tienda, sin CDN.
Instalación y actualización
- Descargue
dfphoneintl-2.0.0.zipdesde su cuenta DataFirefly. - En Módulos > Gestor de módulos, haga clic en Subir un módulo y suelte el zip.
- Abra Configurar: la página se abre en el resumen.
Desde la 1.0.0, suba el zip 2.0.0 sobre el módulo anterior. La actualización conserva sus ajustes (campos activados, países preferidos convertidos en favoritos) y el comportamiento de la 1.0.0: guardado en E.164 y validación flexible. Los números ya guardados no se modifican: la pestaña Números existentes muestra primero una vista previa.
El selector para los clientes
El selector aparece en los formularios de dirección: Mi cuenta > Direcciones, paso de dirección del proceso de compra (cliente conectado o invitado) y checkout simplificado de DataFirefly. Las banderas son imágenes SVG, legibles en todos los sistemas, también en Windows.

La búsqueda abarca el nombre del país en el idioma del cliente, el nombre en inglés, el código ISO y el prefijo (+41), sin distinguir acentos. La lista funciona por completo con el teclado: flechas, Intro para elegir, Esc para cerrar.

Escritura y comprobación
El número se formatea mientras se escribe, sin que el cursor salte. Cuando el cliente sale del campo, el servidor comprueba el número con los datos completos (rangos asignados, móvil o fijo) y muestra el resultado bajo el campo.

Un número demasiado corto, demasiado largo, con un prefijo desconocido o un fijo en el campo móvil recibe un mensaje traducido con el formato esperado. Las cifras del ejemplo están ocultas: no se muestra ningún número real.

Un número pegado o escrito con +44 o 0044 cambia el selector al país correcto. Un número extranjero escrito en una dirección de otro país se muestra en formato internacional, para que el servidor siempre pueda leerlo.

Móvil y proceso de compra
En el móvil, la lista ocupa todo el ancho, las líneas miden al menos 44 px y se abre el teclado telefónico (type="tel", inputmode="tel", autocomplete="tel").

En el proceso de compra, el selector sigue el campo País hasta que el cliente elige un prefijo. Los formularios recargados por AJAX se gestionan sin doble inicialización. El tema Classic se comporta igual.

La página de configuración
El resumen muestra los campos cubiertos, el modo de validación, el formato de guardado y los países ofrecidos. Los puntos a revisar se listan con un enlace al ajuste correspondiente, por ejemplo un país cuyo formato de dirección no contiene el campo móvil.

Campos y validación
- Teléfono y Teléfono móvil: se activan por separado.
- El campo móvil solo acepta móviles: un fijo se rechaza. Se aceptan los países que no distinguen móviles y fijos (Estados Unidos, Canadá…).
- Móvil obligatorio: formularios de la tienda, para los países cuyo formato de dirección muestra el campo móvil.
- Validación estricta (recomendada): un número que no existe en el plan de numeración de su país se rechaza con un mensaje. Flexible: se muestra un aviso, pero se puede guardar.
- Comprobación en el servidor cuando el cliente sale del campo. No se guarda ni se registra nada.

Formato de guardado
Elija el valor escrito en la dirección, el que leen sus transportistas, etiquetas, exportaciones, ERP y módulos SMS:
- E.164:
+33199001234, el formato de las pasarelas SMS, WhatsApp y de la mayoría de las API; - Internacional legible:
+33 1 99 00 12 34; - Nacional:
01 99 00 12 34. Un número de otro país que la dirección se queda en internacional; si no, no se podría devolver la llamada.
El módulo conserva también, en su propia tabla, el número E.164 y lo que escribió el cliente. Se puede elegir otro formato para mostrar el número en los e-mails de pedido, sin modificar la dirección. Las facturas PDF muestran el formato de guardado.

Países ofrecidos y país por defecto
Ofrezca todos los países (un cliente puede dar un número de otro país que la dirección de entrega), solo los países activos de la tienda o una lista. Los favoritos se muestran primero, en el orden que defina. El país del selector se determina así:
- el país de la dirección;
- para una dirección nueva y si la opción está activada, el país del visitante (geolocalización de PrestaShop o, si no, idioma del navegador);
- el país por defecto de la tienda.
Vista previa interactiva
La pestaña Vista previa interactiva usa el mismo selector y la misma comprobación en el servidor que sus clientes. Elija el país de la dirección y el campo, escriba un número o haga clic en un ejemplo ficticio: verá el tipo, los tres formatos, el valor guardado y el mensaje, si lo hay.


Normalizar los números existentes
La pestaña Números existentes reescribe los números ya guardados en el formato de guardado:
- Filtre si es necesario (e-mail del cliente, países, campos, direcciones eliminadas) y haga clic en Analizar. El análisis es de solo lectura.
- El informe cuenta los números ya correctos, por reescribir y no válidos, con una vista previa antes / después.
- Reescribir estos números guarda una copia de cada valor antes de modificarlo. Los números no válidos nunca se reescriben. La fecha de modificación de las direcciones solo se actualiza si lo pide.

Cada operación aparece en el historial. Su copia de seguridad se descarga en CSV y la operación se puede deshacer: un número modificado después por el cliente se conserva.

Lance primero el análisis sobre una muestra (filtro por e-mail o por país) y descargue la copia CSV antes de una reescritura completa.
Back office y otros canales
El selector y la misma validación se aplican al formulario Clientes > Direcciones del back office (PrestaShop 1.7.8 a 9), a la dirección editada desde un pedido y al creador de pedidos de DataFirefly.

Las direcciones guardadas por el webservice, las importaciones CSV u otros módulos también pasan por el módulo mientras está activado: un número válido se escribe en el formato de guardado, un número no válido se deja como está.
Compatibilidad
- Temas Classic y Hummingbird, proceso de compra nativo, invitado, cambio de país dinámico.
- Checkout simplificado y Address Lookup de DataFirefly: un solo selector por campo, sin cambiar sus ajustes.
- Creador de pedidos de DataFirefly: selector en sus campos de teléfono.
- Un campo se puede excluir del selector con el atributo
data-dfpi-offen uno de sus elementos padre.
Para desarrolladores
Número E.164 de un campo de dirección, sea cual sea el formato de guardado:
Dfphoneintl::getE164($idAddress, 'phone_mobile'); // '+33199001234' o ''
Hooks utilizados: actionFrontControllerSetMedia, actionValidateCustomerAddressForm, actionObjectAddressAddBefore / UpdateBefore / AddAfter / UpdateAfter / DeleteAfter, actionObjectCustomerDeleteAfter, actionCustomerAddressFormBuilderModifier, actionAdminControllerSetMedia, actionEmailSendBefore, actionDeleteGDPRCustomer, actionExportGDPRData.
Datos personales y rendimiento
- No se escribe ningún número de teléfono en los registros de PrestaShop.
- La tabla del módulo se borra con la dirección, con el cliente y mediante el módulo RGPD oficial.
- Los archivos solo se cargan en las páginas con un formulario de dirección y en las páginas de direcciones del back office. Tamaño comprimido (gzip): biblioteca 35,6 KB, script 9,5 KB, CSS 1,9 KB, banderas 44,5 KB cargadas una vez.
Solución de problemas
El selector no aparece
- Compruebe que el módulo está activado y que el campo está marcado en Ajustes.
- El campo móvil solo aparece si el formato de dirección del país contiene
phone_mobile(Internacional > Zonas geográficas > Países). - Si su tienda combina CSS y JS (CCC), vacíe la caché en Parámetros avanzados > Rendimiento después de una actualización.
Se rechaza un número
Abra la Vista previa interactiva con el mismo país y el mismo campo: se muestra el motivo exacto. Algunos rangos reservados a la ficción o aún no asignados no figuran en los datos de numeración y por eso se rechazan en validación estricta.
Desinstalación
La desinstalación borra los ajustes, el historial de normalización y sus copias de seguridad. Los números guardados en las direcciones no cambian.
Licencias de terceros
El módulo incluye libphonenumber-js 1.13.15 (MIT), giggsey/libphonenumber-for-php 8.13.55 (Apache-2.0), los datos Google libphonenumber v9.0.41 (Apache-2.0) y country-flag-icons 1.6.20 (MIT). Los textos completos están en THIRD_PARTY_LICENSES.md, en la raíz del módulo.
Soporte
Soporte por e-mail y actualizaciones incluidos durante 12 meses. Garantía de devolución de 14 días en todos los módulos DataFirefly.