uZine 3

La boucle MOTS

l'équipe de SPIP — 2001-05-13T22:00:00Z

La boucle MOTS retourne une liste de mots-clés.

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} les mots sont sélectionnés dans l'intégralité du site.

{id_mot} retourne le mot-clé dont l'identifiant est id_mot.

{id_groupe} retourne les mots-clés associés au groupe de mots dont le numéro est id_groupe [SPIP 1.4].

{id_article} retourne les mots-clés associés à cet article (c'est l'utilisation la plus courante de cette boucle).

{id_rubrique} retourne les mots-clés associés à une rubrique [SPIP 1.4].

{id_breve} retourne les mots associés à une brève [SPIP 1.4].

{id_syndic} retourne les mots associés à un site référencé [SPIP 1.4].

{id_forum} retourne les mots associés à un message de forum [SPIP 1.4] (attention, utilisation très spécifique).

{titre=france} retourne le mot-clé intitulé france (par exemple).

{type=pays} retourne les mots-clés du groupe de mots-clés intitulé pays (par exemple).

Les critères d'affichage

Les critères communs à toutes les boucles s'appliquent.

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_MOT affiche l'identifiant unique du mot.

#TITRE est le titre (le mot-clé lui-même).

#DESCRIPTIF est le descriptif du mot.

#TEXTE est le texte associé au mot.

#TYPE est la catégorie dans laquelle est installé ce mot-clé (par exemple, le mot-clé « France » pourrait être associé à la catégorie « Pays »).

#LOGO_MOT [SPIP 1.4] affiche le logo associé au mot-clé.

#URL_MOT donne l'adresse de ce mot

La boucle (GROUPES_MOTS)

D'une utilisation marginale, la boucle GROUPES_MOTS [SPIP 1.5]
mérite d'être citée ici : elle permet, si vous avez plusieurs groupes de mots-clés, de sélectionner ces groupes, et d'organiser par exemple une page récapitulative de tous les mots-clés classés par groupe, puis par ordre alphabétique à l'intérieur de chaque groupe, par exemple via le code suivant :

<BOUCLE_groupes(GROUPES_MOTS){par titre}> <h1>#TITRE</H1> <BOUCLE_mots(MOTS){id_groupe}{par titre}{" - "}> #TITRE </BOUCLE_mots> </BOUCLE_groupes>

Les balises et critères associés à cette boucle sont :
#ID_GROUPE, l'identifiant du groupe de mots [également disponible dans la boucle(MOTS)] ;
#TITRE, le titre du groupe [à l'intérieur de la boucle(MOTS), vous pouvez utiliser #TYPE pour afficher cette valeur].

La boucle SITES (ou SYNDICATION)

l'équipe de SPIP — 2001-05-11T22:00:00Z

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.)

<BOUCLEn(SITES){critères...}>

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).

<BOUCLEn(SYNDICATION){critères...}>

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.

La boucle SYNDIC_ARTICLES

l'équipe de SPIP — 2001-05-09T22:00:00Z

La boucle SYNDIC_ARTICLES retourne une liste des articles des sites syndiqués. On peut soit l'utiliser à l'intérieur d'une boucle SITES (cette dernière récupère une liste de sites référencés, ensuite on récupère chaque article de ces sites), soit directement à l'intérieur d'une rubrique (on récupère directement tous les articles syndiqués dans une rubrique, en court-circuitant le passage par la liste des sites).

<BOUCLEn(SYNDIC_ARTICLES){critères...}>

(SPIP 1.3) À partir de la version 1.3 de SPIP, la boucle SITES (ou SYNDICATION) n'affiche plus uniquement des sites syndiqués, mais plus généralement des sites référencés (la syndication de certains sites référencés étant une option). On pourra donc, pour obtenir une présentation graphique plus précise, utiliser une boucle SYNDIC_ARTICLES uniquement à l'intérieur d'une boucle SITES utilisant le critère {syndication=oui}.

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 syndiqués.

{id_syndic_article} retourne l'article syndiqué dont l'identifiant est id_syndic_article. (Dans la pratique, il y très peu d'intérêt à fabriquer une page pour un article syndiqué, puisqu'on préférera renvoyer directement vers l'article en question.)

{id_syndic} retourne la liste des articles du site syndiqué dont l'identifiant est id_syndic.

{id_rubrique} retourne la liste des articles syndiqués dans cette rubrique.

{id_secteur} retourne la liste des articles syndiqués dans ce secteur.

Les critères d'affichage

Les critères communs à toutes les boucles s'appliquent.

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_ARTICLE affiche l'identifiant unique de l'article syndiqué.

#ID_SYNDIC affiche l'identifiant unique du site syndiqué contenant cet article.
syndiqué.

#TITRE est le titre de l'article.
Remarque : il est préférable d'utiliser ici le titre « brut » de l'article syndiqué - via le code [(#TITRE*)] -, pour éviter le moteur typographique. En effet les titres sont censés être déjà « typographiquement corrects » dans les backends, et on ne souhaite pas passer la correction typographique sur des titres en anglais ou sur des titres comprenant des expressions du genre « Les fichiers ~/.tcshrc ».

#URL_ARTICLE est l'adresse (URL) du site syndiqué (sur son site original).

#DATE est la date de publication de cet article.

#LESAUTEURS, les auteurs de l'article syndiqué.

#DESCRIPTIF le descriptif de l'article syndiqué.

#NOM_SITE est le nom du site syndiqué contenant cet article.

#URL_SITE est l'adresse (URL) du site