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.

  • Categoria: forms
  • Stato: Disponibile
  • Versione: 1.1.2
  • Prezzo: Sconosciuto
  • Fonte: Registro ufficiale dei plugin
  • Installazione: Plugin sandbox del registro
  • Verificato: 2026-10-21

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

  1. 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.
  2. 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.
  3. Apri Forms → New form. Dagli un nome, uno slug come contact e aggiungi i campi. Ogni modulo può sostituire il destinatario, il modello dell’oggetto, l’etichetta del pulsante e il messaggio di successo.
  4. 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.json per il seed e ContactForm.astro per il rendering; il README ti guida passo passo.
  5. 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:request limitata a challenges.cloudflare.com per 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 form e submit più il blocco di pagina Contact form fornito in site/.