Comment récupérer et utiliser le lien des formulaires conversationnels ?

Introduction

Aimeriez-vous récupérer le lien de Conversational Forms et utiliser ce lien à l'intérieur d'un modèle PHP de votre thème ? En utilisant un petit extrait de PHP, vous pouvez facilement récupérer ce permalien afin d'utiliser une instruction PHP echo pour afficher ce lien à l'intérieur d'un des modèles PHP de votre thème. Dans ce tutoriel, nous allons vous guider à travers chaque étape pour récupérer ce permalien et ensuite afficher le lien à l'intérieur d'un modèle PHP.

Création du formulaire

Vous devez d'abord créer votre formulaire conversationnel. Si vous avez besoin d'aide, consultez cette documentation.

Obtenir le lien à partir du formulaire conversationnel

Nous devons maintenant obtenir le lien généré par le formulaire conversationnel. Pour ce faire, vous devez ajouter cet extrait à votre site.

Si vous avez besoin d'aide pour ajouter des snippets à votre site, consultez ce tutoriel.

/**
 * 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 : '' ) );
}

Cette fonction est une fonction autonome qui prend l'identifiant $form_id attribué lors de l'appel de la fonction et qui récupère le lien vers le formulaire conversationnel pour ce formulaire.

Lorsque vous utilisez la fonction echo get_the_conversational_form_link( $form_id ); dans l'un de vos modèles PHP, la fonction récupérera le permalien pour cet identifiant de formulaire particulier et affichera le lien dans votre modèle.

Utilisation de la fonction

Il est maintenant temps d'utiliser cette fonction nouvellement créée dans l'un de nos modèles de thème.

Pour les besoins de cette documentation, nous avons déjà créé notre thème enfant et nous allons éditer le modèle en utilisant notre éditeur préféré.

Ainsi, après notre contenu principal, nous allons appeler la fonction pour afficher un lien vers le formulaire conversationnel que nous avons déjà créé dans une étape précédente afin qu'il apparaisse tout en bas de chaque page d'article que nous avons sur notre site. Pour que cela fonctionne, nous allons appeler la nouvelle fonction à partir du modèle single.php de notre thème enfant.

<?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>

Maintenant que nous avons placé notre nouvelle fonction et notre texte dans le modèle PHP, nous pouvons la voir en action sur chaque page de notre blog.

C'est tout ce dont vous avez besoin pour récupérer et utiliser le lien des formulaires conversationnels. Vous souhaitez également ajouter votre propre style à ces pages ? Consultez notre tutoriel sur Comment mettre en file d'attente une feuille de style pour les formulaires conversationnels.