Extension:MassMessage

From MediaWiki.org
Jump to: navigation, search
Translate this page; This page contains changes which are not marked for translation.

Other languages:
العربية • ‎català • ‎Deutsch • ‎English • ‎español • ‎suomi • ‎italiano • ‎日本語 • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎русский • ‎sicilianu • ‎سنڌي • ‎中文
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.png
MassMessage

Release status:Extension status stable

Screenshot of MassMessage MediaWiki extension.png
ImplementationTemplate:Extension#type Special page, API
DescriptionTemplate:Extension#description Allows a user to easily send a message to a list of users.
Author(s)Template:Extension#username Kunal Mehta, wctaiwan
Latest versionTemplate:Extension#version 0.4.0 (2014-01-29)
MediaWikiTemplate:Extension#mediawiki 1.25+, use REL1_X branches for your version of MediaWiki
Database changesTemplate:Extension#needs-updatephp No
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
Download
ParametersTemplate:Extension#parameters
  • $wgNamespacesToPostIn
  • $wgNamespacesToConvert
  • $wgMassMessageAccountUsername
Added rightsTemplate:Extension#rights
  • massmessage
Hooks usedTemplate:Extension#hook
ParserFirstCallInit
SpecialStatsAddExtra
RenameUserPreRename
UserGetReservedNames
UnitTestsList
APIQuerySiteInfoStatisticsInfo
BeforeEchoEventInsert

Translate the MassMessage extension if it is available at translatewiki.net

Check usage and version matrix;
Vagrant roleMediaWiki-Vagrant#Using roles 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:MassMessageHelp:Extension:MassMessage. The API documentation can be found at Extension:MassMessage/API.

Installation[edit]

  • Download and place the file(s) in a directory called MassMessage in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'MassMessage' );
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing extensions using wfLoadExtension(), since MediaWiki 1.25. If you need to install this extension in earlier versions, instead of wfLoadExtension( 'MassMessage' );, you need to use:

require_once "$IP/extensions/MassMessage/MassMessage.php";

Configuration parameters[edit]

Namespaces to post in

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

$wgNamespacesToPostIn = array( NS_PROJECT );
Namespaces to convert

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 = array( NS_USER => NS_USER_TALK );
Username

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';
Enable global messaging

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;

User rights[edit]

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

Notes[edit]

As of version 0.4.0 (current git master for MediaWiki 1.25), MassMessage requires $wgContentHandlerUseDBManual:$wgContentHandlerUseDB not to have been explicitly set to false.