Si se han sindicado sitios referenciados, este bucle se utiliza, habitualmente, asociado a un bucle SYNDIC_ARTICLES que permite recuperar la lista de los artículos de estos sitios.
Los criterios de selección
Se utilizará uno u otro de los siguientes criterios para indicar cómo se seleccionan los elementos.
- {tout}, todos los sitios referenciados.
- {id_syndic} devuelve el sitio referenciado cuyo identificador es {id_syndic}.
- {id_rubrique} devuelve los sitios referenciados en esta sección.
- {id_secteur} devuelve los sitios referenciados en este sector.
- {id_mot} devuelve todos los sitios relacionados con la palabra clave actual (dentro de un bucle tipo (MOTS)).
- {titre_mot=xxxx}, o {type_mot=yyyy} devuelve los sitios relacionados con la palabra clave cuyo nombre es «xxxx», o relacionados con palabras clave del grupo de palabras clave «yyyy». Atención, no se pueden utilizar varios criterios {titre_mot=xxxx} o {type_mot=yyyy} en un mismo bucle.
- {id_groupe=zzzz} permite seleccionar los sitios relacionados con un grupo de palabras clave; principio idéntico al {type_mot} precedente, pero dado que se trabaja con un identificador (número de grupo), la sintaxis será más «limpia».
Los criterios de publicación
Se aplican los criterios comunes a todos los bucles.
- {syndication=oui}, o {syndication=non} permite devolver sólo los sitios referenciados que son objeto de una sindicación o los sitios no sindicados.
- {moderation=oui} devuelve los sitios sindicados cuyos enlaces son bloqueados a priori («moderados»); el criterio inverso a este es {moderation!=oui}.
Las balizas de este bucle
- Las balizas extraídas de la base de datos.
Las balizas siguientes corresponden a los elementos extraídos directamente de la base de datos. Puedes utilizarlos igualmente como criterios de clasificación (generalmente: {par nom_site}).
- #ID_SYNDIC devuelve el identificador único del sitio sindicado.Por ejemplo, para enlazar con la página que describe el sitio (site.html en el /dist) con el siguiente código:
<BOUCLE_sites(SITES) {id_rubrique} {par nom_site}>
<li><a href="[(#ID_SYNDIC|generer_url_entite{site})]">#NOM_SITE</a></li>
</BOUCLE_sites>
- #NOM_SITE es el nombre del sitio sindicado.
- #URL_SITE es la dirección (URL) del sitio sindicado.
- #DESCRIPTIF es el texto descriptivo del sitio sindicado.
- #ID_RUBRIQUE es el número de la sección que contiene esta sindicación.
- #ID_SECTEUR es el número de la sección-sector (en la raíz del sitio) que contiene esta sindicación.
- Otras balizas
- #LOGO_SITE muestra el logo atribuido a este sitio.
- #URL_SYNDIC muestra la dirección (URL) del fichero de sindicación de este sitio.
- #FORMULAIRE_FORUM crea y muestra el formulario para publicar un mensaje en el foro sobre este sitio. Para más información, véase también «Los formularios».
- #PARAMETRES_FORUM produce la lista de variables utilizadas por la interfaz del formulario utilizado para publicar un mensaje en el foro sobre este sitio. Por ejemplo:
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Répondre à ce forum</a>]
Puede pasarle un parámetro que especifique la dirección de retorno después de enviar el mensaje.
Por ejemplo
<a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Répondre à ce message</a>
devolverá al visitante a la página actual una vez validado el mensaje.