Jekyll

Sites Jekyll são estáticos, o que combina com um envio de formulário comum. Mantenha o formulário em um include para que todas as páginas usem o mesmo markup e o id do formulário fique em um só lugar.

Configuração

1. Adicione as configurações ao _config.yml

   url: "https://example.com"
   ikiform:
     form_id: frm_xxxxxxxxxxxxxxxx
     thanks: /thanks/

   O include monta o redirecionamento com absolute_url, que precisa de url. Sem ele, o redirecionamento é só um caminho, e o Ikiform ignora qualquer coisa que não seja uma URL https: completa. Em um site de projeto do GitHub Pages, defina também baseurl: /repo; o absolute_url o adiciona para você.

2. Crie o include

   {%- assign form_id = include.form_id | default: site.ikiform.form_id -%}
   {%- assign thanks = include.thanks | default: site.ikiform.thanks -%}
   <form class="ikiform" action="https://ikiform.com/f/{{ form_id }}" method="post">
     <label>Email <input name="email" type="email" autocomplete="email" required></label>
     <label>Message <textarea name="message" rows="5"></textarea></label>
     {%- if include.subject %}
     <input type="hidden" name="_subject" value="{{ include.subject | escape }}">
     {%- endif %}
     {%- if thanks %}
     <input type="hidden" name="_redirect" value="{{ thanks | absolute_url }}">
     {%- endif %}
     <input name="_gotcha" type="text" tabindex="-1" autocomplete="off" hidden>
     <button type="submit">{{ include.button | default: "Send" }}</button>
   </form>

3. Use

   ---
   layout: page
   title: Contact
   ---
   
   Questions about pricing? Write to us.
   
   {% include ikiform-form.html subject="Pricing question" %}

   O include funciona em páginas, posts e layouts. Passe form_id para usar outro formulário, thanks para outro redirecionamento e button para o texto do botão.

4. Adicione a página de agradecimento

   ---
   layout: page
   title: Thanks
   permalink: /thanks/
   ---
   
   Thanks, we got your message.

_redirect só é seguido quando o formulário tem domínios permitidos que incluem o seu site. Veja Regras para _redirect.

Domínios permitidos

O GitHub Pages é o host mais comum para Jekyll, então muitas vezes você vai precisar de duas entradas: o host github.io e o seu domínio próprio.

• Nunca adicione github.io sozinho. Todo site naquele host corresponderia, inclusive os de outras pessoas.

Checklist de teste

1. Rode bundle exec jekyll serve e veja o código-fonte da página. O action deve terminar no id do seu formulário.
2. Envie localmente. Você vai cair na página de agradecimento do Ikiform: o jekyll serve define url como http://localhost:4000, e redirecionamentos http: não são seguidos.
3. Faça push, espere o build do Pages e envie a partir de username.github.io. Confirme que o envio não está marcado como spam.
4. Envie no seu domínio próprio e confirme que você chega a /thanks/.

Solução de problemas

Relacionados

• HugoUm partial e um shortcode para arquivos de conteúdo.
• EleventyUm shortcode para Nunjucks, Liquid e Markdown.
• Formulários HTMLRedirecionamentos, campos reservados e o honeypot.
• Domínios permitidosComo as origens são comparadas e o que acontece quando não correspondem.