### [Cómo crear una etiqueta inteligente personalizada](https://wpforms.com/developers/how-to-create-a-custom-smart-tag/) **Publicado:** 28 de julio de 2020 **Autor:** Umair Majeed **Extracto:** Este tutorial te mostrará cómo crear una etiqueta inteligente personalizada para usar dentro de tus WPForms. **Contenido:** ¿Estás interesado en crear una etiqueta inteligente personalizada para mejorar la funcionalidad de tus formularios? Si deseas integrar una etiqueta inteligente personalizada, como incrustar un enlace de descarga en un correo electrónico de notificación 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 para crear una etiqueta inteligente a medida. Las etiquetas inteligentes sirven como un medio conveniente para obtener datos específicos dinámicamente en los campos del formulario o en los 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](https://wpforms.com/docs/how-to-use-smart-tags-in-wpforms/ "Cómo usar etiquetas inteligentes en WPForms"). ## 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 los valores que deseas que muestre esta etiqueta inteligente. Para comenzar, 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](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "Cómo agregar PHP o JavaScript personalizado para WPForms"). ``` /** * Registra la etiqueta inteligente para que esté disponible para seleccionar en el constructor de formularios. * * @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/ */ function wpf_dev_register_smarttag( $tags ) { // La clave es la etiqueta, el elemento es el nombre de la etiqueta. $tags[ 'download_link' ] = 'Enlace de Descarga'; return $tags; } add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 ); /** * Procesa la etiqueta inteligente. * * @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/ */ function wpf_dev_process_smarttag( $content, $tag ) { // Solo se ejecuta si es nuestra etiqueta deseada. if ( 'download_link' === $tag ) { // Reemplaza nuestro enlace en esta demostración con la URL que deseas proporcionar $link = 'https://yoursite.com/file.pdf'; // Reemplaza la etiqueta con nuestro enlace. $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 **únicamente**. ## Creación del formulario A continuación, creemos un formulario sencillo de boletín informativo. Cuando los usuarios se suscriban a nuestro boletín, nuestro objetivo es proporcionarles un enlace gratuito para descargar un libro electrónico. Esto sirve como una excelente ilustración de cómo aprovechar las capacidades de las etiquetas inteligentes de WPForms. Una vez que se establezca esta etiqueta inteligente, puedes 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](https://wpforms.com/docs/creating-first-form/ "Cómo crear tu primer formulario"). ## 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 comenzar, navega al constructor de formularios y haz clic en **Configuración**, luego selecciona **Notificaciones**. Dentro de la configuración 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 encuentres 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: ``` /** * Registra la etiqueta inteligente para que esté disponible para seleccionar en el constructor de formularios. * * @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/ */ function wpf_dev_register_smarttag( $tags ) { // La clave es la etiqueta, el elemento es el nombre de la etiqueta. $tags[ 'page_locale' ] = 'Obtener Localización'; return $tags; } add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 ); /** * Procesa la etiqueta inteligente. * * @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 ) { // Solo se ejecuta si es nuestra etiqueta deseada. if ( 'page_locale' === $tag ) { // Almacena la configuración regional devuelta por la función get_locale() en la variable $locale $locale = get_locale(); // Reemplaza la etiqueta con el valor de la variable $locale. $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 Localización' utilizando la función `get_locale()` de WordPress. 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í, consulta nuestro artículo sobre [Cómo procesar etiquetas inteligentes en campos HTML](https://wpforms.com/developers/how-to-process-smart-tags-in-html-fields/ "Cómo procesar etiquetas inteligentes en campos HTML"). ## Filtros de referencia - [wpforms\_smart\_tags](https://wpforms.com/developers/wpforms_smart_tags/ "Uso del filtro wpforms_smart_tags") - [wpforms\_smart\_tag\_process](https://wpforms.com/developers/wpforms_smart_tag_process/ "Uso del filtro wpforms_smart_tag_process") **Categorías:** Tutoriales **Etiquetas:** PHP, Etiqueta inteligente ---