doc/ikiwiki/directive/comment.mdwn

   1 The `comment` directive is supplied by the
   2 [[!iki plugins/comments desc=comments]] plugin, and should be the only
   3 thing in a comment page. It is usually filled out by
   4 the comment plugin when a user posts a comment.
   5
   6 Example:
   7
   8         \[[!comment format=mdwn
   9         username="foo"
  10         subject="Bar"
  11         date="2009-06-02T19:05:01Z"
  12         content="""
  13         Blah blah.
  14         """
  15         ]]
  16
  17 ## usage
  18
  19 The only required parameter is `content`, the others just add or override
  20 metadata for the comment. Many parameters are shortcuts for [[meta]]
  21 directives.
  22
  23 * `content` - Text to display for the comment.
  24   Note that [[directives|ikiwiki/directive]]
  25   may not be allowed, depending on the configuration
  26   of the comment plugin.
  27 * `format` - Specifies the markup used for the content.
  28 * `subject` - Subject for the comment.
  29 * `date` - Date the comment was posted. Can be entered in
  30   nearly any format, since it's parsed by [[!cpan TimeDate]]
  31 * `username` - Used to record the username (or OpenID)
  32   of a logged in commenter.
  33 * `nickname` - Name to display for a logged in commenter.
  34   (Optional; used for OpenIDs.)
  35 * `ip` - Can be used to record the IP address of a commenter,
  36   if they posted anonymously.
  37 * `claimedauthor` - Records the name that the user entered,
  38   if anonymous commenters are allowed to enter their (unverified)
  39   name.
  40
  41 [[!meta robots="noindex, follow"]]