Conteúdo Dinâmico

  1. Introdução
  2. Variáveis
  3. Ferramenta de Auto-Sugestão
  4. Filtros
  5. Condicionais

Introdução

Conteúdo dinâmico é uma nova funcionalidade empolgante que permite uma poderosa personalização de conteúdo. Com conteúdo dinâmico, você pode enviar um e-mail ou gerar um documento PDF (requer o Complemento PDF) com texto formatado em HTML exibido com base nos valores dos campos.

Por exemplo, você pode estruturar o Assunto dos seus e-mails para exibir o nome apropriado do usuário, em vez de codificar um valor específico:

Obrigado {{ Name }}, recebemos sua mensagem!

Atualmente, essa funcionalidade está disponível em:

  • Mensagens de Confirmação
  • E-mails de Confirmação e
  • Notificações por E-mail

Além disso, Conteúdo Dinâmico está disponível em nossos Complementos Premium, como E-mails Condicionais ou PDF.

Variáveis

Você pode inserir variáveis no corpo do e-mail, e elas serão substituídas pelo que o usuário inserir naquele campo.

Para usar uma variável, ela deve estar entre chaves duplas: {{ e }}. Ex. {{ Minha Variável }}

No exemplo a seguir, mostramos duas maneiras de usar variáveis:

  • Usando o Rótulo do Campo: A variável {{ Seu Nome }} foi inserida no e-mail de confirmação e será substituída pelo nome que o usuário coloca no Formulário.
  • Usando o ID do Campo: Você também pode usar um ID de Campo como nome da variável, por exemplo, na próxima imagem usamos a seguinte variável para exibir o Nome do usuário: {{ text_1 }} ao mesmo tempo usamos {{ Seu Nome }}. Em outras palavras, podemos usar ambos os tipos de variáveis para obter a mesma informação do campo. Se seu campo não tiver um rótulo, esta é a opção que você deve usar.

iform4u - Personalizando a mensagem

Além disso, você pode usar as seguintes variáveis:

  • {{ form_id }}: ID do Formulário.
  • {{ form_name }}: Nome do Formulário
  • {{ submission_id }}: ID da Submissão
  • {{ submission_number }}: Número da Submissão
  • {{ submission_table }}: O conteúdo de todos os campos do formulário (formato HTML)
  • {{ submission_text }}: O conteúdo de todos os campos do formulário (formato de Texto)
  • {{ created_at }}: Data da Submissão
  • {{ ip_address }}: Endereço IP.
  • {{ user_agent }}: Agente do Usuário do Navegador do Remetente.
  • {{ url }}: URL da página web onde o formulário foi incorporado.
  • {{ referrer }}: URL da página web de onde o visitante chegou ao formulário.
  • {{ country }}: País do Remetente.
  • {{ city }}: Cidade do Remetente.
  • {{ longitude }}: A coordenada geográfica que especifica a posição leste-oeste do Remetente.
  • {{ latitude }}: A coordenada geográfica que especifica a posição norte-sul do Remetente.
  • {{ edit_link }}: Para exibir a URL para a Página Pública do Formulário para Editar uma Submissão. Você deve habilitar "Salvar no BD" & "Editável" para usar este recurso.
  • {{ optin_link }}: Para apresentar o link para a Página de Confirmação de Opt-In. Você deve habilitar "Salvar no BD" para usar este recurso.

Esta é uma ótima maneira de personalizar sua mensagem. Qualquer campo do formulário pode ser usado dessa forma.

Ferramenta de Auto-Sugestão

"Configurações do Formulário", "Regras do Formulário" e Complementos Premium permitem a substituição de espaços reservados por dados coletados pelos seus formulários. Para facilitar, implementamos uma ferramenta visual que permite selecionar campos do formulário sem precisar memorizá-los. Para usar esta ferramenta, basta digitar uma chave "{", e a lista de Campos do Formulário aparecerá, selecione o campo desejado e pronto.

iform4u - Personalizando a mensagem

Filtros

Filtros permitem alterar a saída de uma variável. Deve ser usado após a variável e separado por uma barra "|".

Usar Valores Padrão

Para campos não obrigatórios, você pode especificar um valor padrão a ser usado se não tiver nenhum valor.

Obrigado {{ Name | default: "amigo" }}, recebemos sua mensagem!

Para um usuário chamado John, isso leria “Obrigado John, recebemos sua mensagem!”. No entanto, se uma submissão não tivesse um nome, leria “Obrigado amigo, recebemos sua mensagem!”

Mudar Formatos de Data

Converte um timestamp em outro formato de data.

{{ created_at | date: "%a, %b %d, %y" }}

Saída: Sex, Jul 17, 20

{{ created_at | date: "%Y" }}

Saída: 2020

Usar Fuso Horário com Formatos de Data

{{ created_at | timezone: "America/New_York" | date: "%Y-%m-%d %H:%M" }}

Saída: 2020-07-17 01:00

Usar Localidade e Fuso Horário com Formatos de Data

As localidades são nomeadas de forma diferente em plataformas baseadas em Unix e Win32.

{{ date_1 | locale: "en_US" | timezone: "America/New_York" | date: "%A, %B %d, %y" }}

Saída: Segunda-feira, fevereiro 28, 22

Para Linux:

{{ date_1 | locale: "es_ES" | timezone: "America/New_York" | date: "%A, %B %d, %y" }}

Para Windows:

{{ date_1 | locale: "Spanish_Spain.1252" | timezone: "America/New_York" | date: "%A, %B %d, %y" }}

Saída: segunda-feira, fevereiro 28, 22

Codificação de URL

Para usar variáveis em URLs (por exemplo, para redirecionar o usuário para outra página), sugerimos usar o filtro url_encode.

O filtro url_encode converte quaisquer caracteres inseguros para URL em caracteres codificados em porcentagem. Por exemplo,

{{ "" | url_encode }}

Saída: john%40doe.com

Filtro de Nova Linha para Quebra

Em campos de Textarea, as novas linhas são salvas como /n, se a entrada de texto e a exibição no primeiro plano estiverem ambas em textarea, não há necessidade de fazer nenhum processamento. O estilo que você escreve em textarea será exibido corretamente de acordo com o estilo que você submeteu anteriormente.

No entanto, se você precisar exibir dados de Textarea como Conteúdo Dinâmico, você precisa considerar inserir uma quebra de linha HTML (
) na frente de cada nova linha (\n) em uma string.

{{ Sua Mensagem | newline_to_br }}

Saída:

Caro Time da ACME,

Estou escrevendo em referência à situação atual com o Projeto ABC. Temos uma série de perguntas que esperamos que você possa responder...

Assinatura

Podemos exibir uma assinatura de diferentes maneiras usando o filtro de assinatura, por exemplo, para exibir:

  • Assinatura como Dados Brutos (string JSON que inclui os pontos para reconstruir a assinatura)
{{ hidden_signature_1 }}
  • Assinatura como Imagem (tag img HTML)
{{ hidden_signature_1 | signature }}
  • Assinatura como URL de Dados (URL que pode ser inserida no atributo src de uma tag img)
{{ hidden_signature_1 | signature: 'data_url' }}
  • Assinatura como Dados Brutos (Segunda opção)
{{ hidden_signature_1 | signature: 'data' }}
  • Assinatura como Imagem (Segunda opção)
{{ hidden_signature_1 | signature: 'image' }}

Condicionais

Você pode usar lógica condicional no seu conteúdo. Você pode querer enviar o mesmo e-mail com diferenças para diferentes grupos. O caso de uso mais comum para isso é a localização de idioma, onde você quer enviar conteúdo diferente para diferentes usuários.

Usar Múltiplos Idiomas

No exemplo abaixo, se um usuário chamado John selecionar seu idioma preferido como espanhol, ele verá sua mensagem como "¡Hola, John!"

{% if Language == 'Spanish' %}
  ¡Hola {{ Name }}! 
{% elsif Language == 'French' %}
  Bonjour {{ Name }}!
{% else %}
  Hello {{ Name }}!
{% endif %}

Nota: Neste exemplo, "Language" é o rótulo do campo.

Exibir Imagens

Outro caso de uso comum é exibir várias imagens carregadas por um mesmo campo de arquivo em diferentes locais. Para isso, você pode fazer o seguinte:

{% if file_1[0] %}
<div class="image-item-1">
    <img src="{{ file_1[0] }}" width="300" height="300" alt="Primeira Imagem" />
</div>
{{% endif %}}

{% if file_1[1] %}
<div class="image-item-2">
    <img src="{{ file_1[1] }}" width="300" height="300" alt="Segunda Imagem" />
</div>
{{% endif %}}