Risolvere i Problemi Comuni di WPForms: Troubleshooting
WPForms è uno dei plugin più affidabili per WordPress, ma come ogni software, può occasionalmente presentare problemi. La buona notizia è che la maggior parte dei problemi ha cause comuni e soluzioni ben documentate. In questa guida di troubleshooting analizzeremo i problemi più frequenti che gli utenti incontrano con WPForms e ti forniremo le soluzioni passo per passo per risolverli rapidamente.
Problema 1: Le Email di Notifica Non Arrivano
Questo è in assoluto il problema più segnalato dagli utenti WPForms. Il form viene compilato e inviato correttamente, il messaggio di conferma appare, ma l’email di notifica non arriva nella casella di posta dell’amministratore. Le cause possono essere molteplici.
Causa Principale: Configurazione del Server di Posta
WPForms utilizza la funzione nativa wp_mail() di WordPress per inviare le email. Questa funzione si appoggia alla configurazione PHP del server, che su molti hosting condivisi è insufficiente o mal configurata. Le email inviate tramite mail() di PHP hanno un’alta probabilità di finire nello spam o di non essere consegnate affatto, perché mancano le autenticazioni SPF e DKIM.
Soluzione: Installare WP Mail SMTP
La soluzione più efficace è installare il plugin WP Mail SMTP (dello stesso sviluppatore di WPForms) e configurare l’invio email tramite un servizio SMTP professionale. Ecco i passaggi:
- Installa e attiva WP Mail SMTP dalla directory plugin di WordPress
- Segui il wizard di configurazione
- Scegli un provider SMTP (Brevo, Gmail, Amazon SES, SMTP.com, o il tuo server SMTP)
- Inserisci le credenziali del provider
- Invia un’email di test per verificare il funzionamento
Altre Verifiche
- Controlla la cartella spam: le email potrebbero essere state consegnate ma classificate come spam dal provider del destinatario
- Verifica l’indirizzo destinatario: assicurati che l’email nelle impostazioni di notifica sia corretta
- Controlla il campo From Email: deve essere un indirizzo del tuo dominio (es.
info@tuosito.it), non un indirizzo Gmail o Hotmail - Verifica i record DNS: assicurati che il tuo dominio abbia record SPF e DKIM configurati correttamente
- Controlla i log di WP Mail SMTP: se hai installato il plugin, la sezione log ti mostra lo stato di ogni email inviata
Problema 2: Il Form Non Viene Visualizzato
Hai inserito il modulo in una pagina ma non appare, oppure appare solo lo shortcode come testo. Questo problema può avere diverse cause.
Lo Shortcode Viene Mostrato come Testo
Se vedi il testo [wpforms id="123"] sulla pagina invece del modulo, significa che WordPress non sta processando lo shortcode. Le cause più comuni sono:
- Plugin WPForms disattivato: verifica che WPForms sia attivo nel pannello Plugin
- Shortcode nel posto sbagliato: se usi Elementor o un altro page builder, lo shortcode deve essere inserito in un widget apposito (Shortcode o HTML)
- Cache del browser: prova a svuotare la cache del browser o aprire la pagina in navigazione privata
- Cache del sito: se usi un plugin di cache (WP Rocket, W3 Total Cache), svuota la cache del sito
Il Form Non Appare Affatto
Se la pagina non mostra nulla dove dovrebbe esserci il form (nemmeno lo shortcode), verifica:
- Il modulo esiste: vai su WPForms → Tutti i form e verifica che il modulo con l’ID indicato nello shortcode esista
- Conflitto JavaScript: apri la console del browser (F12 → Console) e cerca errori JavaScript che potrebbero impedire il rendering del form
- Conflitto con altri plugin: disattiva temporaneamente gli altri plugin per verificare se c’è un conflitto
Problema 3: Il Form Non Invia (Pagina si Ricarica Senza Effetto)
L’utente clicca il pulsante di invio ma non succede nulla, oppure la pagina si ricarica ma il form appare ancora vuoto senza messaggio di conferma.
Cause e Soluzioni
Errore JavaScript: la causa più comune è un conflitto JavaScript con un altro plugin o con il tema. Apri la console del browser e cerca errori rossi. Se trovi errori riferiti a jQuery, AJAX o script di terze parti, il colpevole è probabilmente un altro plugin.
Validazione silenziosa: potrebbe esserci un campo obbligatorio non compilato che non mostra il messaggio di errore. Questo può succedere se il campo è nascosto dalla logica condizionale ma non è configurato correttamente. Verifica le regole di logica condizionale e assicurati che i campi obbligatori nascosti siano gestiti correttamente.
Errore AJAX: WPForms può inviare i form in modalità AJAX (senza ricaricare la pagina) o in modalità tradizionale (con ricaricamento). Se l’invio AJAX fallisce, prova a disabilitarlo temporaneamente. Vai nelle impostazioni generali del form e disabilita l’opzione Abilita invio AJAX del modulo.
Limite PHP: form molto grandi con molti campi o file upload possono superare i limiti PHP del server (max_input_vars, post_max_size, max_execution_time). Verifica i log di errore PHP del server per messaggi correlati.
Problema 4: reCAPTCHA Non Funziona
Il reCAPTCHA mostra un errore, non viene visualizzato o blocca tutti gli invii. Questo problema è solitamente legato alla configurazione delle chiavi API.
Soluzioni
- Chiavi API errate: verifica che la Site Key e la Secret Key siano corrette e corrispondano alla versione di reCAPTCHA selezionata (v2 Checkbox, v2 Invisible o v3). Le chiavi di una versione non funzionano con le altre
- Dominio non registrato: nella console di Google reCAPTCHA, assicurati che il dominio del tuo sito sia nell’elenco dei domini autorizzati. Includi sia
tuosito.itchewww.tuosito.it - reCAPTCHA v3 troppo restrittivo: se usi la v3, il punteggio soglia potrebbe essere troppo alto e bloccare utenti legittimi. Abbassa la soglia a 0.4 o 0.3 nelle impostazioni di WPForms
- Conflitto con altri reCAPTCHA: se un altro plugin carica reCAPTCHA sulla stessa pagina (ad esempio il form di login), i due possono confliggere. Assicurati che solo un plugin gestisca reCAPTCHA per pagina
- Cache aggressiva: plugin di cache che memorizzano la pagina HTML possono causare problemi con i token reCAPTCHA scaduti. Escluci le pagine con form dalla cache o usa la cache solo per risorse statiche
Problema 5: Layout del Form Rotto o Disallineato
Il form appare con campi disallineati, sovrapposizioni, testo fuori posto o elementi visivamente rotti.
Cause Comuni
Conflitto CSS con il tema: il CSS del tema può sovrascrivere gli stili di WPForms. Questo è particolarmente comune con temi che applicano stili globali aggressivi a tutti gli input, select e button.
Plugin CSS che interferiscono: plugin come Autoptimize o plugin di minificazione CSS possono alterare o rimuovere gli stili di WPForms.
Markup moderno vs legacy: WPForms offre due tipi di markup. Se hai aggiornato WPForms e il layout si è rotto, prova a passare dal markup moderno a quello legacy (o viceversa) nelle impostazioni generali di WPForms.
Come Diagnosticare
- Cambia temporaneamente il tema a un tema predefinito di WordPress (Twenty Twenty-Four) per verificare se il problema è legato al tema
- Disattiva i plugin di ottimizzazione CSS uno alla volta
- Usa gli strumenti di sviluppo del browser per ispezionare gli elementi problematici e identificare le regole CSS in conflitto
Problema 6: Upload File Fallisce
Gli utenti non riescono a caricare file o ricevono errori durante il caricamento.
Soluzioni
- Dimensione del file: il file potrebbe superare il limite di upload del server PHP. Verifica i valori di
upload_max_filesizeepost_max_sizenella configurazione PHP (puoi controllarli dalla sezione Strumenti → Salute del Sito → Info → Server) - Tipo di file non consentito: il file potrebbe avere un’estensione non inclusa nella lista dei tipi consentiti. Verifica le impostazioni del campo Upload nel form builder
- Permessi della cartella: la cartella
wp-content/uploads/wpforms/potrebbe non avere i permessi di scrittura. I permessi corretti sono 755 per le cartelle e 644 per i file - Spazio disco esaurito: il server potrebbe aver esaurito lo spazio disco. Verifica lo spazio disponibile dal pannello hosting
- Filtro WordPress: WordPress ha una lista interna di tipi MIME consentiti. Se il tipo di file non è nella lista, WordPress lo blocca. Puoi estendere la lista con un filtro PHP
upload_mimes
Problema 7: Entries Non Vengono Salvate
Le email di notifica arrivano ma le risposte non appaiono nella sezione Entries di WPForms.
Soluzioni
- Versione Lite: la versione gratuita di WPForms non salva le entries nel database. Questa funzionalità è disponibile solo nella versione Pro
- Archiviazione entries disabilitata: nelle impostazioni del form, verifica che l’opzione Disabilita archiviazione entries non sia attiva
- Problemi database: le tabelle del database di WPForms potrebbero essere corrotte. Usa phpMyAdmin per verificare e riparare le tabelle con prefisso
wpforms_ - Plugin di sicurezza: alcuni plugin di sicurezza possono bloccare le query di inserimento nel database. Disattiva temporaneamente il plugin di sicurezza per verificare
Problema 8: Conflitti con Plugin di Cache
I plugin di cache possono causare diversi problemi con WPForms: token CSRF scaduti che impediscono l’invio, reCAPTCHA non funzionante, conferme che non vengono mostrate.
Soluzioni
- Escludi le pagine con form dalla cache: la maggior parte dei plugin di cache permette di escludere specifiche pagine. Aggiungi le URL delle pagine che contengono moduli alla lista di esclusione
- Non cachare le richieste POST: assicurati che il plugin di cache non memorizzi le risposte alle richieste POST (la maggior parte lo fa di default, ma vale la pena verificare)
- Escludi i cookie WPForms: se il plugin di cache utilizza i cookie per determinare se servire la pagina dalla cache, aggiungi i cookie di WPForms alla lista di esclusione
- Svuota la cache dopo le modifiche: ogni volta che modifichi un form, svuota la cache del sito per assicurarti che le modifiche siano visibili
Problema 9: Errore 403 o 500 all’Invio del Form
L’utente vede un errore HTTP 403 (Forbidden) o 500 (Internal Server Error) dopo aver cliccato il pulsante di invio.
Errore 403
Solitamente causato da un firewall o un plugin di sicurezza che blocca la richiesta POST. Moduli con certe parole chiave, link nel messaggio o pattern che il firewall interpreta come malevoli possono essere bloccati. Soluzioni:
- Verifica i log del firewall del server (ModSecurity, Imunify360, etc.)
- Escludi l’URL della pagina del form dalle regole del firewall
- Verifica le impostazioni del plugin di sicurezza WordPress (Wordfence, iThemes Security, etc.)
Errore 500
Indica un errore lato server. Le cause comuni sono:
- Memoria PHP insufficiente: aumenta il
memory_limitPHP a 256 MB o più - Tempo di esecuzione superato: per form con upload o elaborazioni pesanti, aumenta
max_execution_time - Errore nel codice: controlla il file
wp-content/debug.log(attiva WP_DEBUG e WP_DEBUG_LOG in wp-config.php per generare i log)
Procedura di Diagnostica Generale
Quando riscontri un problema che non rientra nei casi specifici descritti sopra, segui questa procedura sistematica di diagnostica:
- Aggiorna tutto: assicurati che WordPress, WPForms e tutti i plugin siano aggiornati all’ultima versione
- Svuota tutte le cache: browser, plugin di cache, CDN
- Controlla i log di errore: sia i log PHP del server che il debug.log di WordPress
- Testa con il tema predefinito: cambia temporaneamente a Twenty Twenty-Four per escludere conflitti con il tema
- Disattiva gli altri plugin: disattiva tutti i plugin eccetto WPForms e riattivali uno alla volta per identificare il conflitto
- Controlla la console del browser: errori JavaScript possono indicare conflitti di script
- Verifica le risorse del server: spazio disco, memoria, limiti PHP
- Contatta il supporto: se hai la versione Pro, il supporto WPForms può aiutarti direttamente con ticket dedicati
La maggior parte dei problemi si risolve seguendo i primi tre passaggi. I problemi persistenti sono quasi sempre conflitti con altri plugin o configurazioni errate del server.
Se non riesci a risolvere un problema con WPForms o hai bisogno di assistenza tecnica specializzata per il tuo sito WordPress, contatta il nostro team. Possiamo diagnosticare e risolvere qualsiasi problema tecnico.
Migliora il Tuo Sito WordPress
Scopri le nostre guide complete sugli altri plugin essenziali per WordPress: