La boucle FORUMS

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

La boucle FORUMS retourne une liste de messages de forums.

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.

{id_forum} retourne le message dont l'identifiant est id_forum. Comme l'identifiant de chaque message est unique, ce critère retourne une ou zéro réponse.

{id_article} retourne les messages correspondant à cet article.

{id_rubrique} retourne les messages correspondant à cette rubrique.

{id_breve} retourne les messages correspondant à cette brève.

{id_parent} retourne les messages dépendant d'un autre message. Indispensable pour gérer des threads dans les forums.

{id_enfant} retourne le message dont dépend le message actuel (permet de « remonter » dans la hiérachie des threads). (SPIP 1.3)

{meme_parent} retourne les autres messages répondant à un même message. (SPIP 1.3)

{plat} : par défaut, seuls les messages n'ayant pas de parent (i.e. à la racine d'un thread) sont affichés.
En ajoutant ce critère, vous pouvez sélectionner tous les messages quelle que soit leur position dans un thread (dans la limite
des autres critères, bien sûr). Cela permet d'afficher les messages par ordre strictement chronologique par exemple, ou de compter
le nombre total de contributions dans un forum.

{id_secteur} retourne les messages correspondant au secteur. A priori, peu utile ; mais cela permet par exemple de faire un grand forum thématique regroupant tous les messages d'un secteur, quel que soit l'endroit où l'on se trouve.

À partir de la version SPIP 1.4, les messages des forums peuvent être liées à des mots-clés. Les critères de mots-clés peuvent donc être désormais utilisés dans les boucles (FORUMS) :

{id_mot}, {titre_mot=xxx} récupèrent les messages liés au mot dont le numéro est id_mot ou dont le titre est titre_mot ;
{id_groupe}, {type_mot=yyyy} récupèrent les messages liés à des mots du groupe id_groupe, ou du groupe dont le titre est type_mot.

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_FORUM affiche l'identifiant unique du message.

#ID_BREVE affiche l'identifiant de la brève à laquelle ce message est attaché. Attention, cela n'est pas récursif : un message qui répond à un message attaché à une brève ne contient pas lui-même le numéro de la brève.

#ID_ARTICLE est l'identifiant de l'article à laquelle le message répond.

#ID_RUBRIQUE l'identifiant de la rubrique à laquelle le message répond.

#DATE est la date de publication.

#TITRE est le titre.

#TEXTE est le texte du message.

#NOM_SITE le nom du site Web indiqué par l'auteur.

#URL_SITE l'adresse (URL) de ce site Web.

#NOM est le nom de l'auteur du message.

#EMAIL est l'adresse email de l'auteur.

#IP est l'adresse IP de l'auteur du message au moment de l'envoi de sa contribution.

Les balises calculées par SPIP

#FORMULAIRE_FORUM fabrique l'interface permettant de poster un message de réponse.

#PARAMETRES_FORUM fabrique la liste des variables exploitées par l'interface du formulaire permettant de répondre à ce message. Par exemple :

[<a href="forum.php3?(#PARAMETRES_FORUM)">Répondre à ce message</a>]

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

uZine 3

La boucle FORUMS

Les critères de sélection

Les critères d'affichage

Les balises de cette boucle

La boucle MOTS

Les critères de sélection

Les critères d'affichage

Les balises de cette boucle

La boucle (GROUPES_MOTS)