La directive comment est fournie par le module d'extension comments. Elle permet l'ajout d'un commentaire sur une page. En général, la page ne comporte que la directive et c'est le greffon lui-même qui remplit la directive quand un utilisateur poste un commentaire.

Exemple :

[[!comment  format=mdwn
username="foo"
subject="Bar"
date="2009-06-02T19:05:01Z"
content="""
Blah blah.
"""
]]

Usage

Le seul paramètre obligatoire est content. les autres paramètres ajoutent ou annulent des métadonnées.

  • content - Texte du commentaire à afficher. Les directives sont autorisées, ou non, selon la configuration du greffon « comment ».
  • format - Indique le balisage utilisé par le commentaire.
  • subject` - Sujet du commentaire.
  • date - Indique la date du commentaire. Cette date peut utiliser presque tous les formats, puisqu'elle est analysée par TimeDate.
  • username - Sert pour l'enregistrement du nom (ou OpenID) d'un commentateur présent.
  • Nom à afficher pour un commentateur présent. Facultatif. Utilisé avec les OpenID.
  • ip - Permet d'enregistrer l'adresse IP d'un commentateur, s'il envoie son commentaire de façon anonyme.
  • claimedauthor - Enregistre le nom donné par l'utilisateur, si les commentateurs anonymes ont la possibilité d'indiquer un nom (invérifié).