summaryrefslogtreecommitdiff
path: root/doc/plugins/contrib/postal.mdwn
blob: b14c80d3b21ce5e1f47b093e4adb0a4888affb74 (plain)

[[!template id=plugin name=postal author="[[DavidBremner]]"]] [[!tag type/useful]]

The postal plugin allows users to send mail to a special address to comment on a page. It uses the [[mailbox]] plugin to display their comments in the wiki.

This plugin is not in ikiwiki yet, but can be downloaded from http://pivot.cs.unb.ca/git/ikipostal.git

Details:

  • Adds a mailto: url to each page matching some pagespec (currently every page gets a comment footer)

  • This mailto url goes to an address identifying the page (something like user-iki-blog~I_hate_markdown@host.fqdn.tld). more details

  • on the mail receiving end, these messages are either deleted, or ran through a filter to be turned into blog posts. As a first step, I have written a filter that decodes the address and writes the message into an appropriate mailbox. I would be interested in any ideas people have about security.

  • the same plugin can check for comments on a particular page next time the wiki is generated, and add a link. (more or less done)

    If the filter just checks in the posts into revision control, the post-commit hook would handle updating the wiki to include those posts as they come in. --[[Joey]]

  • work in progress can be

The current version of this plugin is now running on my home page. See for example a recent post in my blog.
Unfortunately although the [[mailbox|todo/mbox]] renderer supports threading, I haven't had a chance to implement comments on comments yet. --[[DavidBremner]]