Resumen de IA
¿Te interesa crear una Etiqueta Inteligente personalizada para mejorar la funcionalidad de tus formularios? Si contemplas la integración de una Etiqueta Inteligente personalizada, como incrustar un enlace de descarga en una notificación por correo electrónico o mensaje de confirmación, el proceso es sencillo con un fragmento de código personalizado. En esta guía, te explicaremos los pasos para utilizar PHP en la creación de una Etiqueta Inteligente a medida.
Las Etiquetas Inteligentes sirven como un medio conveniente para obtener dinámicamente datos específicos en campos de formulario o correos electrónicos de notificación. WPForms ofrece una gran cantidad de Etiquetas Inteligentes integradas, capaces de extraer información como la URL de la página actual o la dirección de correo electrónico de un usuario conectado, entre otras. Para una comprensión completa de las Etiquetas Inteligentes predefinidas en WPForms, consulta nuestra documentación.
Creación de la Etiqueta Inteligente personalizada
En el siguiente ejemplo, demostraremos cómo crear una nueva Etiqueta Inteligente personalizada diseñada específicamente para mostrar una URL para un enlace de descarga una vez que se completa un formulario. El proceso implica dos funciones PHP, cada una con un propósito distinto.
La primera función es responsable de crear la Etiqueta Inteligente. Está diseñada de tal manera que solo se requieren cambios básicos de nombre para personalizarla para cualquier otra Etiqueta Inteligente.
La segunda función es donde se implementará la mayor parte del código. Dentro de la declaración if, deberás agregar cualquier código necesario para obtener el valor o los valores que deseas que muestre esta Etiqueta Inteligente.
Para empezar, simplemente copia y pega ambas funciones en tu sitio web, asegurándote de personalizar el nombre de la Etiqueta Inteligente según sea necesario. Si no estás seguro de dónde o cómo agregar fragmentos a tu sitio, consulta este tutorial.
/**
* Register the Smart Tag so it will be available to select in the form builder.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_register_smarttag( $tags ) {
// Key is the tag, item is the tag name.
$tags[ 'download_link' ] = 'Download Link';
return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 );
/**
* Process the Smart Tag.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_process_smarttag( $content, $tag ) {
// Only run if it is our desired tag.
if ( 'download_link' === $tag ) {
// Replace our link in this demo with the URL you wish to provide
$link = 'https://yoursite.com/file.pdf';
// Replace the tag with our link.
$content = str_replace( '{download_link}', $link, $content );
}
return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 );
Nota: Los nombres de las Etiquetas Inteligentes solo pueden contener letras latinas minúsculas, dígitos y un guion bajo.
Creación del formulario
A continuación, creemos un formulario de boletín sencillo. Cuando los usuarios se registren en nuestro boletín, nuestro objetivo es proporcionarles un enlace gratuito para descargar un eBook. Esto sirve como una excelente ilustración de cómo aprovechar las capacidades de las Etiquetas Inteligentes de WPForms. Una vez que esta Etiqueta Inteligente esté establecida, podrás incorporarla sin esfuerzo en cualquier creación de formulario futura sin necesidad de ajustes de código adicionales.
Para cualquier ayuda sobre cómo crear un formulario, revisa esta documentación.
Uso de la nueva Etiqueta Inteligente personalizada
Ahora, pongamos en uso nuestra Etiqueta Inteligente personalizada recién creada. En este tutorial, incorporaremos la Etiqueta Inteligente para nuestro Enlace de Descarga en nuestras Notificaciones por correo electrónico.
Para empezar, navega al constructor de formularios y haz clic en Ajustes, luego selecciona Notificaciones. Dentro de los ajustes de Notificaciones, desplázate hacia abajo hasta el cuadro Mensaje de correo electrónico. Haz clic en el enlace Mostrar Etiquetas Inteligentes y navega por las Etiquetas Inteligentes disponibles hasta que localices la Etiqueta Inteligente Enlace de Descarga. Simplemente selecciónala y se agregará automáticamente a la plantilla de notificación.
Preguntas frecuentes
¿Puedo crear una etiqueta inteligente para agregar dinámicamente la configuración regional actual del sitio web?
Sí, puedes crear una etiqueta inteligente personalizada para recuperar la configuración regional actual de tu sitio web (por ejemplo, 'fr', 'de', 'en'). Aquí te mostramos cómo puedes implementarlo:
/**
* Register the Smart Tag so it will be available to select in the form builder.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_register_smarttag( $tags ) {
// Key is the tag, item is the tag name.
$tags[ 'page_locale' ] = 'Get Locale';
return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 );
/**
* Process the Smart Tag.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*
* WordPress get_locale(): https://developer.wordpress.org/reference/functions/get_locale/
*/
function wpf_dev_process_smarttag( $content, $tag ) {
// Only run if it is our desired tag.
if ( 'page_locale' === $tag ) {
// Stores the locale returned by the get_locale() function in the variable $locale
$locale = get_locale();
// Replace the tag with the $locale variable value.
$content = str_replace( '{page_locale}', $locale, $content );
}
return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 );
Este fragmento crea una nueva etiqueta inteligente llamada 'Obtener configuración regional' utilizando la función de WordPress get_locale().
Después de agregar el fragmento, puedes usar la etiqueta inteligente {page_locale} en tus formularios, notificaciones por correo electrónico o mensajes de confirmación.
¡Y eso es todo! Has creado con éxito una nueva etiqueta inteligente personalizada. ¿Te gustaría poder procesar esa etiqueta inteligente personalizada dentro de un campo de formulario HTML? Si es así, echa un vistazo a nuestro artículo sobre Cómo procesar etiquetas inteligentes en campos HTML.