Come recuperare e utilizzare il link dai moduli conversazionali

Introduzione

Vuoi recuperare il link dai Moduli Conversazionali e utilizzarlo all'interno di un template PHP del tuo tema? Utilizzando un piccolo snippet PHP puoi facilmente ottenere questo permalink in modo da poter usare un'istruzione PHP echo per visualizzare questo link all'interno di uno dei template PHP del tuo tema. In questo tutorial, ti guideremo passo dopo passo su come recuperare questo permalink e poi visualizzarlo all'interno di un template PHP.

Creazione del tuo modulo

Dovrai prima creare il tuo modulo conversazionale. Se hai bisogno di aiuto, ti preghiamo di consultare questa documentazione.

Ottenere il link dal modulo conversazionale

Ora dobbiamo ottenere il link generato dal modulo conversazionale. Per fare ciò, dovrai aggiungere questo snippet al tuo sito.

Se hai bisogno di aiuto nell'aggiungere snippet al tuo sito, consulta 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 autonoma che prenderà il $form_id assegnato durante la chiamata alla funzione e recupererà il link al modulo conversazionale per quel modulo.

Quando usi la funzione echo get_the_conversational_form_link( $form_id ); all'interno di uno qualsiasi dei tuoi template PHP, la funzione otterrà il permalink per quell'ID modulo specifico e visualizzerà il link all'interno del tuo template.

Utilizzo della funzione

Ora è il momento di usare questa funzione appena creata all'interno di uno dei nostri template del tema.

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

Quindi, dopo il nostro contenuto principale, chiameremo la funzione per visualizzare un link al modulo conversazionale che abbiamo già creato in un passaggio precedente, in modo che appaia alla fine di ogni pagina di post sul nostro sito. Affinché ciò funzioni, chiameremo 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 ti serve per recuperare e utilizzare il link dai moduli conversazionali. Vuoi anche aggiungere il tuo stile a queste pagine? Dai un'occhiata al nostro tutorial su Come includere un foglio di stile per i Moduli Conversazionali.