MAGENTO 2 · CHECKOUT · INDIRIZZO · DIAGNOSTICA
Kowal Checkout Address Validation
Controlla la sintassi dell'e-mail, il formato di telefono e codice postale e mostra avvisi NIP/VAT. Separa la validazione bloccante del frontend dalla diagnostica backend log-only.
Regole per paese · Avvisi NIP/VAT · Log senza dati completi
COME FUNZIONA IN PRATICA
01 · Attivi i meccanismi appropriati
Configuri frontend e log-only separatamente.
02 · Il cliente completa l'indirizzo
I messaggi indicano il formato non valido del campo.
03 · Analizzi la diagnostica
Il backend registra le violazioni senza bloccare le vendite.
Scopri le funzioni, l'utilizzo e le impostazioni del modulo.
Magento 2 Checkout Address Validation riduce gli errori nei dati inseriti durante l'ordine. Controlla e-mail, telefono, codice postale e NIP/VAT, fornendo al cliente un messaggio chiaro prima che i dati errati vengano usati per l'evasione.
Questo significa meno correzioni manuali per assistenza clienti, logistica e contabilità e minore rischio di problemi con spedizioni e documenti di vendita.
Controllo della sintassi dell'e-mail e del semplice formato telefonico con segno + facoltativo.
Regole per paese per Polonia, Germania, Repubblica Ceca, Slovacchia e USA.
Avvisi non bloccanti, regole per paese e controllo della cifra di verifica del NIP polacco.
Il frontend può fermare valori chiaramente errati e indicare il campo da correggere. La diagnostica backend opera in modalità log-only, quindi il rilevamento di un problema non dovrebbe bloccare checkout, API o salvataggio dell'indirizzo.
Il modulo blocca un codice postale errato?
La validazione frontend può bloccare il passaggio successivo e indicare al cliente i dati da correggere.
Quali paesi hanno regole per i codici postali?
Polonia, Germania, Repubblica Ceca, Slovacchia e USA.
Controlla il NIP polacco?
Sì, compresa la cifra di verifica; i messaggi NIP/VAT sono non bloccanti.
Il backend può bloccare l'ordine?
La diagnostica backend opera in modalità log-only per non interrompere le vendite.
Stores → Configuration → Sales → Checkout → Checkout Address Validation offre Enable Frontend Validation ed Enable Backend Log-Only Diagnostics. Entrambi i meccanismi sono attivi per impostazione predefinita.
Il frontend controlla il modulo standard dell'indirizzo di spedizione, compresa l'e-mail dell'ospite. Il backend registra le violazioni a fini diagnostici senza rifiutare per questo checkout, API o salvataggio dell'indirizzo.
Il telefono può contenere cifre e un + facoltativo all'inizio. I codici postali vengono controllati secondo la configurazione dei paesi PL, DE, CZ, SK e US; la validazione rifiuta gli spazi bianchi.
NIP/VAT riceve avvisi su formato, prefisso e, per il NIP polacco, cifra di verifica. Il modulo non conferma l'esistenza dell'indirizzo, il funzionamento della casella e-mail, il numero telefonico o la registrazione fiscale in registri esterni.
Il log backend comprende nome del campo, regola violata, paese, lunghezza del valore, Store ID e identificatore del carrello sottoposto a hash. Questi record diagnostici non contengono i valori completi del cliente.
L'integrazione frontend usa i componenti del checkout standard Magento e RequireJS. Con Hyvä o checkout alternativi verifica il collegamento delle regole; il pacchetto non contiene un adattatore Hyvä dedicato.
Il pacchetto kowal/module-checkout-validation, modulo Kowal_CheckoutValidation. Dopo aver configurato l'accesso al repository Kowal, installa il pacchetto, abilita il modulo, aggiorna Magento e svuota la cache. In produzione, includi compilazione e deploy dei contenuti statici secondo il processo del negozio.
1. Attivi i meccanismi appropriati
Configuri frontend e log-only separatamente.
2. Il cliente completa l'indirizzo
I messaggi indicano il formato non valido del campo.
3. Analizzi la diagnostica
Il backend registra le violazioni senza bloccare le vendite.
Il cliente inserisce un'e-mail con uno spazio oppure un telefono con caratteri non consentiti. Il checkout indica il campo da correggere.
L'avviso NIP/VAT rimane non bloccante. Il backend permette di analizzare i problemi di formato senza interrompere il salvataggio dell'indirizzo e il processo d'ordine.
Vuoi adattare il modulo al tuo negozio? Richiedi l'implementazione di Kowal Checkout Address Validation e discuti la configurazione o le estensioni necessarie.
| Conformità al modello | Luma / Vuoto, Fabbro |
|---|
I dati di accesso al repository Composer, ovvero l indirizzo e-mail del cliente e il token di licenza, saranno inviati via e-mail dopo l acquisto. Sono disponibili anche nel pannello cliente dopo l accesso su kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di Magento.
composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-checkout-validationDopo aver installato il pacchetto, esegui l'aggiornamento di Magento e svuota la cache:
php bin/magento setup:upgrade
php bin/magento cache:flushIn ambiente di produzione, esegui anche la compilazione DI e il deployment dei file statici secondo il processo di deployment del negozio.
