aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJoey Hess <joey@kodama.kitenet.net>2008-11-17 15:00:33 -0500
committerJoey Hess <joey@kodama.kitenet.net>2008-11-17 15:00:33 -0500
commit2e8c0bce31ed5b447c031addc00f6a0c28dbc2e1 (patch)
treeba76800b8fd27dce1d4ffaf5f496f63f3cc69d7d /doc
parent2e6157e97747673f4233a7bba3532ee3b609636e (diff)
downloadikiwiki-2e8c0bce31ed5b447c031addc00f6a0c28dbc2e1.tar
ikiwiki-2e8c0bce31ed5b447c031addc00f6a0c28dbc2e1.tar.gz
initial comments
Done inline on the page, `scuse.
Diffstat (limited to 'doc')
-rw-r--r--doc/plugins/contrib/postcomment.mdwn18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/plugins/contrib/postcomment.mdwn b/doc/plugins/contrib/postcomment.mdwn
index 9875feaae..9934baa95 100644
--- a/doc/plugins/contrib/postcomment.mdwn
+++ b/doc/plugins/contrib/postcomment.mdwn
@@ -7,14 +7,29 @@ unprivileged (or perhaps even anonymous) users to comment on posts.
Comments are saved as internal pages, so they can never be edited through the CGI,
only by direct committers. Currently, comments are always in [[ikiwiki/markdown]].
+
+> So, why do it this way, instead of using regular wiki pages in a
+> namespace, such as `$page/comments/*`? Then you could use [[plugins/lockedit]] to
+> limit editing of comments in more powerful ways. --[[Joey]]
+
Directives and raw HTML are filtered out by default, and comment authorship should
hopefully be unforgeable by CGI users.
+> I'm not sure that raw html should be a problem, as long as the
+> htmlsanitizer and htmlbalanced plugins are enabled. I can see filtering
+> out directives, as a special case. --[[Joey]]
+
When comments have been enabled generally, you still need to mark which pages
can have comments, by including the `\[[!postcomment]]` directive in them. By default,
this directive expands to a "post a comment" link plus an `\[[!inline]]` with
the comments.
+> I don't like this, because it's hard to explain to someone why they have
+> to insert this into every post to their blog. Seems that the model used
+> for discussion pages could work -- if comments are enabled, automatically
+> add the comment posting form and comments to the end of each page.
+> --[[Joey]]
+
The plugin adds a new [[ikiwiki/PageSpec]] match type, `postcomment`, for use
with `anonok_pagespec` from the [[plugins/anonok]] plugin or `locked_pages` from
the [[plugins/lockedit]] plugin. Typical usage would be something like:
@@ -53,3 +68,6 @@ Known issues:
and will be committed but not displayed; to disable comments properly you have to set the
closed="yes" directive parameter (and refresh the wiki), *then* remove the directive if
desired
+
+> I haven't done a detailed code review, but I will say I'm pleased you
+> avoided re-implementing inline! --[[Joey]]