Come recuperare e utilizzare il collegamento dai moduli conversazionali

Introduzione

Volete recuperare il link da Conversational Forms e utilizzarlo all'interno di un template PHP del vostro tema? Utilizzando un piccolo snippet PHP, potete facilmente recuperare questo permalink in modo da poter utilizzare un'istruzione PHP echo per visualizzare questo link all'interno di uno dei template PHP del vostro tema. In questo tutorial, vi illustreremo tutti i passaggi per recuperare questo permalink e poi fare l'eco del link all'interno di un template PHP.

Creazione del modulo

Per prima cosa è necessario creare il modulo di conversazione. Se avete bisogno di aiuto, consultate la documentazione.

Ottenere il link dal modulo di conversazione

Ora dobbiamo ottenere il link generato dal modulo di conversazione. Per farlo, è necessario aggiungere questo snippet al sito.

Se avete bisogno di aiuto per aggiungere gli snippet al vostro sito, consultate questo 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 : '' ) );
}

Questa funzione è una funzione indipendente che prende il $form_id che viene assegnato quando si chiama la funzione e recupera il link al modulo di conversazione per quel modulo.

Quando si utilizza l'opzione echo get_the_conversational_form_link( $form_id ); all'interno di uno qualsiasi dei vostri template PHP, la funzione otterrà il permalink per quel particolare ID modulo e riporterà il link all'interno del vostro template.

Utilizzando la funzione

Ora è il momento di utilizzare questa funzione appena creata all'interno di uno dei nostri modelli di tema.

Ai fini di questa documentazione, abbiamo già creato il nostro tema figlio e modificheremo il template utilizzando il nostro editor preferito.

Quindi, dopo il nostro contenuto principale, chiameremo la funzione per visualizzare un link al modulo di conversazione che abbiamo già creato in un passo precedente, in modo che appaia in fondo a ogni pagina di post che abbiamo sul nostro sito. Per far sì che questo funzioni, richiameremo la nuova funzione dal template single.php del nostro tema figlio.

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

Ora che abbiamo inserito la nostra nuova funzione e il testo all'interno del template PHP, possiamo vederla in azione su ogni singola pagina del nostro blog.

E questo è tutto ciò che serve per recuperare e utilizzare il link dai moduli di conversazione. Volete aggiungere il vostro stile a queste pagine? Consultate il nostro tutorial su Come inserire un foglio di stile per i moduli di conversazione.