Como Conectar Formulários Formidable

Ao utilizar o plugin do Formulário Formidable no Wordpress, você precisará tomar alguns passos adicionais para conectá-lo com a SharpSpring.

Este artigo mostra como conectar um Formulário Formidable com a SharpSpring.

Gerando Formulários Formidable

Para os que não forem desenvolvedores, esses podem gerar um código de integração dos Formulários Formidable com a Ferramenta de Integração com os Formulários Formidable da SharpSpring.

Alterando o Código: Valores do ID do Formulário

Devido à maneira que o plugin do Formidable lida com os preenchimentos, você não deve inserir um código de formulário nativo diretamente na página. Você ainda precisa gerar um código de formulário nativo, além de adicionar códigos adicionais e fazer algumas alterações no seu arquivo functions.php do Wordpress, para fazer funcionar. Para alterar o código do Wordpress, faça o seguinte:

1. Em uma aba do navegador, faça login no Wordpress.

2. Localize o seu arquivo functions.php.

3. Adicione o seguinte trecho de código no arquivo functions.php:

add_action('frm_after_create_entry', 'submitSharpSpring', 30, 2);

function submitSharpSpring($entry, $form_id){
// Um bloco de código será inserido aqui para cada formulário conectado
}

4. Na linha $form_id do código, adicione o número do ID do formulário, onde XXXX é o número do ID do formulário: if ($form_id == XXXX) {

5. Caso necessário, adicione linhas adicionais do código $form_id para cada formulário conectado.

Você pode rastrear múltiplos formulários Formidable em uma página inserindo o seu código adicional de formulário abaixo do primeiro trecho de código do formulário, dentro da mesma função. O exemplo de código fornecido possui múltiplos formulários Formidable rastreados na mesma página.

Nota: a SharpSpring oferece Serviços Profissionais para auxiliar na codificação personalizada.

Alterando o Código: Valores de Post URL

Uma vez que o código form_id tenha sido adicionado ao arquivo functions.php, você precisará inserir um código post_url. O valor $post_url vem do código incorporado do seu formulário nativo. É o valor BaseURI acompanhado do valor endpoint. Para adicionar valores post_url, faça o seguinte:

1. No arquivo functions.php, depois dos códigos form_id, insira uma linha. Considere o seguinte exemplo de código:

$post_url = 'https://app-3QEBQFRBMQ.marketingautomation.services/webforms/receivePostback/MxYwt7A0MDS3BAA/f91c3547-be72-4429-b964-54f12e24d76c/';

2. Insira o valor $post_url.

3. Abaixo do valor $post_url inserido, insira o seguinte: $body = array(

4. Dentro desta seção, insira uma linha para cada campo do formulário. Considere o seguinte exemplo de código:

'first_name' => $_POST['item_meta'][83],
'last_name' => $_POST['item_meta'][122],
'email' => $_POST['item_meta'][90],

5. Repita até que cada campo que você deseja capturar tenha sido incluído.

Ao inserir linhas para campos, o rótulo à esquerda pode ser qualquer valor alfanumérico, desde que não inclua ?, /, \, ou ().

Isso será usado para mapear os dados na SharpSpring. Dar um nome descritivo ao seu campo faz o mapeamento ficar mais fácil. O número entre os colchetes à direita de cada linha é o número do campo dentro dos Formulários Formidable.

Dentro dos Formulários Formidable, os grupos de caixas de seleção considerarão cada caixa de seleção como um campo separado. No entanto, a SharpSpring já espera que os grupos de caixas de seleção sejam enviados como uma lista de valores separados por vírgula, que é o padrão HTML para grupos de caixas de seleção. Caso você possua um grupo de caixa de seleção, a linha deve parecer um pouco diferente.

No seguinte exemplo, o imput 92 é um grupo de caixa de seleção. Para fazê-lo funcionar com um campo diferente, substitua o número do ID do campo:

'Issues' => implode(',',$_POST['item_meta'][92]),

Alterando o Código: Valores de Rastreamento

Uma vez que os códigos form_id e post_url tenham sido adicionados, você pode adicionar um cookie de rastreio ao formulário. Esse campo não aparece ao mapear os campos, e deve sempre possuir o nome 'trackingid__sb' com dois "underlines". Para adicionar o rastreamento, faça o seguinte:

1. No arquivo functions.php, após os códigos de mapeamento de campo do post_url, insira uma linha.

2. Insira o seguinte código de rastreamento: 'trackingid__sb' => $_COOKIE['__ss_tk']);

3. Depois do código de rastreamento acima, adicione o seguinte código:

$request = new WP_Http();
$response = $request->post( $post_url, array( 'body' => $body ) );

4. Insira uma chave de fechamento } depois do último formulário para fechar a função inteira. Considere o seguinte exemplo de código:

);
    $request = new WP_Http();
    $response = $request->post( $post_url, array( 'body' => $body ) );
}

Exemplo de Código Completo

O exemplo de código fornecido é completamente formado com um único formulário (Formidable Form 6) a ser capturado, juntamente com notas relevantes.

add_action('frm_after_create_entry', 'submitSharpSpring', 30, 2);

function submitSharpSpring($entry, $form_id){

if ($form_id == 6) { // Este será o número do formulário, como definido no Formidable. Este é um exemplo da captura do Form 6.
 // A linha abaixo é construída utilizando o seu código de formulário nativo. O valor do BaseURI forma a primeira parte do URL, acompanhado do endpoint.
 $post_url = 'https://app-3QEBQFRBMQ.marketingautomation.services/webforms/receivePostback/MzYwt7A0MDS3BAA/f91c3547-be72-4429-b964-54f12e24d76c/';
 $body = array(

      // Deve haver uma linha para cada campo do seu formulário. O nome à esquerda é como a SharpSpring vai recebê-lo. O número à direita é o número do campo dentro da SharpSpring.
      'first_name' => $_POST['item_meta'][83],
      'last_name' => $_POST['item_meta'][122],
      'email' => $_POST['item_meta'][90],
      // A linha abaixo, 'Issues', é um exemplo de como um grupo de caixas de seleção deve ser adicionado. Apenas utilize este método se o campo for um grupo de caixas de seleção.
      'Issues' => implode(',',$_POST['item_meta'][92]),

      // Esta linha deve estar presente em complemento aos seus campos, a fim de capturar o cookie estabelecer rastreamento no dispositivo.
      'trackingid__sb' => $_COOKIE['__ss_tk']
      );

    $request = new WP_Http();
    $response = $request->post( $post_url, array( 'body' => $body ) );
  }
}