MediaWiki extensions manual

MassMessage Release status: stableCategory:Stable extensions
Implementation	Special page Category:Special page extensions, API Category:API extensions
Description	Allows a user to easily send a message to a list of users.
Author(s)	Kunal Mehta, wctaiwan
Latest version	0.5.0 (2023-01-08)
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.Category:Extensions with release branches compatibility policy
MediaWiki	1.25+, use REL1_X branches for your version of MediaWikiCategory:Extensions with manual MediaWiki version
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control
Help	Help:Extension:MassMessage
Parameters $wgNamespacesToConvert $wgMassMessageAccountUsername $wgNamespacesToPostIn $wgAllowlistedMassMessageTargets $wgAllowGlobalMessaging $wgMassMessageWikiAliases
Added rights massmessage
Hooks used APIQuerySiteInfoStatisticsInfo Category:APIQuerySiteInfoStatisticsInfo extensions BeforeEchoEventInsert Category:BeforeEchoEventInsert extensions BeforePageDisplay Category:BeforePageDisplay extensions ChangeTagsListActive Category:ChangeTagsListActive extensions ListDefinedTags Category:ListDefinedTags extensions ParserFirstCallInit Category:ParserFirstCallInit extensions RejectParserCacheValue Category:RejectParserCacheValue extensions SkinTemplateNavigation::Universal Category:SkinTemplateNavigation::Universal extensions UserGetReservedNames Category:UserGetReservedNames extensions
Hooks provided MassMessageJobBeforeMessageSent
Quarterly downloads	33 (Ranked 81st)
Public wikis using	1,039 (Ranked 257th)
Translate the MassMessage extension if it is available at translatewiki.net
Vagrant role	massmessage
Issues	Open tasks · Report a bug

The MassMessage extension allows a user to send a message to a list of pages via special page Special:MassMessage. For help on how to use the extension, see Help:Extension:MassMessage . The API documentation can be found at Extension:MassMessage/API .

Installation

• Download and move the extracted MassMessage folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MassMessage
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'MassMessage' );
  

• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

When posting messages, only post them in the specified namespaces. All talk namespaces are already whitelisted.

$wgNamespacesToPostIn = [ NS_PROJECT ];

If you want users to be able to provide a link to a User: page, but have the bot post on their User talk: page you can define that here.

$wgNamespacesToConvert = [ NS_USER => NS_USER_TALK ];

What username the bot should post with. By default, this is "MediaWiki message delivery". If the user already exists, the extension will take over the account. It will be impossible for users to rename the account. You can override the default account name by specifying (for example):

$wgMassMessageAccountUsername = 'MessengerBot';

Whether to enable sending messages from one wiki to another. If running on a wikifarm setup like Wikimedia, you can disable this on all wikis except one to keep the logs in one place.

$wgAllowGlobalMessaging = true;

Maintenance script

You can send messages from the command line with

php sendMessages.php --pagelist <page list file> --subject <subject file> --message <message file>

where each line of <page list file> contains a page name followed by a wiki (database) name, separated by a tab.

User rights

• massmessage - Lets a user send out messages. By default assigned to the "sysop" user group.

• Special:MassMessage, to send a message to a delivery list.

See also

• Extension:MassMessageEmail - Emails users instead of posting on their talk pages.

This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.

This extension is included in the following wiki farms/hosts and/or packages: Canasta Category:Extensions included in Canasta Miraheze Category:Extensions included in Miraheze WikiForgeCategory:Extensions included in WikiForge This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm.