do_action( 'wpforms_post_submissions_process', int $post_id, array $fields, array $form_data, int $entry_id  )

Description

L'action wpforms_post_submissions_process se déclenche lors du traitement des entrées du formulaire, après que la validation initiale des champs a réussi.

Paramètres

$post_id

int (Requis) ID de l'article.

$fields

array Valeurs/propriétés des champs d'entrée nettoyées.

$form_data

array Paramètres/données du formulaire.

$entry_id

int (Requis) ID de l'entrée.

Source

wpforms-post-submissions/src/Plugin.php

Plus d'informations

L'action wpforms_post_submissions_process se déclenche après la validation des champs, pendant le processus d'enregistrement de l'entrée.

Cette action enregistrera l'entrée et commencera la création de l'article à partir de la soumission.

Exemples

L'exemple montré ci-dessous créera des champs personnalisés pour les métadonnées à attribuer à l'article en utilisant la création de champs personnalisés WordPress.

Cet exemple va construire les liens de suivi social pour chaque article d'auteur soumis sur le formulaire ID 1159.

/**
 * Action fires after form submission and validation.
 *
 * @link   https://wpforms.com/developers/wpforms_post_submissions_process/
 *
 * @param  int      $post_id     Post ID.
 * @param  array    $fields      Sanitized entry field values/properties.
 * @param  array    $form_data   Form settings/data.
 * @param  int      $entry_id    Entry ID.
 *
 * @return array
 */

function wpf_dev_post_submissions_process( $post_id, $fields, $form_data, $entry_id ) {

    // Only do this for form #1159.
    if ( absint( $form_data[ 'id' ] ) !== 1159 ) {
        return;
    }

    /*
     * Field IDs, for reference.
     * 21 - Twitter URL
     * 22 - Facebook URL
     * 23 - Dribble URL
     * 24 - Instagram URL
     */

    // Below we're going to create our new custom content template,
    // using the field IDs listed above
    ob_start();
    ?>
    <h2><em>Author Social Follow Links</em></h2>
    <div class="social_links">
    <a href="<?php echo esc_url( $fields[21][ 'value' ] ); ?>" target="_blank"><img src="<?php echo get_template_directory_uri(); ?>/images/twitter.png" class="author_social_follow" width="80" height="80" alt="Follow me on Twitter!" /></a>
    <a href="<?php echo esc_url( $fields[22][ 'value' ] ); ?>" target="_blank"><img src="<?php echo get_template_directory_uri(); ?>/images/facebook.png" class="author_social_follow" width="80" height="80" alt="Follow me on Facebook!" /></a>
    <a href="<?php echo esc_url( $fields[23][ 'value' ] ); ?>" target="_blank"><img src="<?php echo get_template_directory_uri(); ?>/images/dribbble.png" class="author_social_follow" width="80" height="80" alt="Follow me on Dribbble!" /></a>
    <a href="<?php echo esc_url( $fields[24][ 'value' ] ); ?>" target="_blank"><img src="<?php echo get_template_directory_uri(); ?>/images/instagram.png" class="author_social_follow" width="80" height="80" alt="Follow me on Instagram!" /></a>
    </div>
    <?php
    $content = ob_get_clean();

    remove_filter( 'content_save_pre', 'wp_filter_post_kses' );
    remove_filter( 'content_filtered_save_pre', 'wp_filter_post_kses' );

    $post = array(
        'ID'           => $post_id,
        'post_content' => $content,
    );
    wp_update_post( $post );

    add_filter( 'content_save_pre', 'wp_filter_post_kses' );
    add_filter( 'content_filtered_save_pre', 'wp_filter_post_kses' );
}
add_action( 'wpforms_post_submissions_process', 'wpf_dev_post_submissions_process', 10, 4 );

Articles de référence

How to Build a Profile Form Using Post Submissions
How to Automatically Assign Tags and Categories to Post Submissions
How to Set a Default Featured Image for Post Submissions