Abrufen und Verwenden des Links von Konversationsformularen

Einführung

Möchten Sie den Link von Conversational Forms abrufen und diesen Link in einer PHP-Vorlage Ihres Themes verwenden? Mit einem kleinen PHP-Snippet können Sie diesen Permalink ganz einfach abrufen, so dass Sie eine PHP-Echo-Anweisung verwenden können, um diesen Link in einer der PHP-Vorlagen Ihres Themes anzuzeigen. In diesem Tutorial führen wir Sie Schritt für Schritt durch die Abfrage dieses Permalinks und die anschließende Ausgabe des Links in einer PHP-Vorlage per Echo.

Ihr Formular erstellen

Zuerst müssen Sie Ihr Gesprächsformular erstellen. Wenn Sie dabei Hilfe benötigen, lesen Sie bitte diese Dokumentation.

Abrufen des Links aus dem Konversationsformular

Jetzt brauchen wir den Link, der aus dem Gesprächsformular generiert wird. Dazu müssen Sie dieses Snippet zu Ihrer Website hinzufügen.

Wenn Sie Hilfe beim Hinzufügen von Snippets zu Ihrer Website benötigen, lesen Sie bitte dieses 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 : '' ) );
}

Diese Funktion ist eine eigenständige Funktion, die die $form_id nimmt, die beim Aufruf der Funktion zugewiesen wird, und die den Link zum Konversationsformular für dieses Formular abruft.

Wenn Sie die echo get_the_conversational_form_link( $form_id ); Funktion in einer Ihrer PHP-Vorlagen, wird die Funktion den Permalink für diese bestimmte Formular-ID abrufen und den Link in Ihre Vorlage einfügen.

Mit der Funktion

Nun ist es an der Zeit, diese neu erstellte Funktion in einer unserer Themenvorlagen zu verwenden.

Für die Zwecke dieser Dokumentation haben wir unser Child-Theme bereits erstellt und werden die Vorlage mit unserem bevorzugten Editor bearbeiten.

Nach dem Hauptinhalt rufen wir also die Funktion auf, die einen Link zum Gesprächsformular anzeigt, das wir bereits in einem früheren Schritt erstellt haben, damit es ganz unten auf jeder Beitragsseite unserer Website erscheint. Damit dies funktioniert, rufen wir die neue Funktion in der Vorlage single.php unseres Child-Themes auf.

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

Nachdem wir unsere neue Funktion und den Text in der PHP-Vorlage platziert haben, können wir sie nun auf jeder einzelnen Seite unseres Blogs in Aktion sehen.

Und das ist alles, was Sie brauchen, um den Link aus den Konversationsformularen abzurufen und zu verwenden. Möchten Sie diesen Seiten auch Ihr eigenes Styling hinzufügen? Schauen Sie sich unser Tutorial zum Thema " Enqueue a Stylesheet for Conversational Forms" an.