Extension:EmailPage

Installation
First create a directory called EmailArticle in your wiki's extensions directory. Then, copy the source code from OrganicDesign:Extension:EmailArticle.php and save it as a file called EmailArticle.php into the newly created directory. This extension uses a single file called class.phpmailer.php from Brent R. Matzelle's phpmailer source forge project. Alternatively you can copy the file content from Class.phpmailer.php. Create a directory called phpmailer in the same location as your EmailArticle.php script resides and save the class.phpmailer.php file in the new directory.

Add an include statement into your LocalSettings.php file to include the EmailArticle.php file as usual, for example:

Usage
The extension adds a specialpage called Special:EmailArticle which requires a parameter of the article title you wish to send. It also adds links to the actions and toolbox using the link names specified in $wgEmailArticleToolboxLink and $wgEmailArticleActionLink. 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 article, 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 article 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 $wgEmailArticleContactsCat then its sub-categories will be listed in a drop-down list in the email article form. each of these sub-categories should contain articles which each represent a single contact. The first email address out of each contact article 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 article 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 articles.
 * 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 EmailArticle.php script.

CSS Stylesheets
By default the CSS used is called EmailArticle.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 EmailArticle form also has a dropdown list containing all the other CSS articles found in the wiki (all articles 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
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 article title in subject line, and fixed problem when using empty $wgEmailArticleGroup
 * Version 1.0.3 (2007-07-10)

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