Send Email Plugin

Usage

1. Create a form on the page that invokes the sendemail script
2. Add a "to" field and a submit button
3. Make sure to fill in allowed 'to' addresses in setting {Permissions}{Allow}{MailTo} in configure

Example

Show code Hide code

<form enctype="application/x-www-form-urlencoded" name="mailform" action="%SCRIPTURL{sendemail}%/%WEB%/%TOPIC%" method="POST">
<input type="hidden" name="subject" value="hello!" />
Send to: <input class="foswikiInputField" name="to" size="30" type="text" value="email address..." />&nbsp;
<input type="submit" class="foswikiSubmit" value="Send" />
</form>

Usage details

1. An HTML form
2. Allow/restrict settings in configure
3. Optionally a feedback message macro SENDEMAIL
4. Optionally a custom email template

HTML form elements

<form enctype="application/x-www-form-urlencoded" name="mailform" action="%SCRIPTURL{sendemail}%/%WEB%/%TOPIC%" method="POST">
... fields ...
<input type="submit" class="foswikiSubmit" value="Send" />
</form>

Allow/restrict settings

• {Plugins}{SendEmailPlugin}{Permissions}{Allow}{MailTo} - enter .* to allow to send to anyone
• {Plugins}{SendEmailPlugin}{Permissions}{Deny}{MailTo}

• {Plugins}{SendEmailPlugin}{Permissions}{Allow}{MailFrom}
• {Plugins}{SendEmailPlugin}{Permissions}{Deny}{MailFrom}
• {Plugins}{SendEmailPlugin}{Permissions}{Allow}{MailCc}
• {Plugins}{SendEmailPlugin}{Permissions}{Deny}{MailCc}

Examples of allow/restrict settings

• Allow to send to:
  • Set {SendEmailPlugin}{Permissions}{Allow}{MailTo} to:
    • john@tar.com to only allow to send mails to John
    • john@tar.com|mary@look.ca to allow to send mails to John and Mary
    • .*@tar.com to send mails to any address at @tar.com
    • .*@tar.com,mary@.* to send mails to any address at @tar.com and to all Marys in the world
• Deny to send to:
  • Set {SendEmailPlugin}{Permissions}{Deny}{MailTo} to:
    • .*@tar.com to deny to any address at @tar.com
    • .* to deny any address (no emails will be sent)

Feedback notifications

%SENDEMAIL%

The message can be tailored using SENDEMAIL parameters:

Feedback notification example

%SENDEMAIL{
feedbackSuccess="Request sent, we'll contact you shortly."
feedbackError="Could not send your message, please contact us."
format="<div class=\"foswikiNotification\">$message</div>"
}%

Email template

From: %FROM%
To: %TO%
CC: %CC%
Subject: %SUBJECT%
Auto-Submitted: auto-generated

%BODY%

The search path for templates always starts in the current web.

Examples

Example with a handcrafted HTML form

Show code Hide code

<form enctype="application/x-www-form-urlencoded" name="mailform1" action="%SCRIPTURL{sendemail}%/%WEB%/%TOPIC%" method="POST">
<fieldset>
<legend><b>Send Email</b></legend>
<div class="foswikiFormSteps">
<div class="foswikiFormStep">
<h3>To:</h3>
<input class="foswikiInputField" id="to" name="to" size="30" type="text" value="%URLPARAM{"to"}%" />
</div>
<div class="foswikiFormStep">
<h3>CC:</h3>
<input type="text" class="foswikiInputField" id="cc" name="cc" size="30"  value="%URLPARAM{"cc"}%" />
</div>
<div class="foswikiFormStep">
<h3>Subject:</h3>
<input type="text" class="foswikiInputField" id="subject" name="subject" size="70" value="%URLPARAM{"subject"}%" />
</div>
<div class="foswikiFormStep">
<h3>Message:</h3>
<textarea class="foswikiInputField" cols="70" name="body" rows="6" style="width:100%">%URLPARAM{"body"}%</textarea>
</div>
<div class="foswikiFormStep">
<input type="submit" class="foswikiSubmit" value="Send" />
</div>
</div>
</fieldset>
</form>
%SENDEMAIL{
feedbackSuccess="Request sent, we'll contact you shortly."
feedbackError="Could not send your message, please contact us."
format="<div class=\"foswikiNotification\">$message</div>"
}%

Example with FormPlugin

Show code Hide code

%STARTFORM{
name="mailForm"
action="%SCRIPTURL{sendemail}%/%WEB%/%TOPIC%"
method="POST"
}%
<fieldset style="border:1px solid #ddd; padding:1em">
<legend><b>Send Email</b></legend>
%RED%*%ENDCOLOR% All fields are required.
%FORMELEMENT{
   name="Subject"
   type="hidden"
   default="This is a test"
}%%FORMELEMENT{
   name="Name"
   type="text"
   mandatory="on"
   validate="nonempty"
   title="Name (First and Last):"
}%%FORMELEMENT{
   name="To"
   type="text"
   mandatory="on"
   validate="email"
   title="E-mail Address:"
}%%FORMELEMENT{
   name="body"
   type="textarea"
   rows="10"
   cols="80"
   cssclass="foswikiHidden"
   default="From: $Name
Email: $Email"
}%%FORMELEMENT{
   type="submit"
   buttonlabel="Send"
}%
</fieldset>
%ENDFORM%

%SENDEMAIL{feedbackSuccess="Request sent, we'll contact you shortly." feedbackError="Could not send your message, please contact us." }%

FAQ

How do I create linebreaks in the email body?

How do I send data form fields?

• put them in a hidden field:

  <input type="hidden" name="body" value="Title: %FORMFIELD{"Title"}%, Summary: %FORMFIELD{"Summary"}%" />
  

• preserve linebreaks by putting them in a textarea:

  <textarea name="body" class="foswikiHidden" cols="80" rows="6">
  Title: %FORMFIELD{"Title"}%
  Summary: %FORMFIELD{"Summary"}%
  </textarea>
  

Plugin test

• SendEmailPlugin is <span class=.

Plugin Settings * Plugin settings are set in configure.

• Note: by default any emailing is prohibited. Change the settings in configure to set to which addresses you allow mails to be sent from and to.

CSS classes

Installation Instructions

cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install

Change History