FastComments Email Templates używa języka szablonów EJS.

Przykładowa składnia to <%= object.someValue %> do wypisywania zmiennych, a instrukcje warunkowe można zapisać w ten sposób:

<% if (some_condition) { %>
    <div>Some content.</div>
<% } else { %>
    <div>Some other content.</div>
<% } %>

Aby wypisać surowy HTML, na przykład zawartość komentarza, użyj: <%- comment.commentHTML %>. Zwróć uwagę na - zamiast =.

Szczegółową dokumentację składni znajdziesz w powyższym linku.

FastComments to platforma z obsługą lokalizacji. Wszystkie nasze widgety, e-maile i powiadomienia są zlokalizowane.

Lokalizacja oznacza, że wyświetlamy inny język i formatowanie w zależności od lokalizacji użytkownika i preferowanego języka. Określamy to na podstawie informacji dostarczonych przez przeglądarkę użytkownika.

Możemy dostosować tekst w e-mailu, przechodząc do zakładki Translations, wybierając Locale i edytując tekst. Tekst zmieniony względem domyślnego jest wyróżniony w interfejsie. Możesz przełączać się między lokalizacjami i zapisać na końcu, nie tracąc zmian.

Tekst zlokalizowany jest dostępny przez obiekt TEXT, na przykład: <%= TEXT.INTRO %>.

Uwaga dotycząca SSO

W integracjach SSO, jeśli locale nie jest określony, będzie on aktualizowany za każdym razem, gdy użytkownik uzyska dostęp do widżetu komentarzy z innym locale. Oznacza to, że jego preferencje językowe są aktualizowane automatycznie, a przyszłe e-maile będą wysyłane w tym locale.

Można to również ustawić ręcznie, podając locale w payloadzie SSO.

Szablony można skonfigurować jako globalne — w skali całego konta dla danego typu szablonu lub dla poszczególnych domen. Na karcie Settings wybierz żądaną domenę.

Zwróć uwagę, że jeśli skonfigurujesz wiele szablonów dla tej samej domeny, tylko pierwszy jest wybierany w czasie wykonywania. Lista szablonów ostrzeże Cię, gdy wystąpi taka sytuacja.

Każdy szablon działa w innym kontekście, co oznacza, że dostępne są różne dane.

Szybki, na pierwszy rzut oka sposób, aby zobaczyć, jakie dane są dostępne, to sprawdzenie danych testowych dostarczonych dla szablonu. Podczas edycji szablonu kliknij kartę Test Data, aby zobaczyć strukturę JSON.

Możemy także dostosować dane testowe w tym miejscu, aby zobaczyć, jak nasz szablon wygląda w różnych sytuacjach. Dane testowe można przywrócić do domyślnych za pomocą przycisku Reset.

Ponieważ szablony e-mail obsługują zmienne, i logikę, możliwe jest stworzenie szablonów które nie renderują się, lub czasami zawodzą podczas renderowania.

To może być bardzo frustrujące do zdiagnozowania i debugowania, szczególnie jeśli jest to problem przerywany, lub jeśli występuje tylko wtedy, gdy dane wyglądają w określony sposób.

Aby pomóc, FastComments Email Templates ma kilka funkcji:

1. Jeśli szablon nie zajdzie w podglądzie, nie można go zapisać. Zostanie wyświetlony komunikat o błędzie.
2. Błędy renderowania szablonów są śledzone i raportowane w panelu administracyjnym.

Drugi punkt opisuje błędy renderowania, które występują w produkcji. Czyli tworzymy szablon, który w podglądzie wygląda poprawnie - ale później z jakiegoś powodu przestaje działać. Na przykład, jeśli mamy to w naszym szablonie:

<% if (comment.commenterEmail.includes('test') { %>

To może czasami zawodzić, jeśli mamy włączone anonimowe komentowanie, ponieważ e-mail nie zawsze będzie dostępny. Jak więc się o tym dowiedzieć?

Odpowiedź jest taka, że błędy są ujawniane w dwóch miejscach. Po pierwsze, sama lista szablonów pokazuje przy każdym szablonie liczbę błędów renderowania.

Następnie, podczas przeglądania szablonu, możemy zobaczyć liczbę, dla każdego błędu, ile razy szablon nie udało się wyrenderować.

Przycisk resetowania znajduje się obok każdego błędu i jego licznika, abyśmy mogli zresetować licznik po rozwiązaniu problemu.

Tworzenie i edytowanie szablonów wiadomości e-mail jest natychmiastowe. Oznacza to, że w chwili naciśnięcia przycisku Save, platforma zacznie używać najnowszej wersji tej wiadomości e-mail.