La boucle SITES (SPIP 1.3) retourne une liste de sites référencés. (Si l’on a syndiqué des sites référencés, cette boucle s’utilise, naturellemet, associée à une boucle SYNDIC_ARTICLES qui permet de récupérer la liste des article de ces sites.)
Avant la version 1.3 de SPIP, cette boucle était nommée SYNDICATION, car seuls des sites syndiqués pouvaient être référencés. Les deux dénominations sont rigoureusement équivalentes (mais « SITES » correspond mieux au fait que, depuis la version 1.3, il s’agit d’un système de référencement de sites, la syndication étant une option).
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}, tous les sites référencés.
{id_syndic} retourne le site référencés dont l’identifiant est id_syndic.
{id_rubrique} retourne les sites référencés dans cette rubrique.
{id_secteur} retourne les sites référencés dans ce secteur.
[SPIP 1.3] {id_mot} retourne toutes les sites liés au mot-clé en cours (à l’intérieur d’une boucle de type (MOTS).
[SPIP 1.3] {titre_mot=xxxx}, ou {type_mot=yyyy} retourne 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 ». Attention, on ne peut pas utiliser plusieurs critères {titre_mot=xxxx} ou {type_mot=yyyy} dans une même boucle.
[SPIP 1.4]{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.
{moderation=oui} [SPIP 1.4] 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}.
(SPIP 1.3) {syndication=oui}, {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.
(SPIP 1.2) {doublons} ou {unique} (ces deux critères sont rigoureusement identiques) permettent d’interdire l’affichage de sites référencés déjà affichés dans d’autres boucles.
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 titre}).
#ID_SYNDIC affiche l’identifiant unique du site syndiqué.
#NOM_SITE est le nom du site syndiqué.
#URL_SITE est l’adresse (URL) du site syndiqué.
#DESCRIPTIF est le descriptif du site syndiqué.
#ID_RUBRIQUE est le numéro de la rubrique contenant cette syndication.
#ID_SECTEUR est le numéro de la rubrique-secteur (à la racine du site) contenant cette syndication.
Autres balises
#LOGO_SITE affiche le logo attribué au site.
#URL_SYNDIC affiche l’adresse (URL) du fichier de syndication de ce site.
