Szablony HTML

Szablon to wszystko, czego Frontmail potrzebuje, żeby z zestawu parametrów zrobić gotowy e-mail. Edytujesz go w Szablony w panelu; każde zapisanie tworzy nową wersję.

Co zawiera szablon

Część	Uwagi
Nazwa, opis, język domyślny	Dowolny język (en, pl, hu, pt-BR, …). Język, w którym e-mail jest wysyłany, określa wynik formatDate, formatNumber i formatMoney.
Wersje językowe	Opcjonalne tłumaczenia tematu, HTML, tekstu i nazwy nadawcy – zobacz Tłumaczenia szablonów.
Temat	Może zawierać parametry: Zamówienie {{order_id}} potwierdzone.
Do, CC, BCC	Adresy oddzielone przecinkami. Parametry są dozwolone tylko z Zezwól na dynamicznego odbiorcę (zobacz niżej). Łącznie maks. 50 odbiorców.
Nazwa nadawcy, e-mail nadawcy	E-mail nadawcy musi być dozwolony przez połączoną usługę (zweryfikowana domena lub nadawca).
Reply-To	Zwykle {{email}}, żeby można było odpowiedzieć odwiedzającemu bezpośrednio.
Treść HTML	Kompletny dokument HTML łącznie z <head> i <style>.
Wersja tekstowa	Generowana automatycznie z HTML; wyłącz tryb auto, żeby edytować ją ręcznie.
Parametry	Typowany schemat – zobacz Parametry i typy.
Usługa i usługa zapasowa	Która usługa wysyła szablon, a która przejmuje wysyłkę w razie awarii.
Bezpieczeństwo	Wymagaj CAPTCHA (Turnstile) (domyślnie włączone, gdy twoja organizacja ma klucze Turnstile, w przeciwnym razie wyłączone; jawne false z pliku zostaje zachowane), Zezwól na dynamicznego odbiorcę (domyślnie wyłączone).
Załączniki	Stałe pliki, włączanie dynamicznych załączników, obrazy inline – zobacz Załączniki.
Automatyczna odpowiedź, zbieranie kontaktów	Zobacz Automatyczna odpowiedź i Zbieranie kontaktów.

Edytor

Edytor jest podzielony na dwie części:

• Z lewej: edytor kodu HTML z podświetlaniem Handlebars i podpowiadaniem twoich parametrów (wpisz {{, żeby je zobaczyć). Dla prostych szablonów jest dostępny edytor wizualny; na HTML możesz przełączyć się w każdej chwili.
• Z prawej: podgląd na żywo w odizolowanym iframe. Przełączasz szerokość komputer / telefon, jasne / ciemne tło i wersję HTML / tekstową. Podgląd odświeża się w trakcie pisania.

Pod podglądem jest panel parametrów – formularz wygenerowany ze schematu, w którym edytujesz przykładowe wartości używane przez podgląd i wysyłki testowe.

CSS inline

Wiele klientów poczty (zwłaszcza Gmail na niektórych platformach i Outlook) ignoruje bloki <style>. Gdy włączysz Wstawiaj CSS inline przy zapisie, Frontmail przy zapisie kopiuje twoje reguły do atrybutów style="", a media queries zostawia w <style> dla klientów, które je obsługują.

Kontrole szablonu

Panel kontroli działa przy każdej zmianie i ostrzega przed:

• brakującymi parametrami – użytymi w szablonie, ale niezdefiniowanymi w schemacie,
• nieużywanymi parametrami – zdefiniowanymi, ale nigdzie nieużytymi,
• niepoprawnym Handlebars – niezamknięte bloki, nieznane helpery (dostępne są tylko wbudowane helpery),
• obrazami bez alt – źle dla dostępności i dla klientów, które blokują obrazy,
• rozmiarem ponad ~100 kB – Gmail przycina wiadomości większe niż około 102 kB i chowa resztę za „View entire message” („Wyświetl całą wiadomość”).

Ostrzeżenia nigdy nie blokują zapisu, ale szablonu, który się nie kompiluje, nie da się wysłać.

Dynamiczni odbiorcy

Domyślnie pola Do, CC i BCC muszą zawierać stałe adresy. Jeśli pole odbiorcy zawiera parametr (na przykład Do: {{email}}), wysyłki są odrzucane z dynamic_recipient_not_allowed, chyba że włączysz w szablonie Zezwól na dynamicznego odbiorcę.

Dlaczego to jest domyślnie wyłączone

Szablon z dynamicznym odbiorcą i kluczem publicznym można nadużyć do wysyłania dowolnych e-maili do kogokolwiek. Włączaj to tylko razem z dozwolonymi domenami, Turnstile i rozsądnymi rate limitami – albo wysyłaj takie szablony tylko ze swojego serwera kluczem prywatnym.

Z kluczem publicznym szablon z dynamicznym odbiorcą jest wysyłany tylko z zablokowaną treścią: wymagana CAPTCHA, stałe pola nadawcy, brak parametrów HTML, teksty do 500 znaków, linki tylko do dozwolonych domen i najwyżej 5 e-maili na odbiorcę dziennie.

W typowym przypadku „podziękuj odwiedzającemu” użyj zamiast tego automatycznej odpowiedzi.

Parametry wewnątrz atrybutów

Parametr typu HTML użyty wewnątrz tagu (<a href="{{bio}}">, <img alt="{{bio}}">) albo w <style> jest tam wstawiany jako zwykły, escapowany tekst, więc jego znaczniki nie wydostaną się poza atrybut. Edytor ostrzega przed tym w Kontrolach.

Stopka w planie Free

E-maile wysłane w planie Free mają małą stopkę „Wysłano przez Frontmail” – w języku e-maila, jeśli to jeden z ośmiu języków panelu, w przeciwnym razie po angielsku. Płatne plany nie mają stopki.

Import i eksport

• Import: wklej HTML albo prześlij plik .html; Frontmail wykryje parametry z symboli zastępczych {{…}}.
• Eksport: pobierz szablon (HTML, tekst, ustawienia, schemat parametrów i wersje językowe) jako JSON, np. żeby przenieść go do innej organizacji.