PrestaShop Checkout e Pagamento

Prefisso Telefono Internazionale PrestaShop — Bandiere & Normalizzazione E.164

Un selettore di prefisso con bandiera sui campi telefono, sincronizzato in tempo reale con il paese dell'indirizzo, e una normalizzazione E.164 garantita in database. Mai più numeri mal formattati nei tuoi ordini.

Numeri di telefono puliti, dal form al database

PrestaShop 8 PrestaShop 9 Multilingua Multinegozio E.164 Zero dipendenze
  • Rimborso 30 giorni
  • 12 mesi di aggiornamenti
  • Supporto 24h
www.datafirefly.com/it/
Indicatif Téléphone International PrestaShop — Drapeaux & Normalisation E.164
v1.0.0 · aggiornato 2026-05-15
Cosa fa

L' versione breve.

01

Selettore di prefisso con bandiera

Tutti i paesi attivati nel negozio sono disponibili, con il loro prefisso e la loro bandiera emoji. Ricerca istantanea nella lista, paesi preferiti fissati in cima.

02

Sincronizzazione automatica con il paese dell'indirizzo

Quando il cliente seleziona Italia nel form, il prefisso passa automaticamente a +39. Il selettore resta sincronizzato in checkout e in account cliente, anche con ricarica AJAX.

03

Normalizzazione E.164 in database, garantita

Qualunque sia il formato inserito dal cliente (333 12 34 567, 3331234567, +39 333 12 34 567, 0039...), il valore archiviato in database è sempre nel formato internazionale +393331234567 senza spazi né separatori.

04

Doppio strato: frontend e server

La normalizzazione avviene lato browser per l'UX, ma anche lato server negli hook actionObjectAddressAddBefore e actionObjectAddressUpdateBefore. Nessuna via di aggiramento, nemmeno tramite API o import CSV.

La versione lunga

Tutto quello che vorresti sapere prima di installare.

Uno sguardo dettagliato su come funziona Prefisso Telefono Internazionale PrestaShop — Bandiere & Normalizzazione E.164, perché l'abbiamo progettato così, e il ragionamento dietro le funzionalità qui sopra.

§ 01

Il problema: numeri di telefono illeggibili, incomparabili, incontattabili

Su un negozio multi-paese, i numeri di telefono arrivano in database in tutti i formati immaginabili: 333 12 34 567, 3331234567, +39 333 12 34 567, 0039 333 12 34 567, 39-333-1234-567. Conseguenza: impossibile rilevare i clienti duplicati, gli export verso un CRM o un ERP devono essere puliti manualmente, i servizi di SMS transazionale rifiutano un numero su tre, e i team commerciali perdono tempo a riformattare prima di ogni chiamata internazionale.

§ 02

La soluzione: un formato unico, una UX chiara, una garanzia server

Il modulo aggiunge un selettore di prefisso con bandiera direttamente sui campi telefono e telefono mobile, ovunque appaiano: form di registrazione, gestione indirizzi, checkout in 5 step o one-page. Il cliente vede immediatamente quale prefisso è applicato, può cambiarlo in due clic, e la lista si filtra tramite ricerca istantanea. Lato database, indipendentemente da ciò che il cliente digita, recuperi sempre un formato pulito, normalizzato, immediatamente sfruttabile.

§ 03

Sincronizzazione automatica con il paese di consegna

Quando il cliente seleziona il suo paese nel form di indirizzo, il prefisso del selettore telefono cambia automaticamente. Selezionare Belgio passa a +32, selezionare Germania passa a +49, senza intervento manuale. Questa sincronizzazione funziona anche sulle ricariche AJAX del checkout PrestaShop nativo (evento updatedAddressForm). Per i temi molto personalizzati, un MutationObserver con debounce funge da rete di sicurezza.

§ 04

Normalizzazione E.164 garantita lato server

La normalizzazione lato browser protegge l'UX, ma non basta. Se un ordine viene creato tramite l'API REST PrestaShop, tramite il back-office, tramite un import CSV, o tramite un altro modulo che manipola la classe Address, il form JS non viene mai eseguito. Per questo il modulo collega anche gli hook actionObjectAddressAddBefore e actionObjectAddressUpdateBefore: prima di ogni INSERT o UPDATE sulla tabella ps_address, i campi phone e phone_mobile passano per la normalizzazione lato server. Nessuna via di aggiramento possibile.

§ 05

Regole di normalizzazione applicate

Per un indirizzo collegato a un paese il cui prefisso è +39: un numero che inizia con + viene conservato così com'è (vengono rimossi solo gli spazi e i separatori). Un numero che inizia con 00 vede il 00 sostituito da +. Un numero che inizia con 0 (trunk prefix nazionale) vede lo 0 rimosso e sostituito da + seguito dal prefisso del paese. Un numero che inizia già con il prefisso senza il + vede semplicemente il + aggiunto. Queste regole sono conformi allo standard E.164 internazionale utilizzato da tutti gli operatori telecom e i servizi SMS professionali.

§ 06

Paesi preferiti e UX del selettore

Di default, i paesi Italia, Francia, Spagna, Germania, Regno Unito, Stati Uniti, Belgio, Svizzera, Paesi Bassi e Lussemburgo sono fissati in cima alla lista. Questa lista è interamente configurabile dal back-office (codici ISO separati da virgola). Gli altri paesi appaiono sotto, ordinati alfabeticamente. Una barra di ricerca permette di trovare istantaneamente un paese per nome, codice ISO o prefisso. Tutta la lista è costruita a partire dai paesi attivati nel tuo negozio, letta direttamente dalla colonna ps_country.call_prefix nativa.

§ 07

Zero dipendenze, bandiere Unicode native

Il modulo non integra alcuna libreria esterna. Niente intl-tel-input da mantenere, niente plugin jQuery, niente framework CSS pesante. Le bandiere sono emoji Unicode (Regional Indicator Symbols) supportate nativamente da tutti i browser e OS moderni. Il foglio di stile fa meno di 4 KB, lo script meno di 16 KB. Nessuna chiamata di rete aggiuntiva, nessun CDN esterno, nessuna fuga di dati verso terzi.