Tutorial : les boucles forums

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

Nous allons faire ici le tour de ce qu’il faut savoir pour bien manipuler la boucle forum.

Ce tutorial est une application de la boucle forum décrite ici dans la documentation de Spip

Attention Les exemples sont adaptées à de très anciennes versions de SPIP, et la syntaxe a plusieurs fois changé depuis 20 ans. Remplacez dans les codes ci-dessous : href="forum.php3?(#PARAMETRES_FORUM)" par href="(#PARAMETRES_FORUM|url_reponse_forum)" !

Préalable

Créez une nouvelle rubrique et dedans un nouvel article, notez le numéro de la rubrique et créez un fichier vide que vous nommez article-XX.html ou XX est le numéro de la rubrique.

Le tutorial suivant va vous permettre de voir comment gérer les différents affichages utiles pour des forums étape par étape.

Les types de messages

On distingue deux types de messages :

-  Les sujets

Les sujets sont les messages de niveau 1, c’est à dire que l’on créer un sujet en répondant à un article (ou une brève, ou encore une rubrique).

-  Les réponses

Les réponses sont des messages de niveau 2 ou plus, une réponse est postée en répondant à un sujet ou à une réponse.

Répondre à un article

Pour répondre à un article il faut ajouter l’appel que voici

[<p><a href="forum.php3?(#PARAMETRES_FORUM)"> Nouveau sujet </a></p>] 

Ce code appelle par défaut la page forum.php3/html de Spip qui permet de rédiger un message, il faut impérativement le mettre dans le corps de la boucle article pour permettre à Spip de calculer correctement la valeur de #PARAMETRES_FORUM.

Afficher tous les Sujets

Voici une boucle qui permet de créer un sujet en réponse à un article, d’afficher les sujets et d’en compter le nombre. Recopiez la dans votre fichier article-XX.html et créez un certain nombre de sujets.

<BOUCLE_principale(ARTICLES){id_article}>

[<p><a href="forum.php3?(#PARAMETRES_FORUM)"> Nouveau sujet </a></p>]


<B_sujets>
<ul>
<BOUCLE_sujets(FORUMS){id_article}{par date}{inverse}>

<li>#TITRE</li>

</BOUCLE_sujets>
</ul>
Il y a #TOTAL_BOUCLE sujets postés en réponse à cet article
</B_sujets>


</BOUCLE_principale>

Afficher les 5 derniers sujets et leurs réponses directes

Voici maintenant comment lister les 5 derniers sujets, permettre d’y répondre et afficher les réponses directes à ces sujets (on comptera les réponses pour la forme)

<BOUCLE_principale(ARTICLES){id_article}>

[<p><a href="forum.php3?(#PARAMETRES_FORUM)"> Nouveau sujet </a></p>]

<B_sujets>
<ul>
<BOUCLE_sujets(FORUMS){id_article}{par date}{inverse}{0,5}>

<li>#TITRE[ <a href="forum.php3?(#PARAMETRES_FORUM)"> répondre</a>]</li> 

<B_reponses>
<ul>
<BOUCLE_reponses(FORUMS){id_parent}{par date}>
<li>#TITRE</li>
</BOUCLE_reponses>
</ul>
Il y a #TOTAL_BOUCLE réponses postées en réponse à cette réponse.
</B_reponses>


</BOUCLE_sujets>
</ul>

</BOUCLE_principale>

Permettre de répondre aux réponses et voir ces réponses

Chaque message, quelque soit son niveau dans la hiérarchie des réponses, est considéré comme un élément de type (FORUMS), cela permet à Spip gérer les réponses aux réponses indéfiniment.

On accède aux réponses du niveau d’en dessous en utilisant le critère {id_parent} dans une boucle (FORUMS) contenue dans la boucle (FORUMS) du niveau supérieur.

Fort bien, mais comme on ne peut pas savoir par avance combien de niveaux de réponses va engendrer un sujet, il est impossible de prévoir le nombre de boucles de forum imbriquées nécéssaires, on utilisera donc une astuce qui va nous permettre de prendre en compte tous les cas de figure d’un coup : une boucle récursive.

Voici donc la même boucle que précédement, mais qui permet en plus de répondre aux réponses indéfiniment.

<BOUCLE_principale(ARTICLES){id_article}>

[<p><a href="forum.php3?(#PARAMETRES_FORUM)"> Nouveau sujet </a></p>]

<B_sujets>
<ul>
<BOUCLE_sujets(FORUMS){id_article}{par date}{inverse}{0,5}>

<li>#TITRE[ <a href="forum.php3?(#PARAMETRES_FORUM)"> répondre</a>]</li>

<B_reponses>
<ul>
<BOUCLE_reponses(FORUMS){id_parent}{par date}>
<li>#TITRE[ <a href="forum.php3?(#PARAMETRES_FORUM)"> répondre </a>]</li>
<BOUCLE_recursive(boucle_reponses)></BOUCLE_recursive>
</BOUCLE_reponses>
</ul>
Il y a #TOTAL_BOUCLE réponses postées en réponse à cette réponse.
</B_reponses>


</BOUCLE_sujets>
</ul>

</BOUCLE_principale>

Compter les messages

Il peut etre intérressant pour une page d’accueil de formum de savoir le nombre de sujets et de contributions totales à un article.

-  Compter les sujets

Si vous êtes observateur vous avez remarqué que l’on compte les sujets comme ca :

<BOUCLE_compte_sujets(FORUMS){id_article}> </BOUCLE_compte_sujets>
<p>#PUCE Il y a #TOTAL_BOUCLE sujets en réponse à cet article</p>
</B_compte_sujets>

On ne met qu’un espace au milieu de la boucle car ce qui nous intérresse c’est juste qu’elle tourne pour qu’on puisse compter le nombre de tour.

Vous voyez qu’avec le critère {id_article} Spip compte par défaut le nombre de réponses directement lié à l’article (donc Spip compte les sujets). Si on veut prendre en compte les réponses et les réponses de niveaux inférieurs (les réponses au sujet et les réponses à ces réponses), il faut ajouter le critère {plat} ca donne :

-  Compter tous les messages

<BOUCLE_compte_messages(FORUMS){id_article}{plat}> </BOUCLE_compte_messages>
<p>#PUCE Il y au total #TOTAL_BOUCLE messages en réponse à cet article</p>
</B_compte_messages>

En intégrant tout ça notre fichier article-XX devient :

<BOUCLE_principale(ARTICLES){id_article}>


<BOUCLE_compte_sujets(FORUMS){id_article}> </BOUCLE_compte_sujets>
<p>#PUCE Il y a #TOTAL_BOUCLE sujets en réponse à cet article</p>
</B_compte_sujets>


<BOUCLE_compte_messages(FORUMS){id_article}{plat}> </BOUCLE_compte_messages>
<p>#PUCE Il y au total #TOTAL_BOUCLE messages en réponse à cet article</p>
</B_compte_messages>

<hr>

[<p><a href="forum.php3?(#PARAMETRES_FORUM)"> Nouveau sujet </a></p>]

<B_sujets>
<ul>
  <BOUCLE_sujets(FORUMS){id_article}{par date}{inverse}{0,5}>
  <li>#TITRE[ <a href="forum.php3?(#PARAMETRES_FORUM)"> Nouvelle réponse </a>]</li>
  <B_reponses>
  <ul>
    <BOUCLE_reponses(FORUMS){id_parent}{par date}>
    <li>#TITRE[ <a href="forum.php3?(#PARAMETRES_FORUM)"> Nouvelle réponse </a>]</li>
    <BOUCLE_recursive(boucle_reponses)>
    </BOUCLE_recursive>
    </BOUCLE_reponses>
  </ul>
  Il y a #TOTAL_BOUCLE réponses postées en réponse à cette r&eacute;ponse. 
  </B_reponses>
  </BOUCLE_sujets>
</ul>

</BOUCLE_principale>

Lister les sujets par date inverse des réponses

Âmes sensibles s’abstenir...

Jusqu’ici on listait les sujets du plus récent au plus ancien, mais bien souvent ce qui nous interesse quand on liste les sujets c’est de faire « remonter » un sujet en haut de la pile lorsqu’il recoit une nouvelle réponse. Il faut donc trier les sujets par rapport à la date de leur dernière réponse. Vous êtes bien accrochés ???

-  Récupérer le sujet à l’origine de la discussion où le dernier message a été posté

Pour cela il va falloir utiliser le critère {id_enfant} qui permet de remonter d’un cran. On peut donc savoir de quel message le message courant est la réponse. Mais pour retrouver le sujet il va falloir remonter jusqu’en haut, c’est à dire jusqu’a ce que le message courant n’ai plus de message père car le sujet c’est précisement le message qui n’a pas de père.

L’idée est donc de remonter la hierarchie depuis le dernier message grâce à une boucle récursive et quand on ne trouve plus de résultat (ce qui veut dire qu’on est arrivé en haut) on affiche (donc en code alternatif) le titre du message : qui sera le sujet.

<BOUCLE_liste(FORUMS){id_article}{plat}{par date}{inverse}{0,1}> 

<BOUCLE_remonte(FORUMS){id_enfant}>
<BOUCLE_remonte_rec(boucle_remonte)> </BOUCLE_remonte_rec>
</BOUCLE_remonte>
<br>#TITRE
<//B_remonte>

</BOUCLE_liste>
<hr>
</B_liste>

Bon maintenant qu’on a réussit à récupérer le sujet du dernier message on va pouvoir continuer avec les autres messages les plus récents, mais on risque d’avoir un problème si les messages proviennent d’un sujet déjà listé en effet il ne faudrait pas re lister même le sujet.

En général dans Spip il suffit de mettre le critère {doublons} pour s’assurer que Spip ne re affiche pas un élément déjà affiché par une autre boucle, mais malheureusement ca ne marche pas à l’intérieur d’une même boucle.

Donc pas la peine de tenter de lister les messages issus du sujet qu’on vient de trouver dans une boucle imbriquée avec un {doublons} et de mettre un {doublons} à la boucle liste, ca ne marchera pas parce qu’on reste dans la boucle liste. Du coup on va utiliser un tableau php et vérifier que le sujet n’est pas déjà dedans avant de l’afficher.

<?php $tableau = array();?>
<BOUCLE_liste(FORUMS){id_article}{plat}{par date}{inverse}> 

<BOUCLE_remonte(FORUMS){id_enfant}>
<BOUCLE_remonte_rec(boucle_remonte)> </BOUCLE_remonte_rec>
</BOUCLE_remonte>
<?php 

$id_forum='[(#ID_FORUM|texte_script)]';
$titre='[(#TITRE|texte_script)]';
if(!in_array($id_forum,$tableau)) echo $titre."<br>";
$tableau[$id_forum]=$id_forum;

?>

<//B_remonte>

</BOUCLE_liste>
<hr>
</B_liste>

Et au final notre tutorial devient :

<?php
if(floor(phpversion()) < 4)	{
	// La version de PHP est inférieure à 4,
	// la fonction in_array n'existe donc pas
	function in_array($member, $array)
	{
		reset($array);
		while (list($k, $v) = each($array)) {
			if ($v == $member) return true;
		}
		return false;
	}
}
?>

<BOUCLE_principale(ARTICLES){id_article}>


<BOUCLE_compte_sujets(FORUMS){id_article}> </BOUCLE_compte_sujets>
<p>#PUCE Il y a #TOTAL_BOUCLE sujets en réponse à cet article</p>
</B_compte_sujets>


<BOUCLE_compte_messages(FORUMS){id_article}{plat}> </BOUCLE_compte_messages>
<p>#PUCE Il y au total #TOTAL_BOUCLE messages en réponse à cet article</p>
</B_compte_messages>

<hr>
<?php $tableau = array();?>
<BOUCLE_liste(FORUMS){id_article}{plat}{par date}{inverse}> 

<BOUCLE_remonte(FORUMS){id_enfant}>
<BOUCLE_remonte_rec(boucle_remonte)> </BOUCLE_remonte_rec>
</BOUCLE_remonte>
<?php 

$id_forum='[(#ID_FORUM|texte_script)]';
$titre='[(#TITRE|texte_script)]';
if(!in_array($id_forum,$tableau)) echo $titre."<br>";
$tableau[$id_forum]=$id_forum;

?>

<//B_remonte>

</BOUCLE_liste>
<hr>
</B_liste>



[<p><a href="forum.php3?(#PARAMETRES_FORUM)"> Nouveau sujet </a></p>]

<B_sujets>
<ul>
  <BOUCLE_sujets(FORUMS){id_article}{par date}{inverse}{0,5}>
  <li>#TITRE[ <a href="forum.php3?(#PARAMETRES_FORUM)"> répondre </a>]</li>
  <B_reponses>
  <ul>
    <BOUCLE_reponses(FORUMS){id_parent}{par date}>
    <li>#TITRE[ <a href="forum.php3?(#PARAMETRES_FORUM)"> répondre </a>]</li>
    <BOUCLE_recursive(boucle_reponses)>
    </BOUCLE_recursive>
    </BOUCLE_reponses>
  </ul>
  Il y a #TOTAL_BOUCLE réponses postées en réponse à cette r&eacute;ponse. 
  </B_reponses>
  </BOUCLE_sujets>
</ul>

</BOUCLE_principale>

Voilà vous savez tout, c’est grâce à ces notions qu’on peut réaliser un forum style phpBB en Spip

Discussion

13 discussions

  • Vincent

    Bonjour,

    J’aimerais savoir s’il est possible que les visiteurs de mon forum (spip 1.9.1) puissent, dans leurs messages, inclure des notes de bas de page. C’est curieux car si j’en mets une ici [1], le lien vers la note s’affiche mais pas la note. :-(
    Merci à ceux qui voudront m’aider.

    Répondre à ce message

  • Bonjour,

    J’utilise Spip 1.9.2 et j’aimerais savoir comment empecher les utilisateurs de poster du HTML dans les forums ?

    j’utilise le filtre supprimer_tags, mais ca enleve toute la mise en page faite avec la barre typographique :’(

    Répondre à ce message

  • 3

    salut

    il parait qu’avec spip 1.9.2 plus besoins de php pour faire remonté un topic qui vient de recevoir une reponse voici ma boucle pour affiché les topic de mes rubriques pouvez-vous m’aider

    <BOUCLE_thread(FORUMS){id_rubrique}{par date}{inverse}>
    <a href="spip.php?page=forum-message&(#PARAMETRES_FORUM)" class="lien_titre">#TITRE</a>
    </BOUCLE_thread>

    Merci

    • il parait qu’avec spip 1.9.2 plus besoins de php pour faire remonté un topic qui vient de recevoir une reponse

      Tout à fait, depuis spip 1.8 il suffit de classer les messages de la boucle FORUMS avec le critère {par date_thread} et zou, ca remonte tout seul (comme dans phpBB ou Gmail)

    • ok cool
      sinon on peut mettre un logo devant chaque topic pour voir si il y a eu un nouveau message ou pas (comme sur tous les forums) quelqu’un a reussis a faire ça ?

    • C’est pas simple de connaitre les nouveaux messages, et tout depend de la complexite que tu veux donner au systeme. Mais en gros il faut stocker quelques part les threads qu’il a déjà vu, ce qui peux se reveler un peu compliquer dans la db sinon y a l’option des cookies :)

    Répondre à ce message

  • 2

    bonjour,

    j’ai tenté de faire une boucle de type « les 5 forums les + actifs », mais je n’arrive qu’à remonter une liste de articles qui ont au moins un avis... après je bloque.

    comment faire puisqu’il n’existe pas de #POPULARITE sur les forums ?
    et encore la popularité concerne la lecture, non pas le nombre de posts sur un même forum.

    merci

    • Les plus actifs, c’est ceux qui ont le plus de contributions par exemple ce mois ci. Donc il suffit de faire une boucles qui compte le nombre de messages pour chaque article ce mois ci, et d’afficher celui dont le total boucle est le plus élevé.

    • Bonjour,

      Je suis intéréssé par votre méthode.
      En effet je désire moi aussi créer une boucle de type « les forums les +actifs ».

      Si je suis votre méthode, pas de problèmes pour compter le nombre de message par article, mais je ne comprends pas comment ensuite on peut seulement afficher celui qui en a le plus.

      Voici ce à quoi ressemble actuellement ma boucle :

      <B_most-forum>
      <ul>
      <BOUCLE_most-forum(ARTICLES){id_rubrique=121}{0,2}>
      <BOUCLE_combien2(FORUMS){id_article}{plat}></BOUCLE_combien2>
      [<li><a href="#URL_ARTICLE">(#TITRE|supprimer_numero)</a> : #TOTAL_BOUCLE mess.</li>] 
      <//B_combien2>
      </BOUCLE_most-forum>
      </ul>
      </B_most-forum>

      Quelqu’un peut-il m’aiguiller ?

    Répondre à ce message

  • 2

    bonjour

    je souhaiterai realiser un forum exactement comme celui de spip_contrib
    c’est à dire que l’on puisse ecrire une reponse à l’article qui se positionne en tete du forum avec possiblité de repondre a la reponse et qui s’affiche juste en dessous de celle-la.

    serait-il possible que quelqu’un puisse m’envoyer les squelettes utiles à cette présentation ?

    merci d’avance

    • et bien ma foi, si tu veux faire comme SPIP-Contrib, regarde comment sont fait les squelettes de celui-ci. Pas besoin que quelqu’un t’envoie ces squelettes, comme sur beaucoup de sites SPIP ils sont accessibles via urlsite/squelettes, soit pour notre cas http://www.spip-contrib.net/ (ou encore sur la Zone http://zone.spip.org/trac/spip-zone...))

      Le fichier concerné est « inc-forum.html, » utilisé dans le contexte de « article.html »

      D’uen manière générale c’est un bon réflexe quand un morceau de site SPIP intéresse d’aller voir son squelette directement.

      @+ NicolasR

    • bonjour,

      merci beaucoup
      je ne savais pas

      a+ ;)

    Répondre à ce message

  • Bonsoir
    Est-ce le même mécanisme utilisé par les forums simple machine ?
    (comme celui-ci http://www.social3w.fr/forum/)
    Bonne soirée !

    Répondre à ce message

  • 3

    Je tente mais vainement de trouver la solution à ce probleme :
    Lorsqu’une réponse est faite sur un article, elle est redirigée par mail à l’auteur.
    Lorsque l’auteur répond au commentaire, la réponse à la réponse lui est retournée par email. En fait il s’écrit lui même !
    Je n’arrive pas à trouver une solution pour que la réponse de la réponse soit adressée par mail à celui qui a posté la première réponse et ainsi de suite pour les autres commentaires d’autres visiteurs ayant laissé leurs e-mails.
    Est ce insurmontable ?

    • Cette aide est vraiment complete, je vous invite aussi à visiter mon propre site de tutoriaux, en esperant aider à mon tour.

    • vincseize

      Merci pour les tutos ;

      Néanmoins j’ai une question qui va vous paraitre simple mais :

      Je souhaite changer de mode de tri dans une boucle :

      if telle URL

      <BOUCLE_messages(FORUMS){id_article}{plat}{ par titre }{pagination #CONFIG{spipbb/fixlimit}}>

      else
      <BOUCLE_messages(FORUMS){id_article}{plat}{ par date_thread }{pagination #CONFIG{spipbb/fixlimit}}>

      J’ai tenté de recupérer les variables en php, pour les utiliser à la place de par titre ou par date_thread

      ou de carrement reécrire la ligne <BOUCLE... en php, mais rien y fait !!!

      Quelqu un pourrait il m’expliquer l’astuce pour une utilisation de Boucle Conditionnelles sous Spip, le bon vieux, IF ELSE !?

      Merci d’avance

    • Tu peux utiliser le filtre conditionnel.

      si oui : [(#ENV{truc}|?{' ',''}) <INCLURE{fond=uneboucle}{id_article}> ]

      si non : [(#ENV{truc}|?{'',' '}) <INCLURE{fond=uneautreboucle}{id_article}> ]

    Répondre à ce message

  • 3
    thierry

    Bonjour, une demi-journée que je cherche comment offrir la possibilité de poster un commentaire selon les articles. Ce tuto est absolument parfait sauf que je ne trouve rien de rien sur la manière de personnaliser le formulaire permettant d’entrer une réponse (taille des boite de saisie, couleur etc...). Vraiment je bloque, quelqu’un pourrait-il me mettre sur la voie ?
    Merci.

    Répondre à ce message

  • 1
    Gwenbzh29

    Bonjour, je voudrai changer le mot « Répondre » lors de l’utilisation des forum (répondre à cet article ou répondre à ce message).
    Je voudrai mettre « Réagir ».
    Merci de me dire ou modifier ce paramètre , je ne le trouve pas dans le fichier local_fr du dossier lang.

    • Bonjour,

      Ces informations sont dans le fichier ecrire/lang/public_fr.php vers la ligne 95 :

      ’repondre_article’ et ’repondre_message’

      Tu dois pouvoir modifier ces informations dans un fichier local_fr.php à placer dans ton dossier squelettes, comme ça tu ne perdras pas ces modifications lors d’une mise à jour de Spip.

    Répondre à ce message

  • Bjr à tous,

    Bon ! je suis pas un pro de spip mais j’ai quand même créé un site avec le squelette yaaa. Le souci c’est qu’il n’intègre pas de forum. Je voudrai en créer un (qui permette aux visiteurs de réagir aux articles lus ou sur tout autre sujet). J’ai lu « le tutorial forum ». Mais le niveau est un peu haut pr moi...

    Quelqu’un peut il m’aider et m’expliquer simplement, pas à pas ce qu’il faut faire ?

    Merci de votre aide.

    PS : j’aimerais tellement un tel forum sur mon site ;-)

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom