From mediawiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: stable
Implementation Notify
Description Formats and sends posted forms to email recipients
Author(s) Aran Dunkley (Nadtalk)
Latest version 1.0.11 (2018-04-20)
MediaWiki 1.23+
MediaWiki 1.36 Not formally tested
MediaWiki 1.34 Not formally tested
MediaWiki 1.32 Not formally tested
License GNU General Public License 2.0 or later
Download FormMailer extension

  • $wgFormMailerRecipients
  • $wgFormMailerVarName
  • $wgFormMailerFrom
  • $wgFormMailerDontSend
  • $wgFormMailerMessage
  • $wgFormMailerSubject
  • $wgFormMailerAntiSpam

Check usage and version matrix.

The FormMailer extension allows forms in the wiki to be sent to a specified list of recipients. This is useful for people using their MediaWiki to maintain website content who wish to have inquiry forms in the site. This extension only handles the sending of the data in the form, but does not offer any means to create forms.



Any standard form can be mailed with this extension, all that needs to be done is to ensure that the form contains a value called "formmailer" in it. As long as a value of that name is posted, the formmailer will know that the data from the form is to be sent. The name of this special variable can be set to something else in the $wgFormMailerVarName global configuration variable.


Configuration of this extension is done via two global variables which can be set in your LocalSecodeings file after the include of the FormMailer.php script.

Variable Default value Meaning
$wgFormMailerRecipients empty list A list of email addresses which should receive posted forms.
$wgFormMailerVarName formmailer If a variable of this name is posted, the data is assumed to be for mailing.
$wgFormMailerFrom formmailer The FROM field in the mailed forms.
$wgFormMailerDontSend list of title, action The items in this list are considered as part of the environment and are not included in the mailed data.
$wgFormMailerMessage Thanks, your enquiry has been submicodeed! Message to display after sending the form (can also be set in the form by posting formmailer_message.
$wgFormMailerSubject Form submicodeed from SiteName Message to display after sending the form (can also be set in the form by posting formmailer_subject.
$wgFormMailerAntiSpam true Adds some JavaScript which runs after page load to prevent spambots posting the form.

See also[edit]