HTML šablóny

Šablóna je všetko, čo Frontmail potrebuje, aby zo sady parametrov vytvoril hotový e-mail. Upravujete ju v časti Šablóny v dashboarde; každé uloženie vytvorí novú verziu.

Čo šablóna obsahuje

Časť	Poznámky
Názov, popis, predvolený jazyk	Akýkoľvek jazyk (en, sk, hu, pt-BR, …). Jazyk, v ktorom e-mail odchádza, určuje výstup formatDate, formatNumber a formatMoney.
Jazykové verzie	Nepovinné preklady predmetu, HTML, textu a mena odosielateľa – pozrite Preklady šablón.
Predmet	Môže obsahovať parametre: Objednávka {{order_id}} je potvrdená.
Komu, Kópia, Skrytá kópia	Adresy oddelené čiarkou. Parametre sú povolené len s Povoliť dynamického príjemcu (pozrite nižšie). Spolu najviac 50 príjemcov.
Meno odosielateľa, e-mail odosielateľa	E-mail odosielateľa musí povoľovať pripojená služba (overená doména alebo odosielateľ).
Reply-To	Zvyčajne {{email}}, aby ste mohli návštevníkovi odpovedať priamo.
Telo HTML	Kompletný HTML dokument vrátane <head> a <style>.
Textová verzia	Generuje sa z HTML automaticky; ak ju chcete upraviť ručne, vypnite auto.
Parametre	Typovaná schéma – pozrite Parametre a typy.
Služba a záložná služba	Ktorá služba šablónu odosiela a ktorá pri zlyhaní prevezme odosielanie.
Zabezpečenie	Vyžadovať CAPTCHA (Turnstile) (predvolene zapnuté, keď má vaša organizácia kľúče Turnstile, inak vypnuté; explicitné false v importovanom súbore sa zachová), Povoliť dynamického príjemcu (predvolene vypnuté).
Prílohy	Statické súbory, zapnutie/vypnutie dynamických príloh, vložené obrázky – pozrite Prílohy.
Automatická odpoveď, zber kontaktov	Pozrite Automatická odpoveď a Zber kontaktov.

Editor

Editor je rozdelený na dve časti:

• Vľavo: editor HTML kódu so zvýrazňovaním Handlebars a automatickým dopĺňaním vašich parametrov (napíšte {{ a zobrazia sa). Pre jednoduché šablóny je k dispozícii aj vizuálny editor; na HTML môžete kedykoľvek prepnúť.
• Vpravo: živý náhľad v izolovanom iframe. Prepínať môžete šírku počítača / mobilu, svetlé / tmavé pozadie a verziu HTML / čistý text. Náhľad sa prekresľuje počas písania.

Pod náhľadom je panel parametrov – formulár vygenerovaný zo schémy, v ktorom upravujete vzorové hodnoty pre náhľad a testovacie odoslania.

Vkladanie CSS do atribútov

Mnohé e-mailové klienty (najmä Gmail na niektorých platformách a Outlook) bloky <style> ignorujú. So zapnutou voľbou Pri uložení vložiť CSS do atribútov Frontmail pri uložení skopíruje vaše pravidlá do atribútov style="" a media queries ponechá v <style> pre klienty, ktoré ich podporujú.

Kontroly šablóny

Panel kontrol sa spúšťa pri každej zmene a upozorňuje na:

• chýbajúce parametre – použité v šablóne, ale nedefinované v schéme,
• nepoužité parametre – definované, ale nikde nepoužité,
• neplatné Handlebars – neuzavreté bloky, neznáme helpery (k dispozícii sú len vstavané helpery),
• obrázky bez alt – zlé pre prístupnosť aj pre klienty, ktoré blokujú obrázky,
• veľkosť nad ~100 kB – Gmail správy väčšie ako zhruba 102 kB oreže a zvyšok skryje za „View entire message“ („Zobraziť celú správu“).

Upozornenia nikdy nebránia uloženiu, no šablónu, ktorú nemožno skompilovať, nemožno ani odoslať.

Dynamickí príjemcovia

Predvolene musia byť Komu, Kópia a Skrytá kópia pevné adresy. Ak pole s príjemcom obsahuje parameter (napríklad Komu: {{email}}), odoslanie sa odmietne s chybou dynamic_recipient_not_allowed, pokiaľ v šablóne nezapnete Povoliť dynamického príjemcu.

Prečo je to predvolene vypnuté

Šablóna s dynamickým príjemcom a verejným kľúčom by sa dala zneužiť na posielanie ľubovoľných e-mailov komukoľvek. Zapnite to len spolu s povolenými doménami, Turnstile a rozumnými rate limitmi – alebo také šablóny posielajte len zo svojho servera so súkromným kľúčom.

S verejným kľúčom sa šablóna s dynamickým príjemcom odošle len s uzamknutým obsahom: povinná CAPTCHA, pevné polia odosielateľa, žiadne parametre typu HTML, texty do 500 znakov, odkazy len na povolené domény a najviac 5 e-mailov na príjemcu za deň.

Pre bežný prípad „poďakovať návštevníkovi“ použite radšej automatickú odpoveď.

Parametre v atribútoch

Parameter typu HTML použitý vnútri značky (<a href="{{bio}}">, <img alt="{{bio}}">) alebo v <style> sa tam vloží ako obyčajný escapovaný text, takže jeho značky nemôžu z atribútu uniknúť. Editor na to upozorní v paneli Kontroly.

Pätička v tarife Free

E-maily odoslané na tarife Free dostanú malú pätičku „Odoslané cez Frontmail“ – v jazyku e-mailu, ak je to jeden z ôsmich jazykov dashboardu, inak v angličtine. Platené tarify pätičku nemajú.

Import a export

• Import: vložte HTML alebo nahrajte súbor .html; Frontmail rozpozná parametre zo zástupných znakov {{…}}.
• Export: stiahnite si šablónu (HTML, text, nastavenia, schému parametrov a jazykové verzie) ako JSON, napr. ak ju chcete presunúť do inej organizácie.