Como Recuperar e Usar o Link de Formulários Conversacionais

Introdução

Gostaria de recuperar o link do Formulário Conversacional e usar este link dentro de um template PHP do seu tema? Usando um pequeno trecho de PHP, você pode facilmente obter este permalink para que possa usar uma instrução echo PHP para exibir este link dentro de um dos templates PHP do seu tema. Neste tutorial, vamos guiá-lo por cada etapa sobre como recuperar este permalink e, em seguida, exibir o link dentro de um template PHP.

Criando seu formulário

Primeiro, você precisará criar seu formulário conversacional. Se precisar de ajuda com isso, revise esta documentação.

Obtendo o link do formulário conversacional

Agora precisamos obter o link que é gerado pelo formulário conversacional. Para fazer isso, você precisará adicionar este trecho ao seu site.

Se precisar de ajuda para adicionar trechos ao seu site, consulte este tutorial.

/**
 * Get permalink from conversational forms.
 *
 * @link https://wpforms.com/developers/how-to-retrieve-and-use-the-link-from-conversational-forms
 */

function get_the_conversational_form_link( $form_id ) {

   // Form ID should be numeric.
   // Permalinks should be configured.
   if ( ! is_numeric( $form_id ) || empty( get_option( 'permalink_structure' ) ) ) {
      return;
   }

   $form      = wpforms()->form->get( $form_id );
   $form_data = wpforms_decode( $form->post_content );

   // Check if Conversational Form Mode is enabled.
   if ( empty( $form_data[ 'settings' ][ 'conversational_forms_enable' ] ) ) {
      return;
   }

   return esc_url( home_url( isset( $form->post_name ) ? $form->post_name : '' ) );
}

Esta função é uma função autônoma que receberá o $form_id que é atribuído ao chamar a função e recuperará o link para o formulário conversacional para esse formulário.

Quando você usa a função echo get_the_conversational_form_link( $form_id ); dentro de qualquer um dos seus templates PHP, a função obterá o permalink para aquele ID de formulário específico e exibirá o link dentro do seu template.

Usando a função

Agora é hora de usar esta função recém-criada dentro de um dos nossos templates de tema.

Para fins desta documentação, já criamos nosso tema filho e vamos editar o template usando nosso editor favorito.

Portanto, após nosso conteúdo principal, chamaremos a função para exibir um link para o formulário conversacional que já criamos em uma etapa anterior, para que ele apareça no final de cada página de postagem que temos em nosso site. Para que isso funcione, chamaremos a nova função do template single.php do nosso tema filho.

<?php /** Time to get the permalink from the conversation form **/
            // Define the $form_id variable with the form ID we want to use
            $form_id = 718;
      ?>
			
      <p>Have you tried this recipe before? Let us know what you though! <a href="<?php echo get_the_conversational_form_link( $form_id ); ?>" title="Cajun Steak Bites Recipe" target="_blank">Click here to leave a review for this recipe.</a></p>

Agora que colocamos nossa nova função e texto dentro do template PHP, podemos vê-la em ação em cada página única do nosso blog.

E é tudo o que você precisa para recuperar e usar o link dos formulários conversacionais. Gostaria também de adicionar seu próprio estilo a essas páginas? Confira nosso tutorial sobre Como Enfileirar uma Planilha para Formulários Conversacionais.