Inclusions du plugin Comments

Le plugin Comments met à disposition du webmestre plusieurs briques qui lui permettent de construire aussi bien une liste de commentaires qu’un forum de discussion.

Inclusions disponibles dans la dernière version du plugin Comments
Utilisation Exemple d’inclusion Sélecteur parent Fichier
Commentaire [(#MODELE{comment}{id_forum})] .comment modeles/comment.html
Commentaires (liste + formulaire) [(#INCLURE{fond=comments}{id_article})] .comments comments.html
Liste à plat [(#INCLURE{fond=comments-list}{id_article})] .comments-list comments-list.html
Thread [(#INCLURE{fond=comments-thread}{id_article})] .comments-thread comments-thread.html
Derniers commentaires <INCLURE{fond=comments-links}> .comments-links comments-links.html
Nombre de commentaires [(#MODELE{comments-nb})] Ø modeles/comments-nb.html
Flux d’abonnement aux commentaires [(#INCLURE{fond=comments-feed}{id_article})] .comments-feed comments-feed.html
Flux RSS [(#URL_PAGE{comments-rss}|parametre_url{id_article,#ID_ARTICLE})] Ø feed/comments-rss.html
Flux Atom [(#URL_PAGE{comments-atom}|parametre_url{id_article,#ID_ARTICLE})] Ø feed/comments-atom.html
Formulaire pour commenter #FORMULAIRE_FORUM .comment-form sinon .formulaire_forum formulaires/forum.html
Prévisualisation du commentaire  ? .previsu .comment formulaires/inc-forum_previsu.html

Exemples d’utilisation

* Commentaire

La brique élémentaire comment.html affiche un commentaire seul, complet, microformaté, avec permalien, trombine, etc. Elle permettra de construire tout type d’affichage sur mesure, de la liste de commentaires au forum de discussion.

  • À inclure dans une boucle FORUMS, comme ceci : [(#MODELE{comment}{id_forum})]
  • À utiliser dans l’espace rédactionnel, comme ceci par exemple : <comment|id_forum=1888>
  • Styler simplement .comment pour couvrir tous les cas.

* Commentaires

Cette brique prête à l’emploi affiche d’un coup les commentaires suivis du formulaire de réponse, avec flux de syndication : idéal pour un blog !

À insérer comme ceci : [(#INCLURE{fond=comments}{id_article})] dans votre squelette article.html. Cette inclusion est paramétrable via le panneau de configuration du plugin. Si elle ne vous convient pas, utilisez plutôt les briques ci-dessous, qui la composent, pour composer l’affichage de vos rêves.

* Listes de commentaires

Les commentaires peuvent être listés à plat ou en enfilade (thread). Selon le besoin, vous préférerez inclure [(#INCLURE{fond=comments-list}{env})] ou [(#INCLURE{fond=comments-thread}{env})]. Dans ce cas, le choix de présentation du fil de discussion via le panneau de config CFG est sans effet, puisque l’affichage est forcé dans les squelettes.

Pour styler ces listes, notez que le sélecteur .comments-list est commun aux listes de commentaires quelque soit leur type. Il est complété par les sélecteurs .comments-thread uniquement pour les thread.

* Derniers commentaires

À inclure comme ceci : <INCLURE{fond=comments-links}> pour afficher la liste des 5 derniers commentaires, avec liens ancrés vers ceux-ci.

Dans le cas d’un blog personnel, il peut être préférable de ne pas faire remonter les commentaires fait par l’auteur du blog, au risque de monopoliser cette liste par ses seules réponses. Il suffit de communiquer l’id_auteur à exclure, par exemple comme ceci : <INCLURE{fond=comments-links}{exclure_auteur=1}>

* Nombre de commentaires

À inclure, par exemple dans vos listes de billets, comme ceci : #MODELE{comments-nb} pour afficher le nombre de commentaire d’un article, par exemple, avec lien ancré vers ceux-ci. Pour n’afficher que le texte, sans lien : [(#MODELE{comments-nb}|supprimer_tags)]

* Formulaire de commentaire

ll s’agit du formulaire par défaut de SPIP, à inclure comme d’habitude : #FORMULAIRE_FORUM.

Pour le styler, on s’appuiera, selon la préférence de chacun, sur la class parente .comment-form introduite par le plugin, et/ou sur l’habituelle class .formulaire_forum, propre au formulaire par défaut de SPIP.

* Prévisualisation

Notez que la prévisu est dotée du même sélecteur CSS que chaque commentaire, .comment, et hérite donc du même habillage graphique. Pour distinguer, on emploiera le sélecteur .previsu .comment.

Autres personnalisations

Pour modifier le comportement d’une de ces inclusions, copiez le fichier correspondant dans votre répertoire squelettes et modifiez-le à votre guise.

Discussion

Aucune discussion

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