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 (desde SPIP 1.9) 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 [SPIP 1.5] 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 a partir de [SPIP 1.8], es el logo del sitio. En realidad es el logo de la raíz, es decir de la sección 0.

-  #CHARSET [SPIP 1.5] 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 [SP<font color="yellow">IP 1.7] utilizada fuera de los bucles ARTICLES, RUBRIQUES, BREVES y AUTEURS devuelve el idioma principal del sitio.

-  #LANG_DIR, #LANG_LEFT, #LANG_RIGHT [SP<font color="yellow">IP 1.7] : 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) [SP<font color="yellow">IP 1.7] 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 [SPIP 1.8.2] introdujo 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:

-  #CHEMIN(desde SPIP 1.9) 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.

-  #PUCE [SPIP 1.5], que presenta la imagen del item de listas [1].

-  #FORMULAIRE_ADMIN [SPIP 1.5] 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.

Desde [SPIP 1.8], también se puede modificar la hoja de estilo spip_admin.css para controlar la posición de los botones [2].

-  #DEBUT_SURLIGNE, #FIN_SURLIGNE indica a SPIP en que parte de la página se colorean las palabras clave buscadas.

Cuando una usuaria llega a una página desde una página de búsqueda de SPIP, las palabras clave buscadas se colorean automáticamente en la página encontrada. SPIP no distingue, por ejemplo, entre un menú, un código javascript o el texto del artículo, colorea las palabras en todos los lugares, lo que puede quedar feo o incluso crear problemas con los scripts. Estas dos balizas pueden utilizarse para limitar el coloreado a una parte de la página. Por ejemplo:

-  #INSERT_HEAD (desde SPIP 1.9.1) 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 (desde SPIP 1.9) devuelve la url eventualmente con formato personalizado (ver. 2024), hacia la página que se indi..., 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: article.php3?id_article=25&var_mode=recalcul la baliza #SELF devolverá: article.php3?id_article=25

Es útil por ejemplo para hacer un formulario

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})] a partir de [SPIP 1.8], 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:

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

-  La baliza #SET{variable,valor} y su contraparte #GET{variable} fueron introducidas por SPIP 1.9.1. 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. [3]

-  #HTTP_HEADER{argumento} (desde SPIP 1.9) 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. [4]

-   #EVAL{argumento} (desde SPIP 1.9) 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.

-  La baliza #SPIP_CRON introducida por [SPIP 1.8] está ligada al manejo por SPIP de los cálculos que éste debe hacer periódicamente (estadísticas, indexación para el motor de búsqueda, sindicación de sitios, etc.)

Si esta baliza no está presente en el sitio, el motor de SPIP efectúa sus cálculos, en tiempo real, después de haber enviado una página al visitante; desgraciadamente PHP no permite cerrar la conexión al final de la página, y en ciertos casos, esto puede llevar a que ciertos visitantes desafortunados (aquellos cuya visita lanza un proceso un poco largo, en particular la sindicación) a constatar cierta lentitud en la aparición de la página solicitada.

La baliza #SPIP_CRON permite eludir este problema: su papel es generar un marcador <div> invisible cuya propiedad «background» apunta al script spip_background.php3; script que a su vez efectúa los cálculos necesarios «en segundo plano», y devuelve una imagen transparente de 1×1 pixel. Así, este truco permite evitar todo sentimiento de «lentitud», trasladando los eventuales retardos a un script anexo. [5]

Notas

[1Sea dicho de paso, se puede personalizar esta imagen. Ver Las variables de personalización.

[2Hasta [SPIP 1.7.2] se podía manejar algo de la presentación de estos botones con el estilo spip_bouton de la hoja spip_styles.css. Ver también «Spip y las hojas de estilo».

[3¡Atención! Si se destina un valor a una variable en la parte opcional previa de un bucle, no será posible recuperar este valor dentro del bucle. Esto tiene que ver con la manera en que SPIP calcula los esqueletos.

[4¡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>

[5Notar que esta baliza no es estratégica y su presencia o su ausencia no modifican en nada la regularidad del cálculo de las tareas periódicas del sitio.

Autor o autora dani Publicado el: Actualizado: 26/10/12

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