Si l’on a syndiqué des sites référencés, cette boucle s’utilise, naturellement, associée à une boucle SYNDIC_ARTICLES qui permet de récupérer la liste des articles de ces sites.
Les critères de sélection
On utilisera l’un ou autre des critères suivants pour indiquer comment on sélectionne les éléments.
- {tout} sélectionne tous les sites référencés.
- {id_syndic} sélectionne le site référencé dont l’identifiant est {id_syndic}.
- {id_rubrique} sélectionne les sites référencés dans cette rubrique.
- {id_secteur} sélectionne les sites référencés dans ce secteur.
- {id_mot} sélectionne toutes les sites liés au mot-clé indiqué par le contexte (boucle (MOTS) englobante, paramètre d’URL etc).
- {titre_mot=xxxx}, ou {type_mot=yyyy} sélectionne les sites liés au mot-clé dont le nom est « xxxx », ou liés à des mots-clés du groupe de mots-clés « yyyy ». Si l’on donne plusieurs critères {titre_mot=xxxx} (ou plusieurs {type_mot=yyyy}), on sélectionnera ceux qui auront tous ces mots à la fois.
- {id_groupe=zzzz} permet de sélectionner les sites liés à un groupe de mots-clés ; principe identique au {type_mot} précédent, mais puisque l’on travaille avec un identifiant (numéro du groupe), la syntaxe sera plus « propre ».
Les critères d’affichage
Les critères communs à toutes les boucles s’appliquent.
- {syndication=oui}, ou {syndication=non} permet de n’afficher que les sites référencés faisant l’objet d’une syndication, ou les sites non syndiqués. Une éventuelle valeur off signale qu’une erreur de syndication a été détectée.
- {moderation=oui} affiche les sites syndiqués dont les liens sont bloqués a priori (« modérés ») ; l’inverse de ce critère est {moderation!=oui}.
Les balises de cette boucle
Les balises tirées de la base de données
Les balises suivantes correspondent aux éléments directement tirés de la base de données. Vous pouvez les utiliser également en tant que critère de classement (généralement : {par nom_site}).
- #ID_SYNDIC affiche l’identifiant unique du site référencé. Par exemple pour renvoyer vers la page décrivant le site (site.html sur la /dist) avec le code suivant :
<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 affiche le nom du site référencé.
- #URL_SITE affiche l’adresse (URL) du site référencé.
- #DESCRIPTIF affiche le descriptif du site référencé.
- #ID_RUBRIQUE affiche le numéro de la rubrique contenant ce site.
- #ID_SECTEUR affiche le numéro de la rubrique-secteur (à la racine du site) contenant ce site.
Autres balises
- #LOGO_SITE affiche le logo attribué au site.
- #URL_SYNDIC affiche l’adresse (URL) du fichier de syndication de ce site.
- #FORMULAIRE_FORUM fabrique et affiche le formulaire permettant de poster un message de forum à propos de ce site. Pour en savoir plus, voir aussi « Les formulaires ».
- #PARAMETRES_FORUM fabrique la liste des variables exploitées par l’interface du formulaire permettant de poster un message de forum à propos de ce site. Par exemple :
[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Répondre à ce forum</a>]
On peut lui passer un paramètre spécifiant l’adresse de retour après avoir posté le message.
Par exemple :
<a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Répondre à ce message</a>
renverra le visiteur sur la page actuelle une fois que le message a été validé.
Voir aussi : la boucle SYNDIC_ARTICLES.