Como recuperar e usar o link de formulários de conversação

Introdução

Você gostaria de recuperar o link do Conversational Forms e usá-lo em um modelo PHP do seu tema? Usando um pequeno trecho de PHP, você pode facilmente obter esse link permanente para que possa usar uma instrução PHP echo para exibir esse link dentro de um dos modelos PHP do seu tema. Neste tutorial, vamos orientá-lo em cada etapa sobre como recuperar esse link permanente e, em seguida, exibir o link em um modelo PHP.

Criando seu formulário

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

Obtendo o link do formulário de conversação

Agora precisamos obter o link que é gerado pelo formulário de conversação. Para fazer isso, você precisará adicionar este snippet ao seu site.

Se precisar de ajuda para adicionar snippets 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 : '' ) );
}

Essa 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 de conversação desse formulário.

Quando você usa o echo get_the_conversational_form_link( $form_id ); dentro de qualquer um de seus modelos PHP, a função obterá o permalink para esse ID de formulário específico e ecoará o link dentro de seu modelo.

Usando a função

Agora é hora de usar essa função recém-criada em um de nossos modelos de tema.

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

Portanto, após o conteúdo principal, chamaremos a função para exibir um link para o formulário de conversação que já criamos em uma etapa anterior, de modo que ele apareça na parte inferior de cada página de postagem que temos em nosso site. Para que isso funcione, chamaremos a nova função no modelo 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 modelo PHP, podemos vê-la em ação em todas as páginas do nosso blog.

E isso é tudo o que você precisa para recuperar e usar o link dos formulários de conversação. Gostaria de adicionar seu próprio estilo a essas páginas? Confira nosso tutorial sobre Como enfileirar uma folha de estilo para formulários de conversação.