Cómo procesar etiquetas inteligentes en etiquetas de campo

Introducción

¿Le gustaría procesar Smart Tags en las etiquetas de los campos de sus formularios? Con un pequeño fragmento de PHP, esto se puede lograr fácilmente. En este tutorial, te mostraremos cómo procesar Smart Tags en las etiquetas de los campos de tus formularios.

El uso de etiquetas inteligentes es una herramienta muy útil para extraer y mostrar dinámicamente datos específicos dentro de su formulario.

Por defecto, las etiquetas inteligentes no se procesarán si se colocan dentro de cualquier etiqueta de campo de su formulario.

Sin embargo, esta funcionalidad puede ser útil si, por ejemplo, desea mostrar un nombre de usuario conectado, la URL de su página o incluso mostrar otros detalles utilizando etiquetas inteligentes personalizadas.

Para el propósito de este tutorial, vamos a crear un formulario que sólo nuestros usuarios registrados pueden ver, por lo tanto, queremos hacerlo más personal mediante el uso de su nombre de pila dentro de la etiqueta de campo de un campo de formulario Párrafo.

Añadir el fragmento

Vamos a empezar por añadir nuestro snippet a nuestro sitio. Si necesitas ayuda sobre cómo añadir snippets a tu sitio, consulta este tutorial.

A continuación vamos a mostrarle dos métodos, uno que se dirige a un ID de formulario específico y otro que se aplicaría a todos los formularios. Sólo tiene que seleccionar el fragmento que desea utilizar.

Dirigirse a un ID de formulario específico

En este fragmento, sólo nos centramos en el ID del formulario 365. Si necesitas ayuda para encontrar el ID de tu formulario, consulta este tutorial.

/**
 * Run Smart Tags on all field labels.
 *
 * @link   https://wpforms.com/developers/how-to-process-smart-tags-in-field-labels/
 */
  
function wpf_dev_textarea_field_display( $field, $field_atts, $form_data ) {
    
    // Optional, you can limit to specific forms. Below, we restrict output to
    // form #365.
    if ( absint( $form_data[ 'id' ] ) !== 365 ) {
        return $field;
    }
	
    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    
    return $field;

}

add_filter( 'wpforms_textarea_field_display', 'wpf_dev_textarea_field_display', 10, 3 );

Uso para todos los WPForms

El código que se muestra a continuación permitiría esto en todos sus WPForms.

/**
 * Run Smart Tags on field labels in WPForms.
 *
 * @link   https://wpforms.com/developers/how-to-process-smart-tags-in-field-labels/
 */
 
function wpf_dev_textarea_field_display( $field, $field_atts, $form_data ) {

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    
    return $field;

}

add_filter( 'wpforms_textarea_field_display', 'wpf_dev_textarea_field_display', 10, 3 );

Creación del formulario

A continuación, vamos a crear nuestro formulario y añadir nuestros campos. El primer campo de formulario que vamos a añadir es un campo de texto de párrafo, vamos a utilizar nuestra nueva etiqueta inteligente dentro de la etiqueta del campo para obtener el nombre del usuario. Así que vamos a cambiar la etiqueta de este campo a Cuéntanos un poco sobre ti {user_first_name}.

una vez añadido el fragmento, ya puede utilizar las etiquetas inteligentes dentro de las etiquetas de campo

Si necesita ayuda para crear su formulario, consulte esta documentación.

Cuando se cargue el formulario, verá el nombre extraído de la nueva etiqueta inteligente.

La etiqueta inteligente se muestra ahora dentro de la etiqueta del campo

Uso de las etiquetas inteligentes en las notificaciones por correo electrónico

También puedes utilizar etiquetas inteligentes en tus notificaciones.

Para ello, vaya a Configuración desde el constructor de formularios y seleccione Notificaciones.

Mientras configura su mensaje de notificación por correo electrónico, puede seleccionar la opción Mostrar etiquetas inteligentes para incluir las etiquetas inteligentes que desee incluir en su mensaje

también puede utilizar las etiquetas inteligentes dentro de su notificación por correo electrónico para proporcionar una notificación más personal

Uso de etiquetas inteligentes en otras etiquetas de campos de formulario

A continuación, encontrará el fragmento necesario para cada uno de los diversos campos de formulario que puede procesar Smart Tags en la etiqueta para cada uno de estos campos específicos.

Como se mencionó anteriormente, estos fragmentos son específicos para un único ID de formulario. Si desea que estén disponibles para todos los formularios, simplemente elimine el bloque del fragmento que hace referencia al ID del formulario.

/**
 * Run Smart Tags on field labels in WPForms.
 *
 * @link   https://wpforms.com/developers/how-to-process-smart-tags-in-field-labels/
 */

// Run smart tags on text field label.
function wpf_dev_text_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_text_field_display', 'wpf_dev_text_field_display', 10, 3 );


// Run smart tags on textarea field label.
function wpf_dev_textarea_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_textarea_field_display', 'wpf_dev_textarea_field_display', 10, 3 );


// Run smart tags on checkbox field label.
function wpf_dev_checkbox_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_checkbox_field_display', 'wpf_dev_checkbox_field_display', 10, 3 );


// Run smart tags on email field label.
function wpf_dev_email_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_email_field_display', 'wpf_dev_email_field_display', 10, 3 );


// Run smart tags on select field label.
function wpf_dev_select_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_select_field_display', 'wpf_dev_select_field_display', 10, 3 );


// Run smart tags on radio field label.
function wpf_dev_radio_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_radio_field_display', 'wpf_dev_radio_field_display', 10, 3 );


// Run smart tags on number field label.
function wpf_dev_number_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_number_field_display', 'wpf_dev_number_field_display', 10, 3 );


// Run smart tags on name field label.
function wpf_dev_name_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_name_field_display', 'wpf_dev_name_field_display', 10, 3 );


// Run smart tags on phone field label.
function wpf_dev_phone_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_phone_field_display', 'wpf_dev_phone_field_display', 10, 3 );


// Run smart tags on address field label.
function wpf_dev_address_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_address_field_display', 'wpf_dev_address_field_display', 10, 3 );


// Run smart tags on URL field label.
function wpf_dev_url_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_url_field_display', 'wpf_dev_url_field_display', 10, 3 );


// Run smart tags on password field label.
function wpf_dev_password_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_password_field_display', 'wpf_dev_password_field_display', 10, 3 );


// Run smart tags on payment checkbox field label.
function wpf_dev_payment_checkbox_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_payment_checkbox_field_display', 'wpf_dev_payment_checkbox_field_display', 10, 3 );


// Run smart tags on payment multiple select field label.
function wpf_dev_payment_multiple_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_payment_multiple_field_display', 'wpf_dev_payment_multiple_field_display', 10, 3 );


// Run smart tags on single payment field label.
function wpf_dev_payment_single_field_display( $field, $field_atts, $form_data ) {

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

    $field[ 'label' ] = wpforms()->smart_tags->process( $field[ 'label' ], $form_data );
    return $field;

}

add_filter( 'wpforms_payment_single_field_display', 'wpf_dev_payment_single_field_display', 10, 3 );


Esta funcionalidad no admitirá datos introducidos por el usuario (por ejemplo, {field_id="3"}).

Y ya está. Ahora puede procesar sus Etiquetas Inteligentes dentro de las Etiquetas de campo. ¿Le gustaría procesar Etiquetas Inteligentes en descripciones de campo? Eche un vistazo a nuestro artículo sobre Cómo procesar etiquetas inteligentes en descripciones de campo.

Referencia del filtro: wpforms_textarea_field_display