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

Introduction

Souhaitez-vous récupérer le lien des formulaires conversationnels et utiliser ce lien dans un modèle PHP de votre thème ? En utilisant un petit extrait de code PHP, vous pouvez facilement obtenir ce permalien afin de pouvoir utiliser une instruction d'écho PHP pour afficher ce lien dans l'un des modèles PHP de votre thème. Dans ce tutoriel, nous vous guiderons à travers chaque étape pour récupérer ce permalien, puis afficher le lien dans un modèle PHP.

Création de votre formulaire

Vous devrez d'abord créer votre formulaire conversationnel. Si vous avez besoin d'aide pour cela, veuillez consulter cette documentation.

Obtenir le lien du formulaire conversationnel

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

Si vous avez besoin d'aide pour ajouter des extraits de code à votre site, veuillez consulter 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 prendra le $form_id attribué lors de l'appel de la fonction et récupérera le lien du 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 obtiendra le permalien de cet identifiant de formulaire particulier et affichera le lien dans votre modèle.

Utilisation de la fonction

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

Aux fins de cette documentation, nous avons déjà créé notre thème enfant et nous allons modifier le modèle à l'aide de notre éditeur préféré.

Donc, 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 article de notre site. Pour que cela fonctionne, nous appellerons 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 le voir en action sur chaque page de notre blog.

Et c'est tout ce dont vous avez besoin pour récupérer et utiliser le lien des formulaires conversationnels. Souhaitez-vous é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.