Dúvidas e Sugestões? https://github.com/ResultadosDigitais/rdstation-wp/issues
- Compatibilidade
- Instalação
- Configuração
- Múltiplas Integrações
- Campos personalizados
- Mapeamento de campos
Com este plugin você pode integrar qualquer formulário do seu site ou blog e ter controle sobre esses formulários integrados.
Endereço oficial: https://wordpress.org/plugins/integracao-rd-station/
O plugin Integração RD Station atualmente é compatível com os seguintes plugins de formulário:
Se o seu site ou blog foi desenvolvido pela Resultados Digitais, este plugin já está instalado e você pode pular para a parte de configuração. Caso contrário, siga estes passos:
Você pode instalar o plugin diretamente pelo seu painel do WordPress, clicando em Plugins, Adicionar novo e pesquise por Integração RD Station. Provavelmente será o único plugin a aparecer nos resultados da pesquisa. Basta clicar em Instalar e depois em Ativar. Seu plugin está funcionando e você já pode pular para a parte de configuração.
Caso você prefira instalar o plugin manualmente, você pode baixá-lo clicando neste link ou baixando o arquivo ZIP diretamente pelo endereço oficial.
Para instalá-lo no seu site, você precisa entrar no seu painel do WordPress, clicar em Plugins, Adicionar novo e depois em Fazer upload do plugin. Então selecione o arquivo que você baixou e clique em Instalar agora. Se o plugin foi instalado com sucesso, clique em Ativar plugin.
Depois de instalar o plugin, irá aparecer um item no seu menu WordPress, de acordo com o plugin de formulários que você tem instalado e ativo. Se você tem o Contact Form 7, irá aparecer RD Station CF7, já se você tiver o Gravity Forms, irá aparecer RD Station GF. Se você tiver os dois formulários instalados, ambos estarão ativos no seu menu, e você pode usar os dois formulários simultaneamente sem problemas.
A integração no Contact Form 7 só irá funcionar com formulários que possuem um campo chamado email ou your-email. Sem esse campo, a API do RD Station não realiza a conversão dos leads.
Para fazer uma integração, clique no item RD Station CF7 que apareceu no menu do seu painel. Para criar uma nova integração, basta clicar em Criar integração e preencher os dados solicitados no formulário.
Crie um título para sua integração, apenas para organizar suas integrações e encontrá-la posteriormente no seu painel.
No campo Identificador, crie um Identificador para seu formulário. Isso é importante para você saber qual o formulário de origem do lead.
Preencha o campo Token RD Station com o seu Token Público do RD Station. Este token, você pode encontrar em: http://rdstation.com.br/integracoes
Por último, selecione qual formulário você deseja integrar. Este campo traz uma lista com todos os formulários criados no Contact Form 7.
Clique em Integrar. Pronto, seu formulário escolhido está integrado ao RD Station.
Para a integração com o Gravity Forms funcionar, você precisa ter pelo menos um campo do tipo e-mail no seu formulário.
Veja como criar campos do tipo e-mail no Gravity Forms na Central de Ajuda do RD Station
Para fazer uma integração, clique no item RD Station GF que apareceu no menu do seu painel. Após isso o processo para criar uma nova integração é o mesmo do Contact Form 7: clique em Criar integração e preencha os dados solicitados no formulário.
Siga os mesmos passos usados no Contact Form 7
Clique em Integrar e seu formulário escolhido está integrado ao RD Station.
Você pode integrar quantos formulários for necessário. Além disso, você também pode integrar um único formulário a mais de uma conta no RD Station, criando duas integrações com tokens diferentes. Isso pode ser útil quando você criar alguma campanha com um parceiro, e precisa gerar o lead para as duas contas.
Para que os dados de um campo do formulário sejam enviados como campo personalizado para o seu RD Station, você só precisa criar um campo no formulário com o mesmo nome definido no RD Station. Por exemplo, se você tem um campo personalizado chamado idioma, você só precisa criar um campo no seu formulário com name="idioma".
Se você usa o Gravity Forms, deve ter percebido que quando um formulário é criado, os campos são gerados com nomes não amigáveis, por exemplo: input_1, input_2, input_3... Em consequencia disto, os leads chegam no RD Station de uma forma difícil de ser identificada.
Na página de configuração das integrações, você pode definir o nome de cada campo do seu formulário. Você pode dizer, por exemplo, que o campo input_1 vai se chamar nome e o input_2 será cidade.
Você pode contribuir com o plugin, criando novas integrações e sugerindo melhorias
A primeira coisa que você tem a fazer, é criar um fork do repositório. Ao fazer um fork, você terá esse repositório clonado em sua conta do GitHub e poderá trabalhar nela tranquilamente.
O plugin gera os metaboxes para o Identificador e Token RD Station automaticamente.
Cada plugin de formulário tem uma forma específica de chamar os formulários cadastrados, portanto, o campo de seleção dos formulários não é gerado automaticamente.
Para gerar esse campo, você precisa criar um arquivo dentro da pasta metaboxes.
O nome do arquivo deve ser a concatenação das letras rd com a sigla do plugin. Para o Contact Form 7, por exemplo, criamos o nome da seguinte forma: rdcf7.php. Para o Gravity Forms, ficou assim: rdgf.php.
No arquivo que você criou, é preciso chamar o RD_Metabox.php e criar uma classe herdando a RD_Metabox. Essa classe também precisa ter a regra de nomenclatura citada acima (rd + abreviação do plugin), só que com letras maiúsculas.
Você precisa também ter uma função chamada form_id_box_content. Ela que irá renderizar o conteúdo na tela.
Veja um exemplo abaixo:
<?php
require_once('RD_Metabox.php');
class RDCF7 extends RD_Metabox {
function form_id_box_content(){
// Retorna um select com os formulários criados
}
}
?>Cada plugin de formulário tem sua particularidade, portanto precisamos criar uma função separada para cada plugin que iremos fazer a integração. Hoje temos as funções contact_form_7 e gravity_forms.
Para criar uma regra de envio dos leads, você precisa criar uma função dentro do arquivo lead_conversion.php.
Dentro desta função, você precisa recuperar os dados que o usuário preencheu no formulário. Você precisa armazenar estes dados como uma array dentro de $this->form_data.
Após isso, você precisa chamar uma função para gerar alguns campos estáticos obrigatórios na conversão. Nesta função, você passa como parâmetros o identificador do formulário e o nome do plugin que você está integrando. Por exemplo:
$this->generate_static_fields($form->ID, 'Plugin Contact Form 7');Depois de gerar os campos estáticos, basta chamar a função que realiza a conversão, e passar a variável $this->form_data como parâmetro, como no exemplo abaixo:
$this->conversion($this->form_data);O resultado da função irá ficar algo parecido com isso:
public function contact_form_7($cf7){
// Crie suas regras para obter os dados enviados no formulário
// Atribua os dados obtidos à variável $this->form_data
$this->form_data = $posted_data;
// Chame a função que irá gerar os campos estáticos
$this->generate_static_fields($form->ID, 'Plugin Contact Form 7');
// Chame a função que irá realizar o envio para o RD Station
$this->conversion($this->form_data);
}Feito isso, tudo que você precisa é chamar todas estas configurações no arquivo principal do plugin, desta forma:
new RD_Custom_Post_Type ( $acronym, $name, $slug, $plugin_path );
new LeadConversion($callback, $submit_action);$acronym
Nome do plugin abreviado, com letras maísculas. Por exemplo: CF7
$name
Nome completo do plugin, por exemplo: Contact Form 7
$slug
rd + sigla do plugin, em letras minúsculas. Exatamente o mesmo nome que você usou no arquivo de metabox. Ex.: rdcf7
$plugin_path
Caminho do plugin de formulário de contato que você está integrando (pasta-do-plugin/nome-do-plugin.php). Por exemplo: contact-form-7/wp-contact-form-7.php.
$callback
Nome completo do plugin, com letras minúsculas e separados por _. Ex.: contact_form_7.
$submit_action
Nome da função de envio do plugin de formulário. No Contact Form 7, por exemplo, é: wpcf7_mail_sent
Veja um exemplo com o Contact Form 7:
$contact_form_7 = new RD_Custom_Post_Type ( 'CF7', 'Contact Form 7', 'rdcf7', 'contact-form-7/wp-contact-form-7.php' );
new LeadConversion('contact_form_7', 'wpcf7_mail_sent');Estas são as alterações necessárias para criar uma nova integração. Existem atualmente duas integrações criadas, tente usá-las como exemplo para facilitar a criação de uma nova.