This is an old revision of the document!
Table of Contents
groupmail Plugin
Compatible with DokuWiki
Hrun
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to contact, contactmodern
Description
This plugin provides a simple email form which allows the user to send email to preconfigured recipients with archiving functionality of the sent emails. Email recipients can be a list of
- email addresses
- registered dokuwiki users
- the members of dokuwiki groups
This allows one to use docuwiki as a mailing list for a wiki group.
Installation
Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.
Examples/Usage
The easiest use is as follows
{{groupmail>}}
by which you create an email send form on your wiki page. When send is hit, the message will be delivered to the default recipient as configured in the configuration panel, while archiving each mail in the preconfigured log file.
A more complex example
{{groupmail>touser=dokuuser|autofrom|sendlog=:groupmail:mylog} [[:groupmail:mylog|See old messages]]
creates an email form without name and sender email input field, which
are automatically populated from the user being logged in. The sent
emails are then saved in :groupmail:mylog
, to which a link is
provided after the form.
Syntax
Basic syntax:
{{groupmail>action}}
- action can be a | separated list of:
- autofrom — use sender identity from current user
- subject=… — specify the email subject
- content=… — preinsert content in the email body
- toemail=… — comma-separated list of recipient email addresses
- touser=… — comma-separated list of recipient registered users of the dokuwiki
- togroup=… — comma-separated list of dokuwiki groups
Configuration and Settings
The plugin can be configured with the following options via the configuration tool:
- $conf['default'] = 'default@example.com'; - the default recipient of the emails.
- $conf['sendlog'] = ':groupmail:log'; - where sent emails are archived.
- $conf['captcha'] = 0; - turn on/off captcha
- $conf['recaptchakey'] = '';
- $conf['recaptchasecret'] = '';
- $conf['recaptchalayout'] = 'red';
Change Log
- 2015-09-27
- Initial release
Known Bugs and Issues
Captcha
Inherited from contactmodern which this plugin was derived from:
- Only one contact form per page accepts reCaptcha.
- REcaptcha often doesn't load of conflicts