aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/plugins/contrib/listsubscribe.mdwn25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/plugins/contrib/listsubscribe.mdwn b/doc/plugins/contrib/listsubscribe.mdwn
new file mode 100644
index 000000000..0b93cde22
--- /dev/null
+++ b/doc/plugins/contrib/listsubscribe.mdwn
@@ -0,0 +1,25 @@
+[[!template id=plugin name=listsubscribe author="[[schmonz]]"]]
+[[!template id=gitbranch branch=schmonz/listsubscribe author="[[schmonz]]"]]
+[[!tag type/web]]
+
+This plugin provides the `listsubscribe` directive, which inserts a web
+form for your readers to subscribe to a mailing list. The directive
+takes a required `listname` parameter, which must refer to one of the
+lists named in the wiki setup file.
+
+## Example
+
+In `ikiwiki.setup`:
+
+ add_plugins:
+ - listsubscribe
+
+ listsubscribe:
+ 'my supercool mailing list': supercool-subscribe@neato.great
+
+(Where `supercool-subscribe@neato.great` is the subscription address
+provided by your mailing list manager.)
+
+In any wiki page:
+
+ [[!listsubscribe listname="my supercool mailing list"]]