Manual:$wgAutopromote

From MediaWiki.org
Jump to: navigation, search
Access: $wgAutopromote
Conditions of automatic promotion of user to specific groups
Introduced in version: 1.12.0 (r28797)
Removed in version: still in use
Allowed values: array
Default value:
$wgAutopromote = array(
    "autoconfirmed" => array( "&",
        array( APCOND_EDITCOUNT, &$wgAutoConfirmCount ),
        array( APCOND_AGE, &$wgAutoConfirmAge ),
    ),
    "emailconfirmed" => APCOND_EMAILCONFIRMED,
);

1.14+

$wgAutopromote = array(
	"autoconfirmed" => array( "&",
		array( APCOND_EDITCOUNT, &$wgAutoConfirmCount ),
		array( APCOND_AGE, &$wgAutoConfirmAge ),
	),
);

Other settings: Alphabetical | By Function

Details[edit | edit source]

This array contains criteria of automatic promotion. The syntax is:

$wgAutopromote = array(
    'groupname' => cond,
    'group2' => cond,
);

cond here may be:

Possible conditions[edit | edit source]

Possible conditions (defined in Defines.php; extensions may add more through the AutopromoteCondition hook):

Condition Description Argument(s)
APCOND_EDITCOUNT Minimum number of edits necessary Integer
APCOND_AGE Minimum number of seconds since registration Integer
APCOND_EMAILCONFIRMED Email address has been confirmed (Not applicable)
APCOND_INGROUPS List of groups the user must be in E.g., 'sysop', 'bureaucrat', 'bot'
APCOND_ISIP User has a specific IP address E.g., '1.2.3.4' or '2001:0db8:85a3::7344'
APCOND_IPINRANGE User is in a specific IP range See Manual:IP ranges
APCOND_AGE_FROM_EDIT Minimum number of seconds since first edit Integer
APCOND_BLOCKED Account is blocked (added in v1.16: r52083) (Not applicable)
APCOND_ISBOT Account is a bot (Not applicable)

Conditions with and without arguments[edit | edit source]

Each condition can be written in two forms:

APCOND_EMAILCONFIRMED   # condition with no arguments
array( APCOND_EDITCOUNT, 100 )   # condition with arguments

Set of conditions[edit | edit source]

Sets of conditions have the following syntax:

array( "operand", cond1, cond2, ... );

There are 4 operands available:

  • & (AND) — promote if user matches all conditions
  • | (OR) — promote if user matches any condition
  • ^ (XOR) — promote if user matches only one of two conditions
  • ! (NOT) — promote if user matches no conditions.

The sets of conditions are evaluated recursively, so you can use nested sets of conditions linked by operands.

Caveats[edit | edit source]

Autopromotion doesn't actually add users to a group; MediaWiki will check whether a user meets the conditions for autopromotion whenever it checks the user's rights or effective groups. This means that a user will only appear to be in a group on Special:ListUsers if they were added to it through Special:UserRights. It also means you can't directly remove a user from an autopromotion group through Special:UserRights: $wgRevokePermissions might be useful for you, or if you're not using MediaWiki 1.16+, a workaround is available.

Example[edit | edit source]

If you wanted to autopromote each user to captain upon his having both confirmed his email address and either made at least 100 edits or registered his account at least 60 seconds ago, you would use:

$wgAutopromote = array(
	'captain' => array(
		'&',
		APCOND_EMAILCONFIRMED,
		'|',
		array( APCOND_EDITCOUNT, 100 ),
		array( APCOND_AGE, 60 ),
	),
);

Note that this would get rid of all other autopromote groups; to instead add the captain autopromote group while keeping those autopromote groups that already exist, one would use:

$wgAutopromote['captain'] = array(
	'&',
	APCOND_EMAILCONFIRMED,
	'|',
	array( APCOND_EDITCOUNT, 100 ),
	array( APCOND_AGE, 60 ),
);

See also[edit | edit source]

Language: English  • Deutsch • français • 日本語 • русский