Cómo recuperar y usar el enlace de Formularios Conversacionales

Introducción

¿Le gustaría recuperar el enlace de Formularios Conversacionales y usar este enlace dentro de una plantilla PHP de su tema? Usando un pequeño fragmento de PHP puede obtener fácilmente este permalink para que pueda usar una declaración echo de PHP para mostrar este enlace dentro de una de las plantillas PHP de su tema. En este tutorial, le guiaremos paso a paso sobre cómo recuperar este permalink y luego mostrar el enlace dentro de una plantilla PHP.

Creación de su formulario

Primero necesitará crear su formulario conversacional. Si necesita ayuda con esto, por favor revise esta documentación.

Obtener el enlace del formulario conversacional

Ahora necesitamos obtener el enlace que se genera desde el formulario conversacional. Para hacer esto, necesitará agregar este fragmento a su sitio.

Si necesita ayuda para añadir fragmentos a su sitio, 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 función es una función independiente que tomará el $form_id que se asigna al llamar a la función y recuperará el enlace al formulario conversacional para ese formulario.

Cuando use la función echo get_the_conversational_form_link( $form_id ); dentro de cualquiera de sus plantillas PHP, la función obtendrá el permalink para ese ID de formulario en particular y mostrará el enlace dentro de su plantilla.

Usando la función

Ahora es el momento de usar esta función recién creada dentro de una de las plantillas de nuestro tema.

Para el propósito de esta documentación, ya hemos creado nuestro tema hijo y vamos a editar la plantilla usando nuestro editor favorito.

Así que después de nuestro contenido principal, llamaremos a la función para mostrar un enlace al formulario conversacional que ya hemos creado en un paso anterior para que aparezca al final de cada página de publicación que tengamos en nuestro sitio. Para que esto funcione, llamaremos a la nueva función desde la plantilla single.php de nuestro tema hijo.

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

Ahora que hemos colocado nuestra nueva función y texto dentro de la plantilla PHP, podemos verla en acción en cada página individual de nuestro blog.

Y eso es todo lo que necesita para recuperar y usar el enlace de los formularios conversacionales. ¿Le gustaría también agregar su propio estilo a estas páginas? Consulte nuestro tutorial sobre Cómo incluir una hoja de estilos para Formularios Conversacionales.