Las balizas propias del sitio

Las balizas siguientes están disponibles en cualquier lugar de un esqueleto, incluso fuera de los bucles.

Balizas definidas en la configuración

El contenido de las siguientes balizas se define al configurar el sitio, en el espacio privado de SPIP:

-  #NOM_SITE_SPIP es el nombre del sitio.

-  #URL_SITE_SPIP es la dirección del sitio. Por convención, no incluye la barra «/» final, así puedes crear enlaces del estilo #URL_SITE_SPIP/index.php

-  #DESCRIPTIF_SITE_SPIP muestra, como el nombre lo indica, la descripción del siti, que se define en el cuadro de texto a tal efecto en la paginade configuración general del sitio.

-  #EMAIL_WEBMASTER es la dirección de correo del/de la webmestre. Por omisión, SPIP toma la dirección de quien instaló el sitio (el/la primer administrador/a).
(Si, en vez de proporcionar públicamente la dirección de correo, prefieres un formulario «escribir al/a la webmestre», consulta «Los formularios»).

-  #LOGO_SITE_SPIP es el logo del sitio. En realidad es el logo de la raíz, es decir de la sección 0.

-  #CHARSET es el juego de caracteres que utiliza el sitio. Su valor por omisión es iso-8859-1, juego de caracteres llamado «iso-latín». Ver www.uzine.net/article1785.html (en francés) para una introducción a los «charsets», mientras no haya una documentación mas completa en SPIP al respecto.

-  #LANG utilizada fuera de los bucles ARTICLES, RUBRIQUES, BREVES y AUTEURS devuelve el idioma principal del sitio.

-  #LANG_DIR, #LANG_LEFT, #LANG_RIGHT : estas balizas definen el sentido de la escritura del idioma en el contexto corriente (por ejemplo, del artículo que se va a mostrar). Ver el artículo «Hacer un sitio multilingüe» para mayor información.

-  #MENU_LANG (y #MENU_LANG_ECRIRE) muestran un menú de idiomas que permite al visitante obtener la página actual en el idioma elegido. La primera baliza muestra la lista de idiomas del sitio; la segunda la lista de idiomas del espacio privado (se utiliza en la página de conexión al espacio privado).

Balizas de paginación

-  #DOSSIER_SQUELETTE esta baliza para permitir el desarrollo de esqueletos fácilmente transportables e intercambiables. Permite obtener la ruta al directorio en el que está instalado el esqueleto utilizado.

Igualmente se pueden situar los archivos «accesorios» del esqueleto (hoja de estilo, javascript, etc...) en el directorio del esqueleto y, simplemente, distribuir ese directorio para intercambiar los esqueletos. De esta manera, para incluir una hoja de estilo del directorio del esqueleto se escribirá, por ejemplo:

<link rel="stylesheet" href="#DOSSIER_SQUELETTE/mi_estilo.css" type="text/css"/>

-  #CHEMIN reemplaza y mejora a #DOSSIER_SQUELETTE. #CHEMIN{xxx} devolverá la ruta completa al al archivo xxx, que se encuentre en la raiz, en el directorio de esqueletos, en /dist, en la carpeta de algun plugin activo, etc.

<link rel="stylesheet" href="#CHEMIN{mon_style.css}" type="text/css" />

-  #PUCE, que presenta la imagen del item de listas.

-  #FORMULAIRE_ADMIN es una baliza opcional que permite agregar los botones de administración («Actualizar esta página», «Modificar...» etc.) en los esqueletos. Cuando un administrador recorre el sitio público, si esta baliza está presente, será remplazada por los botones de administración, si no, los botones serán agregados al final de la página.

También se puede modificar la hoja de estilo spip_admin.css para controlar la posición de los botones.

-  #DEBUT_SURLIGNE, #FIN_SURLIGNE indica a SPIP en que parte de la página se colorean las palabras clave buscadas. Ver : «Los bucles de búsqueda».

-  #INSERT_HEAD que se debe incluir dentro de las balizas <head> y </head> de tus esqueletos, permite a SPIP y a los eventuales plugins, adjuntar automáticamente contenido de cabecera como hojas de estilos, código javascript, etc.

Balizas técnicas

OjO, estas balizas están destinadas a usuarios avanzados de SPIP.

-  #CACHE{tiempo} permite determinar el plazo al final del cual se recalculará la página. El tiempo se expresa en segundos. Puede ponerse en forma de cálculo. Por ejemplo: #CACHE{24*3600}.

-  #REM no produce ningun resultado: permite comentar el código de los esqueletos de la siguiente manera: [(#REM) Esto es un comentario ]. Estos comentarios no aparecerán dentro del código generado del sitio publico, ya que SPIP los suprime al calcular la página.

-  #URL_PAGE devuelve la url eventualmente con formato personalizado (ver. Utilizar URLs personalizadas), hacia la página que se indica como parámetro. Por ejemplo, para acceder a la página generada por el esqueleto lala.html, situada en su directorio de esqueletos, #URL_PAGE{lala} generará automáticamente la url spip.php?page=toto. Existe un segundo parámetro opcional para añadir variables a la url. Por ejemplo #URL_PAGE{lala, id_article=#ID_ARTICLE} generará la url spip.php?page=lala&id_article=XXX.

-  #SELF devuelve la URL de la página llamada, limpia de las variables específicas a la ejecución de SPIP. Por ejemplo; para una página cuya URL es: spip.php?article25&var_mode=recalcul la baliza #SELF devolverá: spip.php?article25

Es útil por ejemplo para hacer un formulario

<form action='#SELF' method='get'>

Observación: la baliza #SELF que representa la dirección de la página, no es compatible con los <INCLURE()> (salvo si el $delais de la inclusión se ha puesto a 0).

-  [(#ENV{xxxx,zzzz})] permite acceder a la variable de de nombre xxxx pasada en la petición HTTP. zzzz es una parte opcional que permite devolver un valor aunque la variable xxxx no exista.

Por omisión, se filtra la baliza #ENV con htmlspecialchars. Si se quiere obtener el resultado bruto, se puede usar el asterisco «*» como para las otras balizas: [(#ENV*{xxxx})].

Por ejemplo, para limitar la lista de autores que se muestran:

<BOUCLE_autores(AUTEURS) {nom == #ENV{letra,^A}}>

devuelve la lista de autores que tengan un nombre que corresponda a la expresión regular pasada en la URL con la variable «letra» (spip.php?page=lista_autores&amp;lettre=^Z) o los autores cuyo nombre empieza con una “A” si no hay variable letra en la URL.

-  La baliza #SET{variable,valor} y su contraparte #GET{variable} . La baliza #SET{xxx,yyy} afecta con un valor yyy a una variable xxx propia al esqueleto calculado. Este valor puede ser calculado por la baliza #GET{xxx}. Las variables creadas de esta manera no se transmiten a esqueleto incluidos.

-  #HTTP_HEADER{argumento} permite modificar el encabezamiento HTTP de la página devuelta por SPIP, de forma que es posible generar otros tipos de archivos de salida además de html. Ejemplo: #HTTP_HEADER{Content-Type: text/css} devolverá un archivo de texto de hoja de estilos calculada dinámicamente por SPIP. ¡Atención! El hecho de utilizar esta baliza suprime los botones de administración. Esta baliza no puede utilizarse en esqueletos incluidos mediante la sintaxis <INCLURE>

-  #EVAL{argumento} evalúa la expresión PHP dada como parámetro. Por ejemplo #EVAL{1+1} devolverá 2, y #EVAL{_DIR_IMG_PACK} devolverá la ruta hacia el directorio ecrire/img_pack/. Atención, se aconseja mucho usar con moderación.

Autor o autora dani Publicado el: Actualizado: 26/08/23

Traducciones: عربي, català, Deutsch, English, Español, français, italiano, Nederlands