This was a very rapidly slung together form handler to take all the form fields from a WikiForm and email them to someone. Much work as originally posted has been updated, commented and the packaged into a jar file. A redirect parameter has been added so that, if the parameter is added, the user will be redirected to a new page on successful posting.

You need to set up the SMTP server to be used in the jspwiki.properties file like this...

jspwiki.formMailer.smtpHost = ''(your-host)''

and "org.jspwiki.plugins" to the plug-ins path as in:

jspwiki.plugin.searchPath = org.jspwiki.plugins

Install the jar file in <wiki home>/WEB-INF/lib

Parameters#

mailerFrom	email address to send from
mailerTo	email address to send to
mailerCC	CC address
mailerBCC	Bcc address
mailerSubject	Subject line of the email
mailerRedirect	The wiki page to redirect to on success

Example#

[{FormSet form='mailer' mailerFrom='wiki@somewhere.net' mailerTo='subscribe@somewhere.com' mailerSubject='Subscribe Me!' mailerRedirect='ThankYou'}]

[{FormOutput form='mailer' handler='FormMailerPlugin' populate='handler'}]

[{FormOpen form='mailer'}]

Title : [{FormSelect name='Title' value='Mr;Mrs;Ms;Miss;'}]\\
Name : [{FormInput type='text' name='FirstName'}]\\
Comments : [{FormTextarea name='Comments' rows=5 cols=40}]\\
[{FormInput type='submit' name='submit' value='Submit'}]

[{FormClose}]

This example will send an email from wiki@somwhere.net to subscribe@somwhere.net with the subject "Subscribe Me!" and the email body will be (for example)...

Title;
Mr

Name;
Dave S-B

Comments;
Hi, just trying out this email lark...

The user will be redirected to the wiki page "ThankYou".

More help#

If you need more help with this then please feel free to use the contacts form at http://www.quru.com/contacts.html ContributedFormHandlers

---

--Gerard Perreault, 2011-01-31

I liked the potential of this plugin but I found that it was lacking when it came to the actual email content. Obviously it was just meant as a test. So I tweaked a few things. For one thing, I did not use the "mailerFrom" parameter. Instead, I added a "mailerDomain" parameter which I use to create an email address by concatenating the user ID (not his name), the @ symbol and the mailerDomain value.

The new plugin will look for another page of the same name as the page containing the form fields, but with the word "Email" appended. For example, this FormMailerPlugin page would need a FormMailerPluginEmail page as template for the email to be sent. This provides some added security as a user creating a form can not email themselves a form they have no access to.

I did not investigate all the intricacies of allowing to send emails like this. You might want the code to be modified so that only authenticated users can send an email. And you might want to limit the number of email they can send at any given time to avoid your site being used to send spam. None of that is coded yet. :-)