Introdução
Gostaria de obter o link do Conversational Forms e utilizá-lo num modelo PHP do seu tema? Usando um pequeno snippet de PHP, você pode facilmente pegar esse permalink para que você possa usar uma instrução PHP echo para exibir esse link dentro de um dos modelos PHP do seu tema. Neste tutorial, vamos guiá-lo através de cada passo sobre como obter este permalink e, em seguida, ecoar o link dentro de um modelo PHP.
Criar o seu formulário
Primeiro, tem de criar o seu formulário de conversação. Se precisar de ajuda com isto, consulte esta documentação.
Obter a ligação a partir do formulário de conversação
Agora precisamos de obter o link que é gerado a partir do formulário de conversação. Para o fazer, terá de 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 : '' ) );
}
Esta função é uma função autónoma que recebe o $form_id que é atribuído ao chamar a função e recupera a ligação para o formulário de conversação desse formulário.
Quando se utiliza o echo get_the_conversational_form_link( $form_id ); dentro de qualquer um dos seus modelos PHP, a função obterá o permalink para esse ID de formulário específico e ecoará o link dentro do seu modelo.
Utilizar a função
Agora é altura de utilizar esta função recém-criada dentro de um dos nossos modelos de tema.
Nunca recomendamos fazer alterações nos ficheiros PHP dos seus temas sem primeiro criar um tema filho para o fazer. Se precisar de ajuda para criar um tema filho, consulte este tutorial dos nossos amigos do WPBeginner.
Para efeitos desta documentação, já criámos o nosso tema filho e vamos editar o modelo utilizando o nosso editor favorito.
Assim, depois do nosso conteúdo principal, vamos chamar a função para mostrar um link para o formulário de conversação que já criámos num passo anterior, para que apareça no fundo de cada página de publicação que temos no nosso site. Para que isto funcione, vamos chamar 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 no modelo PHP, podemos vê-la em ação em todas as páginas do nosso blogue.
E é tudo o que precisa para recuperar e utilizar a ligação dos 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 colocar uma folha de estilos em fila para formulários de conversação.