A conexão do Ninja Forms 3 à SharpSpring requer uma abordagem diferente do uso tradicional do código de incorporação (embed code) de formulário nativo.
Além disso, a técnica é diferente daquela utilizada com o Ninja Forms 2.
Este artigo detalha como integrar o Ninja Forms 3 à SharpSpring.
Usuários com acesso:
-
Administradores
Modificar o Código do Wordpress
Para conectar o Ninja Forms 3 com os formulários nativos na SharpSpring, é necessário modificar o código do Wordpress. Para modificá-lo, faça o seguinte:
-
Em uma aba do navegador, faça o login no Wordpress.
-
Clique em Aparência > Editor > Funções do Tema.
-
Abra o seu arquivo functions.php do Wordpress.
-
Cole o seguinte código no arquivo functions.php:
add_action( 'ninja_forms_after_submission', 'send_ninja_form_to_sharpspring' );
function send_ninja_form_to_sharpspring($formData){
$formFields = $formData['fields_by_key'];
foreach($formFields as $formField):
if($formField['key']=='sharpspring_post_url')://if this field is the sharpspring post url
$post_url = $formField['value'];
else://it's a form field, so let's add it to the body
//if they specified an admin label to make it easier to map fields in sharpspring, use it
$trimmedName = trim($formField['admin_label']);
if(!empty($trimmedName)):
$fieldNiceName = $formField['admin_label'];
else://use the field key
$fieldNiceName = $formField['key'];
endif;
//add this field to the body
if($formField['type'] != 'listcheckbox' && $formField['type'] != 'listmultiselect'):
$body[$fieldNiceName] = $formField['value'];
else://implode values if it is a checkbox or multi-select
$body[$fieldNiceName] = implode(',',$formField['value']);
endif;
endif;
endforeach;
$body['trackingid__sb'] = $_COOKIE['__ss_tk']; //DO NOT CHANGE THIS LINE... it collects the tracking cookie to establish tracking
$request = new WP_Http();
$response = $request->post( $post_url, array( 'body' => $body ) );
}
Nota: a SharpSpring oferece serviços profissionais para ajudar com a customização de códigos. Para isso, entre em contato com o seu consultor de sucesso.
Gerar Códigos Embed de Formulários Nativos
Para conectar ao Ninja Forms 3, será necessário gerar um código embed de formulário nativo.
Para gerar códigos embed de formulários nativos, faça o seguinte:
-
Em outra aba do navegador, logue na SharpSpring.
-
Na barra de ferramentas superior da SharpSpring, clique em Marketing > Conteúdo > Formulários.
-
Clique no ícone de três pontos para ir em Ações > Código Incorporado.
-
Copie e mantenha esse código disponível para referências futuras.
Nota: ao conectar o Ninja Forms 3, você não deve colocar o código embed do formulário nativo na página. Entretanto, você precisará gerar um código para cada formulário, a fim de recorrer a ele.
Conectar o Ninja Forms 3
Será necessário modificar um formulário e conectar o Ninja Forms 3 a formulários nativos na SharpSpring.
Para conectar ao Ninja Forms 3, faça o seguinte:
-
Em outra aba do navegador, acesse o Ninja Forms.
-
Crie ou edite um Ninja Form.
-
Dentro do editor de formulários do Ninja Forms, adicione um campo oculto em seu formulário.
-
Defina o Field Key e o Selo de Administrador (Admin Label) como 'sharpspring_post_url'.
-
Combine os valores do baseURI e do endpoint para gerar o post URL deste formulário.
-
Defina o Valor Padrão para o post URL deste formulário.
-
Defina o post URL como o Valor Padrão para o campo oculto.
-
Se desejar, atribua um Selo de Administrador para cada um de seus campos.
-
Salve e envie o formulário.
-
Volte à aba do navegador em que a SharpSpring está aberta.
-
Mapeie o formulário na SharpSpring.
Nota: o Developer Mode do Ninja Forms deve estar habilitado para visualizar e fazer modificações no Field Key e Selo de Administrador (Admin Label).
Exemplo de Post URL
Ao gerar o post URL
, os códigos do baseURI
e do endpoint
devem estar semelhantes ao seguinte exemplo de código:
__ss_noform.push(['baseURI', 'https://app-3Q4K3MJUEA.marketingautomation.services/webforms/receivePostback/MzYwNzKzMDM0BAA/']);
__ss_noform.push(['endpoint', 'f65d1953-da63-489b-8b68-9d1684a8d93b']);
Quando combinados, o seguinte post URL
é criado:
https://app-3Q4K3MJUEA.marketingautomation.services/webforms/receivePostback/MzYwNzKzMDM0BAA/f65d1953-da63-489b-8b68-9d1684a8d93b
Considerações sobre Formulários
Ao conectar com o Ninja Forms 3, esteja ciente do que segue:
-
Tenha cuidado ao mapear campos. Adicionar Selos de Administrador torna mais fácil o processo de mapeamento na SharpSpring. É o que aparecerá no lugar do ID do campo ao realizar o mapeamento. Apesar de opcional, isso pode ajudar a diferenciar os campos, caso os valores enviados não deixarem isso claro.
-
São necessários códigos de formulários individuais. Ao adicionar novos Ninja Forms, você não precisa seguir o passo de adicionar o código no functions.php, pois o bloco único de códigos dará conta de todos os formulários. Qualquer formulário com um campo oculto intitulado
'sharpspring_post_url'
que contém um URL válido deve estar disponível para mapeamento e captura na SharpSpring. Tenha certeza de que você está utilizando um novo código de formulário nativo para criar opost URL
para cada formulário, pois todos devem ser únicos.
-
Tome cuidado ao modificar o Wordpress. Esteja ciente de que, caso algum código de formulário nativo da SharpSpring já tenha sido colocado na página para tal formulário anteriormente, o código deve ser removido para não interferir. Além disso, alterações no functions.php podem resultar em falhas de carregamento do site, incluindo a página de login do Wordpress. Você deve estar preparado para reverter, via FTP, ao seu functions.php anterior, caso algum erro erro não permita o site carregar.
Comentários
0 comentário
Artigo fechado para comentários.