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 .
- {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 .
- {id_breve} retourne les mots associés à une brève .
- {id_syndic} retourne les mots associés à un site référencé .
- {id_forum} retourne les mots associés à un message de forum (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 affiche le titre (le mot-clé lui-même).
- #DESCRIPTIF affiche le descriptif du mot.
- #TEXTE affiche le texte associé au mot.
- #TYPE affiche 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 affiche le logo associé au mot-clé.
- #URL_MOT affiche l’adresse de ce mot
- #ID_GROUPE affiche l’identifiant du groupe de mots dont ce mot fait partie.
La boucle (GROUPES_MOTS)
D’une utilisation marginale, la boucle GROUPES_MOTS, 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 est l’identifiant unique du groupe de mots ;
- #TITRE est le titre du groupe [à l’intérieur de la boucle(MOTS), vous pouvez utiliser #TYPE pour afficher cette valeur].
- #DESCRIPTIF affiche le descriptif du groupe.
- #TEXTE affiche le texte du groupe.
- #LOGO_GROUPE affiche le logo associé au groupe de mots.