Extension:EmailPage

Installation
Download the latest snapshot and extract it to your extensions directory. Then include it in your LocalSettings.php file as in the following example. The EmailPage on SVN also contains the phpmailer HTML emailing component (tested and working with version 2.0.0), but you may want to check source from phpmailer.sourceforge.net in case a later version is available.

Ensure that all the files you've downloaded and saved are accessible by the webserver.

Usage
The extension adds a specialpage called Special:EmailPage which requires a parameter of the page title you wish to send. It also adds links to the actions and toolbox using the link names specified in $wgEmailPageToolboxLink and $wgEmailPageActionLink. Either one can be set to "" (empty) to remove the link.

The specialpage form has two main sections, one for selecting the recipients of the emailed page, the other to specify the specifics of the subject line, prepended message and CSS stylesheet.

Selecting recipients
There are three different ways of specifying recipients for the page to be sent to, which are described below. All three can be used together in composing an overall selection of recipients.

All the available MediaWiki groups are listed in a drop-down list. If one of these is selected then all the members of that group which have an email address will be added to the recipient list.
 * From group

If a category name is specified in $wgEmailPageContactsCat then its sub-categories will be listed in a drop-down list in the email page form. each of these sub-categories should contain pages which each represent a single contact. The first email address out of each contact page will be added to the list of recipients.
 * From contacts category

A textarea is supplied in the for for adding additional recipients directly. These recipients can be entered directly as email addresses on each line, or separated by comma's, semicolons or asterisks (bullet list). If an item is not an email address, it will be treated as a contact page title which from which the first email address will be extracted. This textarea is treated as wikitext and will have templates expanded before extracting the email addresses which means that it can contain a DPL query which could result in a list of email addresses or contact pages.
 * Directly from a list

Configuration settings
Here are some global variables which affect the operation of the extension. These should be set in your LocalSettings file after the include of the EmailPage.php script.

CSS Stylesheets
By default the CSS used is called EmailPage.css which is intended to be a cut down compact css based on the stylesheet for you wiki but with all the portlet, actions and other skin related styles removed.

The EmailPage form also has a dropdown list containing all the other CSS pages found in the wiki (all pages with titles ending in .css).

MediaWiki versions

 * Works on 1.9.x and 1.10
 * Has a fatal error in 1.6.x

Todo & bugs

 * Usage documentation !!
 * Multibyte characters not rendering in emails properly
 * Add toolbox link automatically
 * ea_autherror message not working
 * PLURAL's not working
 * Title not showing in subject's default message anymore
 * Should log sends to an MW log
 * Allow setting FROM field, default to users email address

Change log
Extension renamed from EmailArticle to EmailPage. All configurable settings have also been renamed. Update your LocalSettings.php on update!
 * Version 1.2.0 (2008-07-13)

Don't rely on REGEXP for SQL queries, not supported by some database types
 * Version 1.0.9 (2008-01-19)

Fixed warning messages in MW1.11
 * Version 1.0.5 (2007-09-14)

Needs $this->setHeaders in execute
 * Version 1.0.4 (2007-08-27)

Fixed blank page title in subject line, and fixed problem when using empty $wgEmailPageGroup
 * Version 1.0.3 (2007-07-10)

Added $wgEmailPageToolboxLink and $wgEmailPageActionLink globals for adding toolbox and action links
 * Version 1.0.1 (2007-06-08)