Contact Forms
Costruttore di moduli di contatto: incorpora moduli nelle pagine, conserva ogni invio e manda le e-mail tramite il provider del sito.
Estensione
Contact Forms
Costruttore di moduli di contatto: incorpora moduli nelle pagine, conserva ogni invio e manda le e-mail tramite il provider del sito.
Descrizione
Crea un modulo di contatto nell’amministrazione, inseriscilo in qualsiasi pagina con un blocco e leggi ogni invio nella posta in arrivo integrata. L’e-mail di notifica passa dal provider che il tuo sito usa già — il plugin non parla mai direttamente con un servizio di posta.
Demo dal vivo: emdashhq.com/contact — un modulo funzionante generato da questo plugin su un sito EmDash in produzione.
Cosa ottieni
- Moduli — crea e modifica moduli, gestisci i campi (text, email, tel, url, number, textarea, select, checkbox), riordinali, attiva o disattiva un modulo senza eliminarlo.
- Posta in arrivo degli invii — ogni voce è salvata nel database del tuo sito insieme alla pagina da cui proviene; filtra per modulo, stato o esito dell’e-mail; segna come letto o archivia; rinvia la notifica; copia come CSV.
- Registro e-mail — ogni tentativo di invio con stato, durata e messaggio di errore del provider, così un mancato recapito è diagnosticabile invece di passare inosservato.
- Widget della dashboard — conteggio dei non letti, moduli attivi e invii più recenti.
- Anti-spam — honeypot nascosto, trappola del tempo minimo di compilazione e limite orario per IP attivi per impostazione predefinita; Cloudflare Turnstile facoltativo quando le trappole passive non bastano.
- Conservazione — eliminazione facoltativa di invii e voci del registro più vecchi di un certo numero di giorni.
L’indirizzo del visitatore non compare mai nella definizione pubblica del modulo, e il destinatario di un modulo si trova solo nell’amministrazione.
Installazione
Installazione e primo modulo
- Nell’amministrazione di EmDash apri Registry, cerca Contact Forms e fai clic su Install. Il plugin chiede di inviare e-mail tramite il provider del tuo sito e di contattare
challenges.cloudflare.com— quell’host viene usato solo se attivi Turnstile. - Apri Plugins → Contact forms → Settings e imposta l’e-mail di notifica predefinita. È qui che vengono inviati gli invii quando un modulo non la sostituisce.
- Apri Forms → New form. Dagli un nome, uno slug come
contacte aggiungi i campi. Ogni modulo può sostituire il destinatario, il modello dell’oggetto, l’etichetta del pulsante e il messaggio di successo. - Inserisci il modulo in una pagina con il blocco Contact form e digita lo slug. Se il tuo tema non include ancora il blocco, la cartella
site/del pacchetto contiene i due file da copiare —block-type.jsonper il seed eContactForm.astroper il rendering; il README ti guida passo passo. - In Settings → Email attiva un provider e invia un’e-mail di prova. Senza un provider gli invii vengono comunque salvati — semplicemente non vengono spediti per e-mail, e il registro e-mail ne mostra il motivo.
Gli invii compaiono in Plugins → Contact forms → Submissions e nel widget della dashboard non appena scrive il primo visitatore.
FAQ
Dove vanno gli invii?
Nel database del tuo sito, sotto Plugins → Contact forms → Submissions. Nulla viene inviato a terzi — le uniche chiamate in uscita sono l’e-mail di notifica tramite il tuo provider e, se attivata, la verifica Turnstile.
Invia e-mail senza un provider configurato?
No, e va bene così — gli invii vengono comunque salvati con lo stato e-mail skipped. Quando attivi un provider in Settings → Email, le notifiche e le conferme ai visitatori iniziano a partire, e il registro e-mail annota ogni tentativo.
Come blocca lo spam?
Tre difese passive sono sempre attive: un campo honeypot nascosto, una trappola del tempo minimo di compilazione e un limite orario di invii per IP che puoi regolare nelle impostazioni. Quando non basta, incolla le chiavi del sito e segreta di Cloudflare Turnstile nelle impostazioni del plugin e ogni modulo viene verificato prima che venga salvato qualsiasi cosa.
I visitatori possono ricevere un’e-mail di conferma?
Sì. Un modulo può inviare al visitatore una conferma con un proprio modello di oggetto. I modelli di oggetto possono usare i valori dei campi inviati, e le risposte alle e-mail di notifica vanno al campo e-mail del visitatore.
Posso estrarre gli invii?
La pagina degli invii copia la vista filtrata come CSV, e una rotta export autenticata fornisce lo stesso CSV per script o token API.
Gli invii possono essere eliminati automaticamente?
Imposta Keep submissions for (days) nelle impostazioni del plugin. Un’attività pianificata elimina invii e voci del registro e-mail più vecchi del limite; 0 conserva tutto.
Il modulo pubblico espone l’indirizzo del destinatario?
No. La rotta pubblica del modulo restituisce solo campi, etichette e opzioni — il destinatario e le impostazioni di notifica non lasciano mai l’amministrazione.
Registro delle modifiche
1.1.2
- Le caselle di controllo obbligatorie ora rifiutano i valori omessi o non validi invece di lasciarli passare in silenzio.
- Gli invii vengono salvati prima di qualsiasi elaborazione e-mail: se il provider fallisce in seguito, la riga viene contrassegnata come fallita ma il messaggio non va mai perso, e il visitatore riceve comunque una risposta salvata.
- I nuovi tentativi di invio sono idempotenti: un’impronta calcolata su slug, IP e valori elimina righe ed e-mail duplicate.
- Gli invii rifiutati ripopolano il modulo con errori per campo tramite un record di recupero monouso.
- La verifica Turnstile ha una scadenza di dieci secondi e una politica di interruzione configurabile (accetta per impostazione predefinita).
- Il limite di frequenza per IP è atomico e consuma il suo budget prima di Turnstile.
- Le chiavi di campo
cf_sono riservate al protocollo di invio e vengono rifiutate dall’amministrazione. - L’esportazione CSV e l’anteprima dell’amministrazione neutralizzano l’iniezione di formule nei fogli di calcolo.
- La pulizia oraria ora elimina anche i bucket di frequenza obsoleti, i record di recupero e le prenotazioni di idempotenza.
- Documentazione: il link alla demo dal vivo include parametri UTM.
1.1.1
- La scheda del registro ottiene un’icona, un banner, schermate, una guida all’installazione, una FAQ e questo registro delle modifiche. Nessuna modifica al plugin stesso.
1.1.0
- Verifica Cloudflare Turnstile facoltativa su ogni modulo: imposta la chiave del sito e la chiave segreta nelle impostazioni del plugin e gli invii vengono verificati prima di essere salvati.
- Nuova autorizzazione
network:requestlimitata achallenges.cloudflare.comper quel controllo. - Impostazione di registrazione di debug dettagliata, utile mentre colleghi un nuovo provider di posta.
1.0.0
- Prima versione. Costruttore di moduli nell’amministrazione con otto tipi di campo, posta in arrivo degli invii, registro di recapito delle e-mail e widget della dashboard.
- E-mail di notifica e di conferma al visitatore tramite il provider attivo del sito con
ctx.email.send(). - Honeypot, tempo minimo di compilazione e limite orario per IP attivi per impostazione predefinita; pulizia di conservazione facoltativa dei vecchi invii.
- Rotte pubbliche
formesubmitpiù il blocco di pagina Contact form fornito insite/.