HTML šablony

Šablona je všechno, co Frontmail potřebuje, aby ze sady parametrů udělal hotový e-mail. Upravujete ji v dashboardu v sekci Šablony; každé uložení vytvoří novou verzi.

Co šablona obsahuje

Část	Poznámky
Název, popis, locale	Locale (`en` / `cs`) určuje výstup `formatDate`, `formatNumber` a `formatMoney`.
Subject	Může obsahovat parametry: `Objednávka {{order_id}} potvrzena`.
To, CC, BCC	Adresy oddělené čárkou. Parametry jsou povolené jen s Allow dynamic recipient (viz níže). Celkem max. 50 příjemců.
From name, From email	From email musí povolovat připojená služba (ověřená doména nebo odesílatel).
Reply-To	Obvykle `{{email}}`, abyste mohli návštěvníkovi odpovědět přímo.
HTML tělo	Kompletní HTML dokument včetně `<head>` a `<style>`.
Textová verze	Generuje se z HTML automaticky; vypnutím auto ji můžete upravit ručně.
Parametry	Typované schéma – viz Parametry a typy.
Služba a záložní služba	Která služba šablonu odesílá a která při selhání převezme.
Zabezpečení	CAPTCHA required (výchozí zapnuto, pokud má organizace klíče Turnstile, jinak vypnuto; výslovné `false` ze souboru se zachová), Allow dynamic recipient (výchozí vypnuto).
Přílohy	Statické soubory, dynamické přílohy zap./vyp., vložené obrázky – viz Přílohy.
Automatická odpověď, sběr kontaktů	Viz Automatická odpověď a Sběr kontaktů.

Editor

Editor je rozdělený na dvě části:

Vlevo: editor HTML kódu se zvýrazněním Handlebars a automatickým doplňováním vašich parametrů (napište {{ a uvidíte je). Pro jednoduché šablony je k dispozici vizuální editor; na HTML můžete kdykoli přepnout.
Vpravo: živý náhled v sandboxovaném iframu. Přepínáte šířku desktop / mobil, světlé / tmavé pozadí a HTML / textovou verzi. Náhled se překresluje průběžně při psaní.

Pod náhledem je panel parametrů – formulář vygenerovaný ze schématu, ve kterém upravujete ukázkové hodnoty pro náhled a testovací odeslání.

Inlinování CSS

Řada e-mailových klientů (hlavně Gmail na některých platformách a Outlook) ignoruje bloky <style>. Se zapnutým Inline CSS on save Frontmail při uložení zkopíruje vaše pravidla do atributů style="" a media queries ponechá v <style> pro klienty, kteří je podporují.

Kontroly šablony

Panel kontrol se spouští při každé změně a upozorní na:

chybějící parametry – použité v šabloně, ale nedefinované ve schématu,
nepoužité parametry – definované, ale nikde nepoužité,
neplatný Handlebars – neuzavřené bloky, neznámé helpery (k dispozici jsou jen vestavěné helpery),
obrázky bez alt – špatné pro přístupnost i pro klienty, kteří obrázky blokují,
velikost přes ~100 kB – Gmail zprávy větší než zhruba 102 kB ořízne a zbytek schová za „Zobrazit celou zprávu“.

Upozornění nikdy nebrání uložení, ale šablonu, kterou nejde zkompilovat, nelze odeslat.

Dynamičtí příjemci

Ve výchozím stavu musí být To, CC a BCC pevné adresy. Pokud pole s příjemcem obsahuje parametr (například To: {{email}}), odeslání se odmítne s chybou dynamic_recipient_not_allowed, dokud na šabloně nezapnete Allow dynamic recipient.

S veřejným klíčem se šablona s dynamickým příjemcem odešle jen s uzamčeným obsahem: povinná CAPTCHA, pevná pole odesílatele, žádné HTML parametry, texty do 500 znaků, odkazy jen na povolené domény a nejvýš 5 e-mailů na příjemce za den.

Pro běžný případ „poděkovat návštěvníkovi“ použijte místo toho automatickou odpověď.

Patička v tarifu Free

E-maily odeslané v tarifu Free dostanou malou patičku „Sent via Frontmail“. Placené tarify patičku nemají.

Import a export

Import: vložte HTML nebo nahrajte soubor .html; Frontmail rozpozná parametry z placeholderů {{…}}.
Export: stáhněte šablonu (HTML, text, nastavení a schéma parametrů) jako JSON, třeba abyste ji přenesli do jiné organizace.