PS PrestaShop Principiante

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.

Actualizado Versión del módulo 2.0.0

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_mobile e id_country.
  • Ningún servicio externo: los datos, las banderas y los scripts los sirve su tienda, sin CDN.

Instalación y actualización

  1. Descargue dfphoneintl-2.0.0.zip desde su cuenta DataFirefly.
  2. En Módulos > Gestor de módulos, haga clic en Subir un módulo y suelte el zip.
  3. 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.

Selector de país abierto delante del campo Teléfono: banderas SVG, prefijos y países favoritos primero
Selector de país del teléfono

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.

Búsqueda de un país por su nombre en el idioma del cliente, sin distinguir acentos
Búsqueda de país

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.

Número formateado durante la escritura y confirmado por la comprobación del servidor: válido, con su tipo
Número válido comprobado por el servidor

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.

Número demasiado corto: mensaje traducido bajo el campo con el formato esperado, cifras ocultas
Error: número demasiado corto

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.

Número internacional pegado: el selector cambia solo al país correcto
Número internacional pegado

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 móvil: lista a todo el ancho, zonas táctiles amplias y teclado telefónico
Selector en el móvil

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.

Proceso de compra Hummingbird como invitado: paso de dirección con el selector y el número comprobado
Proceso de compra Hummingbird

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.

Resumen del módulo: campos cubiertos, validación, formato de guardado y puntos a revisar
Resumen del módulo

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.
Ajustes de campos y validación: estricta o flexible, solo móviles, comprobación en el servidor
Ajustes de campos y validación

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.

Formato de guardado a elegir (E.164, internacional legible, nacional) y formato en los e-mails
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í:

  1. el país de la dirección;
  2. 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);
  3. 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.

Vista previa interactiva: número británico en una dirección francesa, leído, validado y guardado en E.164
Vista previa interactiva
Vista previa: un fijo escrito en Teléfono móvil se rechaza con un mensaje claro
Fijo rechazado en el campo móvil

Normalizar los números existentes

La pestaña Números existentes reescribe los números ya guardados en el formato de guardado:

  1. 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.
  2. El informe cuenta los números ya correctos, por reescribir y no válidos, con una vista previa antes / después.
  3. 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.
Informe de normalización de los números existentes: correctos, por reescribir, no válidos, antes / después
Informe de normalización

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.

Historial de normalizaciones: copia de seguridad CSV y deshacer una operación
Historial y deshacer

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.

Dirección en el back office: selector en Teléfono y Teléfono móvil, error y móvil australiano detectado
Dirección en el back office

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-off en 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.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte