Treść dynamiczna
Wstęp
Treść dynamiczna to nowa, ekscytująca funkcja, która umożliwia zaawansowane dostosowywanie treści. Dzięki zawartości dynamicznej możesz wysłać wiadomość e-mail lub wygenerować PDF (wymaga dodatku PDF ) z tekstem w formacie HTML wyświetlanym na podstawie wartości pól.
Na przykład możesz ukształtować temat wiadomości e-mail tak, aby wyświetlał odpowiednią nazwę użytkownika, zamiast kodować na stałe określoną wartość:
Thanks {{ Name }}, we have received your message!
Obecnie funkcjonalność ta dostępna jest w:
- Wiadomości potwierdzające
- E-maile z potwierdzeniem i
- Powiadomienia e-mailowe
Ponadto zawartość dynamiczna jest dostępna w naszych dodatkach Premium, takich jak warunkowe wiadomości e-mail lub PDF .
Zmienne
Możesz wstawić zmienne do treści wiadomości e-mail, a zostaną one zastąpione tym, co użytkownik wstawi do tego pola.
Aby wydrukować zmienną, musi ona znajdować się pomiędzy podwójnymi nawiasami klamrowymi: {{ and }} . Np.
W poniższym przykładzie pokazujemy dwa sposoby drukowania zmiennych:
- Korzystając z etykiety pola : Zmienna
{{ Your Name }}
została wstawiona do wiadomości e-mail z potwierdzeniem i zostanie zastąpiona nazwą wprowadzoną przez użytkownika w formularzu. - Używając ID pola : Możesz użyć ID pola także jako nazwy zmiennej, na przykład na następnym obrazku używamy następującej zmiennej do wydrukowania Nazwy użytkownika:
{{ text_1 }}
jednocześnie używamy{{ Your Name }}
. Innymi słowy, możemy użyć obu typów zmiennych, aby uzyskać te same informacje o polu. Jeśli Twoje pole nie ma etykiety, powinieneś skorzystać z tej opcji.
Dodatkowo możesz użyć następujących zmiennych:
{{ form_id }}
: Identyfikator formularza.{{ form_name }}
: Nazwa formularza{{ submission_id }}
: Identyfikator zgłoszenia{{ submission_number }}
: Numer zgłoszenia{{ submission_table }}
: Zawartość wszystkich pól formularza (format HTML){{ submission_text }}
: Zawartość wszystkich pól formularza (format tekstowy){{ created_at }}
: Data złożenia{{ ip_address }}
: Adres IP.{{ user_agent }}
: Agent użytkownika przeglądarki nadawcy.{{ url }}
: Adres URL strony internetowej, na której osadzono formularz.{{ referrer }}
: Adres URL strony internetowej, z której użytkownik trafił do formularza.{{ country }}
: Kraj nadawcy.{{ city }}
: Miasto nadawcy.{{ longitude }}
: Współrzędna geograficzna określająca położenie nadawcy ze wschodu na zachód.{{ latitude }}
: Współrzędna geograficzna określająca położenie północ-południe nadawcy.{{ edit_link }}
: Aby wyświetlić adres URL strony formularza publicznego w celu edycji zgłoszenia. Aby móc korzystać z tej funkcji, należy włączyć opcję „Zapisz w bazie danych” i „Edytuj”.{{ optin_link }}
: Aby wyświetlić łącze do strony potwierdzenia zgody. Aby móc korzystać z tej funkcji, należy włączyć opcję „Zapisz w bazie danych”.
To świetny sposób na personalizację wiadomości. W ten sposób można wykorzystać dowolne pole formularza.
Narzędzie automatycznego sugerowania
„Ustawienia formularza”, „Zasady formularza” i dodatki Premium pozwalają na zastąpienie symboli zastępczych danymi zebranymi przez Twoje formularze. Dla ułatwienia wdrożyliśmy narzędzie wizualne, które pozwala na zaznaczanie pól formularza bez ich zapamiętywania. Aby skorzystać z tego narzędzia, wystarczy wpisać nawias klamrowy „{”, a pojawi się lista pól formularza, wybrać żądane pole i gotowe.
Filtry
Filtry umożliwiają zmianę wyniku zmiennej. Należy go zastosować po zmiennej i oddzielić kreską „|”.
Użyj wartości domyślnych
W przypadku pól niewymaganych możesz określić wartość domyślną, która będzie używana, jeśli nie ma ona żadnej wartości.
Thanks {{ Name | default: "friend" }}, we have received your message!
W przypadku użytkownika o imieniu John będzie to brzmiało: „Dzięki, John, otrzymaliśmy Twoją wiadomość!”. Jeśli jednak zgłoszenie nie miało nazwy, brzmiałoby: „Dzięki przyjacielu, otrzymaliśmy Twoją wiadomość!”
Zmień formaty daty
Konwertuje znacznik czasu na inny format daty.
{{ created_at | date: "%a, %b %d, %y" }}
Wyjście: piątek, 17, 20 lipca
{{ created_at | date: "%Y" }}
Wynik: 2020
Użyj strefy czasowej z formatami daty
{{ created_at | timezone: "America/New_York" | date: "%Y-%m-%d %H:%M" }}
Wyjście: 2020-07-17 01:00
Użyj ustawień regionalnych i strefy czasowej z formatami daty
Nazwy ustawień regionalnych są różne w przypadku platform opartych na systemie Unix i Win32.
{{ date_1 | locale: "en_US" | timezone: "America/New_York" | date: "%A, %B %d, %y" }}
Wyjście: poniedziałek, 28, 22 lutego
Dla Linuksa:
{{ date_1 | locale: "es_ES" | timezone: "America/New_York" | date: "%A, %B %d, %y" }}
Dla systemu Windows:
{{ date_1 | locale: "Spanish_Spain.1252" | timezone: "America/New_York" | date: "%A, %B %d, %y" }}
Wyjście: lunes, febrero 28, 22
Kodowanie adresu URL
Aby wydrukować zmienne w adresach URL (np. aby przekierować użytkownika na inną stronę) sugerujemy użycie filtra url_encode.
Filtr url_encode konwertuje dowolne znaki w ciągu znaków, które są niebezpieczne dla adresu URL, na znaki zakodowane procentowo. Na przykład,
{{ "" | url_encode }}
Dane wyjściowe: john%40doe.com
Nowy filtr linii do przerwania
W polach Textarea znaki nowej linii są zapisywane jako /n, jeśli tekst wprowadzany i wyświetlany na pierwszym planie znajdują się w obszarze tekstowym, nie ma potrzeby wykonywania żadnego przetwarzania. Styl, który wpiszesz w obszarze tekstowym, będzie wyświetlany poprawnie, zgodnie ze stylem, który przesłałeś wcześniej.
Jeśli jednak chcesz wyświetlić dane obszaru tekstowego jako zawartość dynamiczną, musisz rozważyć wstawienie podziału wiersza HTML (
) przed każdą nową linią (\n) w ciągu.
{{ Your Message | newline_to_br }}
Wyjście:
Drogi Zespole ACME,
Piszę w nawiązaniu do obecnej sytuacji z Projektem ABC. Mamy wiele pytań, na które mamy nadzieję, że odpowiesz...
Podpis
Możemy wyświetlić podpis na różne sposoby, korzystając z filtra podpisu, na przykład aby wyświetlić:
- Podpis jako surowe dane (ciąg JSON zawierający punkty potrzebne do odbudowania podpisu)
{{ hidden_signature_1 }}
- Podpis jako obraz (tag HTML img)
{{ hidden_signature_1 | signature }}
- Podpis jako adres URL danych (adres URL, który można wstawić w atrybucie src znacznika img)
{{ hidden_signature_1 | signature: 'data_url' }}
- Podpis jako surowe dane (druga opcja)
{{ hidden_signature_1 | signature: 'data' }}
- Podpis jako obraz (druga opcja)
{{ hidden_signature_1 | signature: 'image' }}
Warunki
Możesz użyć logiki warunkowej w swojej treści. Możesz wysłać ten sam e-mail z różnicami dla różnych grup. Najczęstszym przypadkiem użycia jest lokalizacja językowa, w przypadku której chcesz wysyłać różne treści do różnych użytkowników.
Użyj wielu języków
W poniższym przykładzie, jeśli użytkownik o imieniu John wybierze preferowany język jako hiszpański, jego wiadomość będzie brzmiała: „Hola, John!”
{% if Language == 'Spanish' %}
Hola {{ Name }}!
{% elsif Language == 'French' %}
Bonjour {{ Name }}!
{% else %}
Hello {{ Name }}!
{% endif %}
Uwaga : w tym przykładzie etykietą pola jest „Język”.
Pokaż obrazy
Innym częstym przypadkiem użycia jest wyświetlanie wielu obrazów przesłanych przez to samo pole pliku w różnych miejscach. W tym celu możesz wykonać następujące czynności:
{% if file_1[0] %}
<div class="image-item-1">
<img src="{{ file_1[0] }}" width="300" height="300" alt="First Image" />
</div>
{{% endif %}}
{% if file_1[1] %}
<div class="image-item-2">
<img src="{{ file_1[1] }}" width="300" height="300" alt="Second Image" />
</div>
{{% endif %}}