Manual:Hooks/ChangeTagsListActive

ChangeTagsListActive
Available from version 1.25.0
Can be used by extensions to register active change tags.
Define function:
public static function onChangeTagsListActive( &$tags ) { ... }
Attach hook: In extension.json:
{
	"Hooks": {
		"ChangeTagsListActive": "MediaWiki\\Extension\\MyExtension\\Hooks::onChangeTagsListActive"
	}
}
Called from: File(s): ChangeTags.php
Interface: ChangeTagsListActiveHook.php

For more information about attaching hooks, see Manual:Hooks .
For examples of extensions using this hook, see Category:ChangeTagsListActive extensions.


Details edit

  • &$tags: The list of tags. Add active tags (those change tags still in use) to this array.

Notes edit

This hook should be used to register tags that are still "active" or "in use".

"Active" or "in use" means that the tag will be applied to future edits or log entries. For example, an extension that applies a tag to every edit from a mobile device would register that tag as "active". However, tags applied only by disabled abuse filters would not be considered "active", because they will not be applied to any future edits unless the relevant filter is re-enabled.

Any tags registered as active by this hook should also be defined using the ListDefinedTags hook.

Extensions that just use one or two hard-coded tags will normally be able to use the same function to implement both this hook and the ListDefinedTags hook.

Example edit

See example at Manual:Hooks/ListDefinedTags.

See also edit