Optional are the fields cc, subject, body, template, redirectto, successsection and errorsection
The from field may be used but defaults to the address of the current user.
To show feedback write %SENDEMAIL% anywhere on the page where the feedback should appear.
Optionally pass parameters feedbackSuccess and feedbackError. Default feedback messages are set below in Plugin Settings.
The redirectto is an url to redirect to a different landing page after the mail has been sent.
The successsection parameter optionally sets the named section to be extracted.
The errorsection parameter specifies the named section to be extracted when an error occured.
To customize the email, including its header, create a new template file (or topic) and set the template parameter to it. The default template is stored in the sendemail.tmpl file:
From: %FROM%
To: %TO%
CC: %CC%
Subject: %SUBJECT%
%BODY%
The tags %FROM%, %TO%, %CC%, %SUBJECT% and %BODY% are replaced with the respective url parameter when the email is created.
The value of the recipient's and sender's email address can be restricted using the preference variables: ALLOWMAILTO, DENYMAILTO, ALLOWMAILFROM, DENYMAILFROM, ALLOWMAILCC and DENYMAILCC. Each can be a list of comma separated regular expressions that emails are checked against before allowing the mail to be send. This is needed to prevent this plugin from being used as an open email relay and potentially being missused to create spam emails. By default, this plugin will prohibit any email to be send. You will have to change the settings below to match your needs. Preferably, keep the settings as they are as a security measure and enable sending emails on a per-form basis by setting the respective topic preferences in the topic holding the send-email form. For example, to allow the email form on the current topic to be send to the support, use the following settings
* Set ALLOWMAILTO = support
* Set DENYMAILTO =
* Set DENYMAILFROM =
Note, that the From, To and CC parameters can be either an email address or a wiki user name, in which case the email address of that wiki user is used instead.
Styles sendEmailPluginNotification in case of an error
Plugin Installation Instructions
Note: You do not need to install anything on the browser to use this
plugin. The following instructions are for the administrator who installs the
plugin on the server where TWiki is running.
Download the ZIP file from the Plugin web (see below)
Unzip SendEmailPlugin.zip in your twiki installation directory. Content:
1.2.1 TWiki:Main/MichaelDaum: added support for TWiki-5; fixed sending emails to login names
26 Jun 2008
1.2.0 TWiki:Main/MichaelDaum: added ALLOW/DENY preference settings to prevent this plugin from being used as an open spam relay; added template option allowing more control over email header etc; fixed mod_perl/perperl coding errors; sender address is the current user, it will default to the wikimaster's only as a last resort; allow user names in addition to plain email addresses in From, To and Cc; allow multiple users in To and Cc; added a redirectto, successsection and errorsection options to land on a different feedback page; reorganized code for lazy compilation
16 may 2007
1.1.3 TWiki:Main/ArthurClemens: fixed bug in bin script that caused form query data to get emptied.
1.1.1 TWiki:Main/ArthurClemens: changed sendmail script invocation to be called through bin script sendemail; added CSS styles for feedback notification; fixed typo 'feedbackSucces'.
Copyright � by the contributing authors. All material on this collaboration platform is the property of the contributing authors. Ideas, requests, problems regarding TWiki? Send feedback Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.SendEmailPlugin