Installation

Télécharger l'extension hum où installer là directement depuis l'interface d'administration de votre blog. Pour plus d'informations concernant l'installation d'une extension, consultez la documentation de Dotclear à ce sujet. Une fois l'installation effectuée, vous verrez " Commentaires inutiles" apparaître sur l'administration de votre blog dans la colonne de gauche sous le titre "EXTENSIONS".

Modifications

L'extension apporte des modifications à la base de donnée de Dotclear. Elle ajoute un champs à la table comment :

  • comment_selected, smallint, false, 0

Elle ajoute également des paramètres :

  • active, false, boolean, activation de l'extension
  • comment_selected, false, boolean, état par défaut des nouveaux commentaires
  • jquery_hide, true, boolean, utilisation de routine jquery pour cacher les commentaires non sélectionnés coté publique
  • title_tag, dt, string, Nom de la balise HTML du titre d'un commentaire dans le template post.html
  • content_tag, dd, string, Nom de la balise HTML du contenu d'un commentaire dans le template post.html
  • css_extra, .., string, CSS supplémentaire pour accorder cette extension au thème

Template

Plusieurs balises et bloc de template sont disponibles pour modifier le comportement sur les commentaires ils sont actifs à l'intérieur d'un bloc Comments.

Bloc CommentSelectedIf :

Ce bloc permet de tester si un commentaire est sélectionné ou non et d'afficher le contenu du bloc. Pour tester le commentaire il faut ajouter l'attribue is_selected="1" (ou 0 si on souhaite le comportement inverse)

Tag CommentIfSelected :

Cette balise permet d'ajouter un texte (ou autre) à sa place si le commentaire est sélectionné. Il supporte l'attribue return="" qui sera retourné si le commentaire est sélectionné. Par défaut selected sera retourné.

Tag CommentIfNotSelected :

Cette balise permet d'ajouter un texte (ou autre) à sa place si le commentaire est sélectionné. Il supporte l'attribue return="" qui sera retourné si le commentaire est sélectionné. Par défaut unselected sera retourné.

Mise en œuvre

Dans l'administration de l'extension il faut paramétrer les options générales. Les balises HTML de titre et contenu ne servent que si on utilise les routines jQuery. (interactivité)

Dans le thème utilisé sur votre blog, il faut modifier les pages contenant des commentaires, c'est à dire utilisant le bloc Comments. (post.html)

Par exemple si vous souhaitez uniquement ajouter une classe CSS aux commentaires il suffit d'ajouter {{tpl:CommentIfSelected}} sur le titre d'un commentaire: <dt id="c{{tpl:CommentID}}" class="{{tpl:CommentIfMe}} {{tpl:CommentIfOdd}} {{tpl:CommentIfFirst}} {{tpll:CommentIfSelected}}">

Si vous souhaitez l'inverse, il faut utiliser la balise {{tpl:CommentIfNotSelected}}

Si vous souhaitez utiliser la fonction interactive jQuery qui permet de cacher par défaut les commentaires non sélectionnés, il faut que le thème ai chargé les scripts jQuery, qu'il possède le behavior PublicHeadContent, et qu'il ai dans les commentaires la balise {{tpl:CommentIfSelected}} sur le titre d'un commentaire. Et que les balises HTML de titre et de contenu soient renseignées dans l'administration du plugin. (le thème par défaut respecte toutes ces prérogatives)

Utilisation

Une fois l'extension installée et paramétrée, il est possible de modifier la sélection d'un commentaire à plusieurs endroits:

Sur la liste des commentaires, il faut cocher les commentaires à modifier puis choisir dé/sélectionner dans la boite d'action.

Sur l'édition d'un commentaire, il faut dé/cocher la sélection d'un commentaire puis enregistrer la modification.

Sur la liste des billets, il faut cocher les billets concernés puis choisir dé/sélectionné dans la partie commentaire de la boite d'action. tous les commentaires des billets sélectionnés prendront alors le nouvel état.