Como Recuperar e Utilizar o Link de Formulários Conversacionais

Introdução

Gostaria de obter a ligação a partir de Formulários de Conversação e usar esta ligação dentro de um modelo PHP do seu tema? Usando um pequeno trecho de código PHP pode facilmente obter esta ligação permanente para que possa usar uma declaração echo PHP para exibir esta ligação dentro de um dos modelos PHP do seu tema. Neste tutorial, vamos guiá-lo através de cada passo sobre como obter esta ligação permanente e, em seguida, exibir a ligação dentro de um modelo PHP.

Criar o seu formulário

Primeiro, terá de criar o seu formulário de conversação. Se precisar de ajuda com isto, reveja esta documentação.

Obter a ligação do formulário de conversação

Agora precisamos de obter a ligação que é gerada a partir do formulário de conversação. Para fazer isto, terá de adicionar este trecho ao seu site.

Se precisar de ajuda para adicionar trechos ao seu site, veja 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 obterá a ligação para o formulário de conversação para esse formulário.

Quando usar a função echo get_the_conversational_form_link( $form_id ); dentro de qualquer um dos seus modelos PHP, a função obterá a ligação permanente para esse ID de formulário específico e exibirá a ligação dentro do seu modelo.

Usar a função

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

Para efeitos desta documentação, já criámos o nosso tema filho e vamos editar o modelo usando o nosso editor preferido.

Portanto, após o nosso conteúdo principal, vamos chamar a função para exibir uma ligação para o formulário de conversação que já criámos num passo anterior para que apareça no final de cada página de publicação que temos no nosso site. Para que isto funcione, chamaremos a nova função a partir do 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 colocámos a nossa nova função e texto dentro do modelo PHP, podemos vê-la em ação em cada página individual do nosso blog.

E é tudo o que precisa para obter e usar a ligação de formulários de conversação. Gostaria também de adicionar o seu próprio estilo a estas páginas? Veja o nosso tutorial sobre Como Enfileirar uma Folha de Estilos para Formulários de Conversação.