Portada › 11. Variables

11. Variables globales

Introducción

Las variables globales son valores compartidos por todas las páginas y componentes del sitio: nombre del club, teléfono de contacto, dirección, redes sociales, IBAN oficial, NIF, eslogan, horarios de atención, etc. En lugar de duplicar estos datos en cada componente, se definen una sola vez aquí y se referencian en los templates con la sintaxis [VAR:nombre_variable].

Editar una variable global propaga el cambio a toda la web en cuanto se publica la siguiente petición, sin necesidad de tocar componente a componente. Esto es la forma más cómoda de mantener actualizados los datos corporativos que aparecen en cabeceras, pies, formularios de contacto y emails transaccionales.

Acceso rápido

Pantalla principal

Listado de variables globales agrupadas por carpetas
Listado de variables globales del sitio, agrupadas por carpetas (CLUB, CONTACTO, GENERAL, REDES SOCIALES, SYSTEM en este panel). Cada fila muestra el nombre técnico (slug), la etiqueta visible, el valor actual y los iconos de acción.

El listado muestra las variables organizadas por carpetas / grupos (cada carpeta se corresponde con un ámbito temático: datos del club, contacto, redes, configuración interna…). En este despliegue las carpetas visibles son:

Cada fila del listado tiene:

Tareas habituales

11.1 Ver el listado de variables

Para localizar una variable concreta o revisar todos los valores definidos:

  1. Entra en /variables.
  2. Las variables aparecen agrupadas por carpetas. Usa los encabezados de carpeta para localizar el bloque que te interesa.
  3. Si hay muchas variables, usa el buscador de la parte superior (busca por nombre o por etiqueta).
  4. Para ver el valor completo de una variable que aparece truncado, pasa el ratón por encima o toca la celda (en móvil).

11.2 Editar una variable

Pantalla de edición de una variable global
Pantalla de edición de una variable. Campos: nombre (slug, no editable), etiqueta, valor (el campo a modificar), descripción interna e idioma (cuando la variable es traducible).

Para editar el valor de una variable existente:

  1. Localiza la variable en el listado (o búscala con el buscador).
  2. Pulsa el icono de editar (lápiz) en la fila correspondiente.
  3. Se abre la pantalla de edición con los siguientes campos:
    • Nombre (slug interno, no editable: cambiar el nombre rompería todas las referencias [VAR:nombre] de los templates).
    • Etiqueta (el nombre visible en el panel, editable).
    • Valor (el contenido que se inyecta en la web: edita este campo).
    • Descripción interna (opcional, ayuda a otros editores a entender para qué sirve la variable).
    • Idioma (solo aparece si la variable es traducible; permite mantener un valor distinto por idioma).
  4. Modifica el valor y pulsa Guardar.
  5. El cambio se publica al instante en la siguiente petición a la web. Si la web tiene caché activa, puede tardar unos minutos en verse reflejado (ver errores frecuentes).
Importante: el nombre (slug) no se puede editar desde esta pantalla precisamente para evitar que se rompan las referencias en los templates. Si necesitas renombrar la variable, la opción correcta es crear una nueva variable y migrar las referencias manualmente.

11.3 Crear una variable nueva

Para añadir una variable global nueva (por ejemplo, el IBAN del club para incluirlo en los emails de pago):

  1. Entra en /variables.
  2. Pulsa Nueva variable en la parte superior.
  3. Rellena:
    • Nombre: slug en minúsculas, sin espacios, sin acentos, separado por guiones bajos si hace falta (p. ej. club_iban). Será la cadena que escribas dentro de los corchetes en el template.
    • Etiqueta: nombre legible para los editores (p. ej. IBAN oficial del club).
    • Carpeta: grupo al que pertenece la variable (CLUB, CONTACTO, GENERAL…). Si no existe la carpeta que necesitas, créala desde la propia pantalla de alta.
    • Valor: el contenido inicial.
    • Descripción interna (opcional pero recomendado).
    • Traducible: marca esta casilla si el valor debe variar según el idioma del visitante. Si la marcas, el sistema abrirá un campo de valor por cada idioma activo.
  4. Guarda. La variable aparece en su carpeta correspondiente, lista para ser referenciada en cualquier template con [VAR:nombre].

11.4 Organizar por grupos / carpetas

Para mantener el listado ordenado cuando crece:

  1. Entra en /variables.
  2. Pulsa Gestionar carpetas (icono de carpeta en la cabecera del listado).
  3. Desde esa pantalla puedes:
    • Crear una carpeta nueva (nombre, descripción, color identificativo opcional).
    • Renombrar una carpeta existente.
    • Reordenar las carpetas (el orden aquí es el orden de aparición en el listado).
    • Eliminar una carpeta: las variables que contenía pasan a Sin carpeta, no se borran.
    • Mover variables de una carpeta a otra.
  4. Guarda. El listado principal se reordena al instante.

Referencia técnica (webmasters)

Sintaxis de uso en templates

En los templates HTML de los componentes (ver sección 4) y en algunas plantillas de email, una variable se referencia con la siguiente sintaxis:

<a href="mailto:[VAR:club_email]">Escríbenos</a>
<img src="[VAR:base_path]/assets/media/spritemap.svg" alt="">
<p>© [VAR:club_anio_fundacion]–[VAR:club_anio_actual] [VAR:club_nombre]. Todos los derechos reservados.</p>

Reglas:

Cómo se resuelven en runtime

El motor de plantillas sigue este orden de resolución para cada [VAR:nombre]:

  1. Busca la variable con el slug dado.
  2. Si la variable es traducible, intenta obtener el valor del idioma actual del visitante (detectado por URL, cookie o cabecera Accept-Language; ver sección 12).
  3. Si no hay valor en ese idioma, usa el valor del idioma por defecto configurado en /languages.
  4. Si la variable no existe, devuelve cadena vacía.
  5. El resultado se inyecta en el HTML sin escape automático. Por tanto, si el valor puede contener HTML (por ejemplo, un texto con negritas), se debe marcar explícitamente como raw en la definición de la variable; si no, se asume texto plano y los caracteres <, >, & y " se escapan para evitar XSS.

Variables internas (SYSTEM)

La carpeta SYSTEM contiene variables que no deberían editar los editores de contenido, sino el equipo técnico:

Importante: editar las variables SYSTEM de forma incorrecta puede romper toda la web (URLs que no cargan, iconos que desaparecen, APIs que fallan). Si necesitas tocar una variable SYSTEM, hazlo en un entorno de staging primero.

Variables y SEO

Las variables globales también se pueden usar en campos de tipo meta de las páginas (título, descripción, OpenGraph). Esto permite tener, por ejemplo, un <title> distinto por idioma sin duplicar el template de cada página.

Errores frecuentes