Oculto

El Campo oculto es el único control en los complementos maestros Creador de widgets que los editores nunca ven. Tiene un valor fijo que estableces una vez en el generador, digamos una cadena de versión o una clave de diseño. El valor viaja con el widget e imprime a través de un token de plantilla, pero no aparece ninguna entrada en ninguna parte del panel Elementor.

Incluso el campo Oculto lo admite Condiciones, y su valor almacenado se imprime a través del Motor de plantilla de sintaxis de ramita como cualquier otro token, puedes hacer referencia a él {% if %} consulta toda tu plantilla. Ambas guías cubren los detalles.

Eso lo convierte en el hogar adecuado para las constantes que necesita su plantilla, pero los usuarios no deben editar. Cualquier cosa que un cliente curioso pueda cambiar por accidente permanece fuera de su alcance. Sus paneles HTML, CSS y JS aún pueden leerlo como cualquier otro valor.

Lo que hace el campo Oculto #

• Almacena un valor de cadena fijo definido en el constructor, sin control visible en Elementor.
• Imprime ese valor en cualquier parte del panel HTML, CSS o JS del widget {{ your_field_name }}.
• Mantiene las constantes de configuración fuera de la interfaz de usuario de edición, por lo que no se pueden cambiar por página.
• Se comporta como un valor de texto en lógica de plantilla, por lo que condicionales como {% if mode == 'embed' %} trabajar.

Si este es su primer widget personalizado, lea el Descripción general del creador de widgets antes de esta página; cubre el diseño del editor que asumen los documentos de campo.

Antes de empezar #

• WordPress con Elementor instalado y activo.
• Complementos maestros para Elementor instalado y activo. ¿Nuevo en el complemento? Ver el guía de instalación.
• Se abre un widget personalizado en el editor Widget Builder. Nuestro ejemplo es un widget de inserción de mapas donde se nombra un campo oculto map_style_key lleva el identificador de estilo de mapa fijo que espera el script de inserción.

Cómo agregar un campo oculto #

Arrastra el Oculto campo desde el panel de campos a cualquier sección. La pestaña no importa aquí, ya que nada se representa en el panel de ninguna manera. Sus opciones se abren a la izquierda tan pronto como aterriza.

Se explican las opciones de campo ocultas #

La lista de opciones es corta por diseño:

• Etiqueta: un nombre para tu propia referencia dentro del constructor. Nunca se muestra en Elementor.
• Nombre: el identificador único al que se refieren sus plantillas. Sólo letras, números y guiones bajos, por ejemplo map_style_key.
• Predeterminado: el valor que tiene el campo. Dado que no hay una interfaz de usuario que la cambie más tarde, este es efectivamente el valor, punto.

Conecte el campo Oculto con su token #

El campo Oculto es un campo de token. Imprímelo exactamente como un valor de texto, en cualquiera de los tres paneles:

<!-- HTML panel -->
<div class="ma-map" data-style="{{ map_style_key }}"></div>

// JS panel
var styleKey = "{{ map_style_key }}";
initMap(styleKey);

La lógica de plantilla también puede bifurcarse en él. Si envía dos modos internos del mismo widget, un campo oculto puede elegir la rama sin exponer la elección:

{% if widget_mode == 'compact' %}
<div class="ma-map ma-map--compact"></div>
{% else %}
<div class="ma-map ma-map--full"></div>
{% endif %}

Un modo de falla silencioso que debes conocer: si cambias el nombre del campo más tarde, cada token que aún apunta al nombre anterior imprime una cadena vacía. Nada de error, el widget simplemente se representa en blanco donde solía estar la constante. Después de cambiar el nombre, busque en los tres paneles el nombre anterior antes de guardarlo.

Ai grijă: un campo oculto es invisible, no secreto. Su valor aún se representa en el marcado de la página o en el script que los visitantes pueden ver-fuente. Mantenga fuera de él las claves y credenciales de API privadas; es para constantes de configuración, no para secretos.

Utilice el campo Oculto en Elementor #

Agregue su widget personalizado a una página en Elementor. El panel muestra todos los demás controles que definió y nada para el campo Oculto. Esa ausencia es la característica. El valor ya está aplicado y el widget renderizado lo refleja desde la primera caída.

Casos de uso comunes #

• Claves de diseño que CSS o JS interno se ramifica, corregido por widget.
• Cadenas de versión estampado en un atributo de datos para depurar widgets enviados.
• Banderas de modo API como un tipo de inserción que lee el script del widget.
• Se corrigieron fragmentos de nombres de clases impreso en el marcado para que una familia de widgets comparta ganchos de estilo.
• Plantilla de conmutadores de rama cuando exporta un widget en dos variantes internas.

Consejos para trabajar con el campo Oculto #

• Nómbralo como la constante que es. map_style_key le dice al siguiente mantenedor qué significa el token; hidden_1 no.
• Establezca el valor predeterminado antes de guardarlo. No hay una segunda oportunidad desde el lado Elementor; un valor predeterminado vacío representa una cadena vacía en todos los lugares donde aparece el token.
• Cítelo en JS. El valor es una cadena, así que escribe var key = "{{ map_style_key }}"; con citas.
• Prefiera un campo visible una vez que los usuarios necesiten control. En el momento en que un valor debe diferir por página, cambie el campo Oculto por a Texto o Seleccionar campo en lugar de pedir a los usuarios que editen los componentes internos del widget.
• Sin secretos. El valor termina en la salida de la página pública, así que trátelo como visible para cualquiera que lea la fuente.

Preguntas frecuentes #

Envolviendo #

El campo Oculto del Creador de widgets resuelve un problema silencioso pero real: los valores que un widget depende de que ningún editor debe tocar. Defínelo una vez, imprima su token cuando sea necesario y la constante se envía con el widget a todas partes donde se utiliza. Cuando un valor debe ser editable después de todo, busque un campo visible como Número o Texto en su lugar. Explora el resto del Widgets y extensiones de complementos maestros, y mira el página de precios por lo que incluye cada plan.