= Add comments to wiki pages =

== Description ==

The AddCommentMacro allows for easy addition of comments to a page, in a standard format. Each comment added is in the following form:

{{{
==== Comment by <user> on <date> ====
<comment-body>

}}}

The comment body supports normal TracWiki WikiFormatting.

Comments are added after the first line that starts with {{{[[AddComment]]}}}.

The AddCommentMacro supports previewing and adheres to the TracPermissions scheme, only allowing comments to be added if the user has write access to the page.

Since [21] the AddCommentMacro can fulfill the role of an append only Wiki page. By passing the argument ''appendonly'' to the macro, comments can be appended to the page even when the user does not have permission to modify the page. Potentially unsafe, but can be useful.



== Bugs/Feature Requests == 

Existing bugs and feature requests for AddCommentMacro are 
[report:9?COMPONENT=AddCommentMacro here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=AddCommentMacro&owner=athomas new ticket].

== Download ==

[source:addcommentmacro/0.8 AddCommentMacro for 0.8].[[BR]]
[source:addcommentmacro/0.9 AddCommentMacro for 0.9]

== Source ==

You can check out the source for AddCommentMacro from Subversion at http://trac-hacks.org/svn/addcommentmacro.

== Example ==

==== Comment by athomas on Mon 29 Nov 2004 21:48:09 EST ====
This is a comment, with WikiFormatting.

==== Comment by athomas on Mon 29 Nov 2004 22:00:56 EST ====
This is another comment, at a later date.

[[AddComment(appendonly)]]

== Author/Contributors ==

'''Author:''' [wiki:athomas athomas] [[BR]]
'''Contributors:''' [wiki:eblot eblot] (ported Trac to trunk)

[[TagIt(macro,athomas,0.8,0.9,eblot)]]