Modelli HTML

Un modello è tutto ciò che serve a Frontmail per trasformare un insieme di parametri in un’email finita. Lo modifichi in Modelli nella dashboard; ogni salvataggio crea una nuova versione.

Cosa contiene un modello

Parte	Note
Nome, descrizione, lingua predefinita	Qualsiasi lingua (en, it, hu, pt-BR, …). La lingua in cui viene inviata un’email determina l’output di formatDate, formatNumber e formatMoney.
Varianti linguistiche	Traduzioni facoltative di oggetto, HTML, testo e nome del mittente – vedi Traduzioni dei modelli.
Oggetto	Può contenere parametri: Ordine {{order_id}} confermato.
A, CC, BCC	Indirizzi separati da virgola. Parametri consentiti solo con Consenti destinatario dinamico (vedi sotto). Massimo 50 destinatari in totale.
Nome mittente, email mittente	L’email del mittente deve essere consentita dal servizio collegato (dominio o mittente verificato).
Reply-To	Di solito {{email}}, così puoi rispondere direttamente al visitatore.
Corpo HTML	Un documento HTML completo, con <head> e <style>.
Versione testuale	Generata automaticamente dall’HTML; disattiva auto per modificarla a mano.
Parametri	Lo schema tipizzato: vedi Parametri e tipi.
Servizio e servizio di riserva	Quale servizio lo invia e quale subentra in caso di errore.
Sicurezza	CAPTCHA obbligatorio (attivo per impostazione predefinita se la tua organizzazione ha le chiavi Turnstile, altrimenti disattivo; un false esplicito in un file importato viene mantenuto), Consenti destinatario dinamico (disattivo per impostazione predefinita).
Allegati	File statici, allegati dinamici sì/no, immagini inline: vedi Allegati.
Risposta automatica, raccolta contatti	Vedi Risposta automatica e Raccolta contatti.

L’editor

L’editor è diviso in due:

• A sinistra: editor del codice HTML con evidenziazione Handlebars e completamento automatico dei tuoi parametri (digita {{ per vederli). Per i modelli semplici è disponibile un editor visuale; puoi passare all’HTML in qualsiasi momento.
• A destra: anteprima dal vivo in un iframe isolato. Alterna larghezza desktop / mobile, sfondo chiaro / scuro e versione HTML / testo semplice. L’anteprima si aggiorna mentre scrivi.

Sotto l’anteprima c’è il pannello dei parametri, un modulo generato dallo schema in cui modifichi i valori di esempio usati dall’anteprima e dagli invii di prova.

CSS inline

Molti client email (in particolare Gmail su alcune piattaforme e Outlook) ignorano i blocchi <style>. Con CSS inline al salvataggio attivo, al salvataggio Frontmail copia le tue regole negli attributi style="" e mantiene le media query in <style> per i client che le supportano.

Controlli del modello

Il pannello dei controlli viene eseguito a ogni modifica e segnala:

• parametri mancanti – usati nel modello ma non definiti nello schema,
• parametri inutilizzati – definiti ma mai usati,
• Handlebars non valido – blocchi non chiusi, helper sconosciuti (sono disponibili solo gli helper integrati),
• immagini senza alt – un problema per l’accessibilità e per i client che bloccano le immagini,
• dimensione oltre ~100 kB – Gmail taglia i messaggi più grandi di circa 102 kB e nasconde il resto dietro «Visualizza intero messaggio».

Gli avvisi non impediscono mai il salvataggio, ma un modello che non si compila non può essere inviato.

Destinatari dinamici

Per impostazione predefinita A, CC e BCC devono essere indirizzi fissi. Se un campo destinatario contiene un parametro (ad esempio A: {{email}}), gli invii vengono rifiutati con dynamic_recipient_not_allowed, a meno che tu non attivi Consenti destinatario dinamico sul modello.

Perché è disattivato per impostazione predefinita

Un modello con destinatario dinamico e una chiave pubblica potrebbe essere sfruttato per inviare email arbitrarie a chiunque. Attivalo solo insieme alle origini consentite, a Turnstile e a rate limit ragionevoli, oppure invia questi modelli solo dal tuo server con una chiave privata.

Con la chiave pubblica, un modello con destinatario dinamico viene inviato solo con il contenuto bloccato: CAPTCHA obbligatorio, campi del mittente fissi, nessun parametro HTML, testi fino a 500 caratteri, link solo verso domini consentiti e al massimo 5 email per destinatario al giorno.

Per il caso comune del «ringraziamento al visitatore», usa invece una risposta automatica.

Parametri dentro gli attributi

Un parametro di tipo HTML usato dentro un tag (<a href="{{bio}}">, <img alt="{{bio}}">) o in <style> viene inserito lì come semplice testo con escaping, quindi il suo markup non può uscire dall’attributo. L’editor lo segnala in Controlli.

Piè di pagina del piano Free

Le email inviate con il piano Free ricevono un piccolo piè di pagina «Inviato con Frontmail», nella lingua dell’email se è una delle otto lingue della dashboard, altrimenti in inglese. I piani a pagamento non hanno piè di pagina.

Importazione ed esportazione

• Importa: incolla l’HTML o carica un file .html; Frontmail rileva i parametri dai segnaposto {{…}}.
• Esporta: scarica il modello (HTML, testo, impostazioni, schema dei parametri e varianti linguistiche) come JSON, ad es. per spostarlo in un’altra organizzazione.