Visualizza Markdown

Descrizione

L'azione wpforms_process_validate_textarea attiva la convalida sul campo modulo Testo Paragrafo quando il modulo viene inviato.

Parametri

$field_id
(int) ID del campo.
$field_submit
(array) Valore originale non sanificato inviato per il campo.
$form_data
(array) Impostazioni/dati del modulo elaborati, preparati per l'uso successivo.

Origine

wpforms/includes/fields/class-base.php

Maggiori Informazioni

L'azione wpforms_process_validate_textarea viene applicata a un array per il campo modulo Testo Paragrafo. Questa funzione può essere utilizzata per tutti i campi modulo do_action( wpforms_process_validate_{$field_type}, $field_id, $field_submit, $form_data ).

Ad esempio, per utilizzarla per un campo Email, useresti do_action( wpforms_process_validate_email, $field_id, $field_submit, $form_data ).

È importante notare che i valori dei campi non vengono sanificati fino a un momento successivo nell'elaborazione, in wpforms_process_format_{$field_type}.il

Esempi

Puoi usare questa azione per scansionare il Testo Paragrafo per un elenco di parole che vorresti bloccare l'invio del modulo, come la volgarità, oppure potresti usare questa azione per cercare determinate parole che attiverebbero un'altra azione come l'impostazione di un valore in un campo nascosto sul tuo modulo che puoi filtrare dalle voci.

In questo esempio, cercheremo eventuali volgarità in questo campo. Se ci sono volgarità, il modulo visualizzerà un errore e non verrà inviato.

/*
 * Check the paragraph text field for profanity.
 *
 * @link https://wpforms.com/developers/wpforms_process_validate_textarea/
 *
 * @param int     $field_id        Field ID.
 * @param array   $field_submit    Unsanitized field value submitted for the field.
 * @param array   $form_data       Form data and settings.
*/

    // Optional, you can limit to specific forms. Below, we restrict output to
    // form ID #1423.
    if ( absint( $form_data[ 'id' ] ) !== 1423 ) {
        return;
    }

function wpf_dev_profanity_filter_paragraph( $field_id, $field_submit, $form_data ) {
    //Create your list of profanity words separated by commas
    $blocked_words = array( 
        'badword1', 
        'badword2'
    );
 
    foreach( $blocked_words as $word ) {
        if(strpos($field_submit, $word) !== FALSE ) {
            wpforms()->process->errors[ $form_data[ 'id' ] ][ $field_id ] = esc_html__( 'No profanity allowed.', 'wpforms' );
            return;
        }
    }
 
}
 
add_action( 'wpforms_process_validate_textarea', 'wpf_dev_profanity_filter_paragraph', 10, 3 );

Riferimenti Articoli:

Ancora bloccato? Come possiamo aiutarti?
Ultimo aggiornamento il 14 Mar 2024