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é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é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
Discussions par date d’activité
13 discussions
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
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
Merci
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
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 :
Quelqu’un peut-il m’aiguiller ?
Répondre à ce message
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
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.
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
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
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.
Salut,
avec spip 1.8 ca se passe dans le fichier formulaires/formulaire_forum.html, les css sont dans spip-style.css.
Et hop :)
tet=st lmlmlmllm
dfdfdfdf dfd df df df
Répondre à ce message
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 :
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.
Suivre les commentaires : |