Typedefs
using	$status

using	name

Functions
for adding new MIME info to the list Use $mimeMagic	addExtraTypes ( $stringOfTypes)

the	array () calling protocol came about after MediaWiki 1.4rc1.

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect to be fed to an HTMLForm object and populate $result with the reason in the form of	array (messagename, param1, param2,...) or a MessageSpecifier instance(you might want to use ApiMessage to provide machine-readable details for the API). For consistency

the other converts the title to all uppercase letters in MediaWiki we would handle this as	follows (note:not real code, here)

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist you will want to construct new ChangesListBooleanFilter or ChangesListStringOptionsFilter objects When constructing you specify which group they belong to You can reuse existing	groups (accessed through $special->getFilterGroup)

	if ( $wgReverseTitle)

function	ldapLogin ( $username, $password)

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing	options (say) and put it in one place. Instead of having little title-reversing if-blocks spread all over the codebase in showAnArticle

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist you will want to construct new ChangesListBooleanFilter or ChangesListStringOptionsFilter objects When constructing you specify which group they belong to You can reuse existing or create your	own (ChangesListBooleanFilterGroup or ChangesListStringOptionsFilterGroup). If you create new groups

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the	query (e.g. "log_action != 'revision'") - showIfEmpty boolean Set to false if you don 't want any output in case the loglist is empty if set to true(default)

processing should stop and the error should be shown to the user if you wanted to authenticate users to a custom	system (LDAP, another PHP program, whatever)

Returning false makes less sense for events where the action is and will normally be ignored Note that none of the examples made use of create_function() as a way to attach a function to a hook. This is known to cause problems(notably with Special this is a necessary inconvenience to make it possible to pass reference	values (that can be changed) into the hook code. Also note that earlier versions of wfRunHooks took a variable number of arguments

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a set this to the key of the message First element is the message additional optional elements are parameters for the key that are processed with	wfMessage () -> params() ->parseAsBlock() - offset Set to overwrite offset parameter in $wgRequest set to '' to unset offset - wrap String Wrap the message in html(usually something like "<div ...>$1</div>"). - flags Integer display flags(NO_ACTION_LINK, NO_EXTRA_USER_LINKS) 'LogException':Called before an exception(or PHP error) is logged. This is meant for integration with external error aggregation services

Variables
please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account incomplete &	$abortMsg

Using a hook running we can avoid having all this option specific stuff in our mainline code Using the function array	$article

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing &	$attribs

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used the name of the old file when set the default code will be skipped true if there is text before this autocomment	$auto

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges	$changesList

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable &	$code

the value of this variable comes from LanguageConverter indexed by page_id &	$colours

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on and they can depend only on the ResourceLoaderContext	$context

null means default &	$customAttribs

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache allow viewing deleted revs &	$differenceEngine

returning false will NOT prevent logging	$e

passed in as a query string parameter to the various URLs constructed here(i.e. $prevlink) $ldel you ll need to handle error etc yourself modifying $error and returning true will cause the contents of $error to be echoed at the top of the edit form as wikitext Return true without altering $error to allow the edit to proceed &	$editor

the value to return A Title object or null for latest all implement SearchIndexField	$engine

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers &	$extTypes

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves	$handler

see documentation in includes Linker php for Linker::makeImageLink &	$handlerParams

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses &	$html

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check	$image

processing should stop and the error should be shown to the user if you wanted to authenticate users to a custom you could	$ldapServer

usually copyright or history_copyright This message must be in HTML not wikitext &	$link

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing after in associative array form before processing starts Return false to skip default processing and return $ret	$linkRenderer

either a unescaped string or a HtmlArmor object after in associative array form externallinks	$linksUpdate

namespace are movable Hooks may change this value to override the return value of MWNamespace::isMovable(). 'NewDifferenceEngine' if it s text intended for display in a monospaced font	$localize

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place or wrap services the preferred way to define a new service is the $wgServiceWiringFiles array change it to the message you want to define you are encouraged to submit patches to MediaWiki s core to add new MIME types to mime types	$mimeMagic

Allows to change the fields on the form that will be generated	$name

namespace and then decline to actually register it &	$namespaces

also included in $newHeader if any	$newminor

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect	$newtalks

passed in as a query string parameter to the various URLs constructed here(i.e. $nextlink) $rdel also included in $oldHeader	$oldminor

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped &	$options

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output	$out

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place	$output

do that in ParserLimitReportFormat instead	$parser

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used the name of the old file when set the default code will be skipped	$pre

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify	$query

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next	$refreshCache

this hook is for auditing only	$req

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on	$request

Allows to change the fields on the form that will be generated are created Can be used to omit specific feeds from being outputted You must not use this hook to add use OutputPage::addFeedLink() instead. & $feedLinks hooks can tweak the array to change how login etc forms should look	$requests

namespace and then decline to actually register it file or subcat	$res

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on and they can depend only on the ResourceLoaderContext such as when responding to a resource loader request or generating HTML output &	$resourceLoader

For QUnit the mediawiki tests qunit testrunner dependency will be added to any module &	$ResourceLoader

this hook is for auditing only	$response

namespace being checked &	$result

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses &	$ret

please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account incomplete not yet checked for validity &	$retval

presenting them properly to the user as errors is done by the caller return true use this to change the list i e etc	$rev

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters create2 Corresponds to logging log_action database field and which is displayed in the UI &	$revert

also included in $newHeader	$rollback

the value to return A Title object or null for latest all implement SearchIndexField must implement ResultSetAugmentor &	$rowAugmentors

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults also a ContextSource after deleting those rows but within the same transaction	$rows

usually copyright or history_copyright This message must be in HTML not wikitext if the section is included from a template	$section

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place or wrap services the preferred way to define a new service is the $wgServiceWiringFiles array	$services

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned	$skin

this hook is for auditing only RecentChangesLinked and Watchlist	$special

returning false will NOT prevent logging a wrapping ErrorException	$suppressed

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections and Diff &	$tabindex

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist &	$tables

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping	$template

For QUnit the mediawiki tests qunit testrunner dependency will be added to any module whereas SearchGetNearMatch runs after	$term

see documentation in includes Linker php for Linker::makeImageLink &	$time

namespace and then decline to actually register it file or subcat img or subcat	$title

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache	$unhide

please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account	$user

this hook is for auditing only or null if authentication failed before getting that far	$username

static configuration should be added through ResourceLoaderGetConfigVars instead &	$vars

An extension or a local will often add custom code to the function with or without a global variable For someone wanting email notification when an article is shown may	$wgCapitalizeTitle

	$wgHooks ['ArticleShow'][] = 'reverseArticleTitle'

An extension or a local will often add custom code to the function with or without a global variable For someone wanting email notification when an article is shown may	$wgNotifyArticle

please add to it if you re going to add events to the MediaWiki code	AbortAutoAccount

An extension or a local will often add custom code to the function with or without a global variable For someone wanting email notification when an article is shown may	add

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In	addition

An extension or a local	admin

passed in as a query string parameter to the various URLs constructed here(i.e. $prevlink) $ldel you ll need to handle error etc yourself	Alternatively

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a third party developers and local administrators to define code that will be run at certain points in the mainline and to modify the data run by that mainline code Hooks can keep mainline code and make it easier to write extensions Hooks are a principled alternative to local patches for two options in MediaWiki One reverses the order of a title before displaying the	article

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place	ATTENTION

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that	AuthPluginAutoCreate

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub	AutopromoteCondition

Using a hook running we can avoid having all this option specific stuff in our mainline code Using the function	becomes

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array	BeforeDisplayNoArticleText

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable	BeforeInitialize

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable	BeforeParserFetchFileAndTitle

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result	BitmapHandlerTransform

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters	block

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves set to a MediaTransformOutput	BlockIp

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves set to a MediaTransformOutput the error message to be returned in an array	BlockIpComplete

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect to be fed to an HTMLForm object and populate $result with the reason in the form of error messages should be plain text with no special	bolding

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped	broken

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid	bugs

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections and Diff or overridable Default is either copyrightwarning or copyrightwarning2 overridable Default is editpage tos summary such as anonymity and the real	check

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those	classes

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a third party developers and local administrators to define code that will be run at certain points in the mainline	code

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect to be fed to an HTMLForm object and populate $result with the reason in the form of error messages should be plain text with no special	coloring

Returning false makes less sense for events where the action is	complete

namespace addition is	conditional

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a third party developers and local administrators to define code that will be run at certain points in the mainline and to modify the data run by that mainline code Hooks can keep mainline code and make it easier to write extensions Hooks are a principled alternative to local patches	Consider

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on and they can depend only on the ResourceLoaderContext such as when responding to a resource loader request or generating HTML output included in	core

the other converts the title to all uppercase letters	Currently

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of	data

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing	deleteAnArticle

also included in $newHeader if any indicating whether we should show just the	diff

processing should stop and the error should be shown to the user if you wanted to authenticate users to a custom you could	do

in this case you re responsible for computing and outputting the entire conflict i	e

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections and Diff or overridable Default is either copyrightwarning or copyrightwarning2	EditPageGetCheckboxesDefinition

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections and Diff or overridable Default is either copyrightwarning or copyrightwarning2 overridable Default is editpage tos summary	EmailConfirmed

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults	error

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect to be fed to an HTMLForm object and populate $result with the reason in the form of error messages should be plain text with no special etc to show that they re	errors

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing	etc

how to add hooks for an	event

and how to run hooks for an and one after Each event has a preferably in CamelCase For	example

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing	exportArticle

processing should stop and the error should be shown to the user *	false

Allows to change the fields on the form that will be generated are created Can be used to omit specific feeds from being outputted You must not use this hook to add	feeds

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing we can concentrate it all in an extension	file

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used	FileDeleteComplete

null means default in associative array	form

if the prop value should be in the metadata multi language array	format

For QUnit	framework

null for the local wiki Added should default to null in handler	functions

null for the local wiki Added should default to null in handler for backwards compatibility	GalleryGetModes

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist	Generally

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options	GetCanonicalURL

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list	GetDefaultSortkey

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache allow viewing deleted revs difference engine object to be used for diff	GetDoubleUnderscoreIDs

the value of this variable comes from LanguageConverter	GetLinkColours

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys	GetLocalURL

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect to be fed to an HTMLForm object	GetRelativeTimestamp

presenting them properly to the user as errors is done by the caller return true	getUserPermissionsErrorsExpensive

presenting them properly to the user as errors is done by the caller return true	GitViewers

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves set to a MediaTransformOutput the error message to be returned in an array you should do so by altering $wgNamespaceProtection and $wgNamespaceContentModels outside the	handler

they could be provided by a third party developer or written by the admin him	herself

presenting them properly to the user as errors is done by the caller return true use this to change the list i e etc next in line in page	history

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a	hook

Using a hook running we can avoid having all this option specific stuff in our mainline code Using	hooks

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place or wrap services	However

either a unescaped string or a HtmlArmor object after in associative array form	imagelinks

see documentation in includes Linker php for Linker::makeImageLink or false for current used if you return false	ImageOpenShowImageInlineBefore

null for the local wiki Added	in

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and	insert

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure	Instead

you don t have to do a grep find to see where the $wgReverseTitle variable is say If the code is well enough	isolated

presenting them properly to the user as errors is done by the caller return true but is called only if expensive checks are enabled Add a permissions error when permissions errors are checked for Return false if the user can t do	it

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a set this to the key of the message First element is the message	key

usually copyright or history_copyright This message must be in HTML not wikitext if the section is included from a template to be included in the	link

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections	Live

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation	LogEventsListGetExtraInputs

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters	LogLine

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title	MarkPatrolled

hooks txt This document describes how event hooks work in	MediaWiki

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a	message

passed in as a query string parameter to the various URLs constructed here(i.e. $prevlink) $ldel you ll need to handle error	messages

for adding new MIME types to the list	ModifyExportQuery

either a unescaped string or a HtmlArmor	object

return true to allow those checks to	occur

When an event	occurs

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going	on

and how to run hooks for an and one after Each event has a preferably in CamelCase For	PageContentSave

and how to run hooks for an and one after Each event has a preferably in CamelCase For	PageContentSaveComplete

either a unescaped string or a HtmlArmor object after in associative array form	pagelinks

namespace are movable Hooks may change this value to override the return value of MWNamespace::isMovable(). 'NewDifferenceEngine' if it s text intended for display in a monospaced font $report should be output in English	ParserLimitReportPrepare

in this case you re responsible for computing and outputting the entire conflict	part

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been	performed

either a	plain

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections	Preview

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing after	processing

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist	RecentChangesLinked

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place	replace

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters create2 Corresponds to logging log_action database field and which is displayed in the UI similar to $comment this hook should only be used to add variables that depend on the current page	request

presenting them properly to the user as errors is done by the caller return true use this to change the list i e	rollback

Allows to change the fields on the form that will be generated	rss

This code would result in ircNotify being run twice when an article is	saved

set to $title object and return false for a match	SearchGetNearMatch

set to $title object and return false for a match	SearchGetNearMatchBefore

the value to return A Title object or null	SearchGetNearMatchComplete

the value to return A Title object or null for latest	SearchIndexFields

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a third party developers and local administrators to define code that will be run at certain points in the mainline and to modify the data run by that mainline code Hooks can keep mainline code	simple

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache allow viewing deleted revs difference engine object to be used for diff	source

Using a hook running	strategy

This code would result in ircNotify being run twice when an article is and once for brion Hooks can return three possible true was required This is the default since MediaWiki *some	string

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that	structure

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist you will want to construct new ChangesListBooleanFilter or ChangesListStringOptionsFilter objects When constructing	them

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return	true

Having all this code related to the title reversion option in one place means that it s easier to read and	understand

presenting them properly to the user as errors is done by the caller return true use this to change the list i e	undo

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set	up

you don t have to do a grep find to see where the $wgReverseTitle variable is	used

and how to run hooks for an and one after Each event has a preferably in CamelCase For	UserLogin

This code would result in ircNotify being run twice when an article is and once for brion Hooks can return three possible	values

We ve cleaned up the code here by removing clumps of	weird

An extension	writer

Typedef Documentation

◆ $status

using $status

Definition at line 1051 of file hooks.txt.

◆ name

to move a page</td >< td > &*You are moving the page across *A non empty talk page already exists under the new name

Definition at line 1840 of file hooks.txt.

Function Documentation

◆ addExtraTypes()

for adding new MIME info to the list Use $mimeMagic addExtraTypes ( $stringOfTypes )

◆ array() [1/2]

the array ( )

Referenced by MemcachedClient::__construct(), MagicWord::__construct(), Message::__construct(), ResourceLoaderImage::__construct(), ResourceLoaderFileModule::__construct(), HOTPResult::__construct(), FSFileBackend::__construct(), IndexPager::__construct(), BatchRowIterator::__construct(), MediaWikiTitleCodec::__construct(), MemcachedClient::_flush_read_buffer(), MemcachedClient::_incrdecr(), MemcachedClient::_load_items(), ApiBase::addDeprecation(), ApiErrorFormatter::addMessagesFromStatus(), ApiQueryBase::addWhereRange(), ApiQuerySiteinfo::appendGeneralInfo(), ApiResult::applyTransformations(), ApiMoveTest::assertMoved(), PHPVersionCheck::checkExtensionExistence(), ApiBase::checkUserRightsAny(), CleanupUsersWithNoId::cleanup(), User::createNew(), CommentStore::decodeMessage(), ExternalStore::defaultStoresAreReadOnly(), MemcachedClient::disconnect_all(), RecompressTracked::dispatchToReplica(), ApiUserrightsTest::doSuccessfulRightsChange(), FileBackendTest::doTestGetFileContents(), FileBackendTest::doTestGetLocalCopy(), FileBackendTest::doTestGetLocalReference(), TextPassDumper::endElement(), Sanitizer::escapeId(), ApiParse::execute(), ApiProtect::execute(), ApiQueryUsers::execute(), ApiUserrights::execute(), JSParser::Expression(), UploadStash::fetchFileMetadata(), TextPassDumper::finalOptionCheck(), MemcachedClient::forget_dead_hosts(), FeedUtils::formatDiff(), JSParser::FunctionDefinition(), HOTP::generateByCounter(), HOTP::generateByTimeWindow(), MemcachedClient::get(), JSTokenizer::get(), MemcachedClient::get_multi(), MemcachedClient::get_sock(), LegacyLogFormatter::getActionMessage(), MediaWiki\Interwiki\ClassicInterwikiLookup::getAllPrefixesDB(), Title::getAuthorsBetween(), HTMLForm::getButtons(), OOUIHTMLForm::getButtons(), VFormHTMLForm::getButtons(), CommentStore::getCommentInternal(), SiteConfiguration::getConfig(), Wikimedia\Rdbms\LoadBalancer::getConnection(), MediaWikiTestCase::getExternalStoreDatabaseConnections(), FileContentsHasher::getFileContentsHash(), Language::getGenderNsText(), TablePager::getHiddenFields(), SpecialUpload::getInitialPageText(), HTMLAutoCompleteSelectField::getInputHTML(), ApiParamInfo::getModuleInfo(), Language::getNamespaceAliases(), PHPVersionCheck::getPHPInfo(), ApiResult::getResultData(), ConverterRule::getTextInBidtable(), JSTokenizer::init(), Wikimedia\Rdbms\Database::insertSelect(), MediaWikiTestCase::isUsingExternalStoreDB(), LogPager::limitType(), Linker::link(), MediaWiki\Interwiki\ClassicInterwikiLookup::load(), ApiAuthManagerHelper::loadAuthenticationRequests(), MediaWiki\Auth\AuthenticationRequest::loadFromSubmission(), PopulateArchiveRevId::makeDummyRevisionRow(), EditPage::matchSpamRegex(), EditPage::matchSummarySpamRegex(), MigrateComments::migrate(), MigrateActors::migrate(), ChangeTags::modifyDisplayQuery(), Wikimedia\Rdbms\Database::nonNativeInsertSelect(), InterwikiHooks::onInterwikiLoadPrefix(), Html::openElement(), ApiResult::path(), TextPassDumper::readDump(), QueryPage::reallyDoQuery(), ShortPagesPage::reallyDoQuery(), ApiFormatXml::recXmlPrint(), ResourceLoader::register(), ApiResult::removeValue(), Wikimedia\Rdbms\Database::replace(), ApiQueryBacklinks::run(), MemcachedClient::run_command(), TableCleanup::runTable(), SiteStats::salvageInsaneRow(), DatabaseTestHelper::setExistingTables(), ApiResult::setPreserveKeysList(), ApiResult::setSubelementsList(), Sanitizer::setupAttributeWhitelist(), SpecialInterwiki::showList(), LogEventsList::showLogExtract(), LogEventsList::showOptions(), OutputPage::showPermissionsErrorPage(), JSParser::Statement(), ApiResult::stripMetadata(), ApiResult::stripMetadataNonRecursive(), UpdateLogging::sync(), Wikimedia\Rdbms\Database::tableNamesWithIndexClauseOrJOIN(), PageArchiveTest::testListPagesByPrefix(), PageArchiveTest::testListPagesBySearch(), PageArchiveTest::testListRevisions(), ExportTest::testPageByTitle(), Linker::titleAttrib(), Linker::tooltipAndAccesskeyAttribs(), Wikimedia\Rdbms\Database::unionConditionPermutations(), LocalFile::unprefixRow(), ApiResult::validateValue(), and wfInstallerMain().

◆ array() [2/2]

presenting them properly to the user as errors is done by the caller return true but is called only if expensive checks are enabled Add a permissions error when permissions errors are checked for Return false if the user can t do and populate $result with the reason in the form of array	(	messagename	,
		param1	,
		param2	,
			... )

◆ follows()

the other converts the title to all uppercase letters in MediaWiki we would handle this as follows	(	note:not real	code,
		here	)

Definition at line 34 of file hooks.txt.

◆ groups()

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist you will want to construct new ChangesListBooleanFilter or ChangesListStringOptionsFilter objects When constructing you specify which group they belong to You can reuse existing groups ( accessed through $special-> getFilterGroup )

Referenced by ActiveUsersPager::__construct(), Wikimedia\Rdbms\ConnectionManager::__construct(), GenerateCollationData::generateFirstChars(), Wikimedia\Rdbms\ConnectionManager::getConnection(), Wikimedia\Rdbms\ConnectionManager::getConnectionRef(), ActiveUsersPager::getQueryInfo(), Wikimedia\Rdbms\ConnectionManager::getReadConnection(), and Wikimedia\Rdbms\ConnectionManager::getReadConnectionRef().

◆ if()

if ( $wgReverseTitle )

Definition at line 58 of file hooks.txt.

◆ ldapLogin()

function ldapLogin	(		$username,
			$password )

Definition at line 192 of file hooks.txt.

◆ options()

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing options ( say )

Referenced by CleanupEmptyCategories::__construct(), PopulateCategory::__construct(), MediaWiki\Logger\Monolog\KafkaHandler::__construct(), ResourceLoaderClientHtml::__construct(), FormOptions::add(), MediaWiki\Logger\Monolog\KafkaHandler::addMessages(), XmlSelect::addOption(), ApiQueryBase::addOption(), XmlSelect::addOptions(), BatchRowIterator::addOptions(), ApiQueryBase::addWhereRange(), CompareParsers::checkOptions(), FormOptions::consumeValue(), FormOptions::consumeValues(), FormOptions::delete(), SpecialBlockList::execute(), FormOptions::fetchValuesFromRequest(), FormOptions::getAllValues(), SpecialBlockList::getBlockListPager(), FormOptions::getChangedValues(), ResourceLoaderClientHtml::getHeadHtml(), XmlSelect::getHTML(), ParserOptions::getOption(), FormOptions::getUnconsumedValues(), FormOptions::getValue(), ParserOptions::initialiseFromUser(), ParserOptions::isSafeToCache(), ParserOptions::matches(), BatchRowIterator::next(), FormOptions::offsetExists(), CompareParsers::processRevision(), MediaWiki\Sparql\SparqlClient::query(), FormOptions::reset(), ApiQueryBase::resetQueryParams(), ApiQueryBase::select(), MediaWiki\Sparql\SparqlClient::setClientOptions(), ParserOptions::setOption(), ParserOptions::setOptionLegacy(), ExtraParserTest::setUp(), FormOptions::setValue(), HTMLAutoCompleteSelectFieldTest::testGetAttributes(), ExtraParserTest::testGetPreloadText(), ExtraParserTest::testParse(), ExtraParserTest::testPreprocess(), ExtraParserTest::testPreSaveTransform(), XmlSelectTest::testSetDefaultAfterAddingOptions(), ExtraParserTest::testTrackingCategory(), ExtraParserTest::testTrackingCategorySpecial(), FormOptions::validateBounds(), FormOptions::validateName(), UserOptionsMaintenance::warn(), and MediaWiki\Logger\Monolog\KafkaHandler::warning().

◆ own()

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist you will want to construct new ChangesListBooleanFilter or ChangesListStringOptionsFilter objects When constructing you specify which group they belong to You can reuse existing or create your own ( ChangesListBooleanFilterGroup or ChangesListStringOptionsFilterGroup )

new

◆ query()

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the query ( )

◆ system()

processing should stop and the error should be shown to the user if you wanted to authenticate users to a custom system	(	LDAP	,
		another PHP	program,
		whatever	)

◆ values()

Returning false makes less sense for events where the action is and will normally be ignored Note that none of the examples made use of create_function() as a way to attach a function to a hook. This is known to cause problems(notably with Special this is a necessary inconvenience to make it possible to pass reference values ( that can be changed )

◆ wfMessage()

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a set this to the key of the message First element is the message additional optional elements are parameters for the key that are processed with wfMessage ( ) -> params() ->parseAsBlock() - offset Set to overwrite offset parameter in $wgRequest set to '' to unset offset - wrap String Wrap the message in html(usually something like "<div ...>$1</div>"). - flags Integer display flags(NO_ACTION_LINK, NO_EXTRA_USER_LINKS) 'LogException':Called before an exception(or PHP error) is logged. This is meant for integration with external error aggregation services

Variable Documentation

◆ $abortMsg

please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account incomplete& $abortMsg

Definition at line 248 of file hooks.txt.

◆ $article

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used the name of the old file & $article

Initial value:

{
 
            Hooks::run( 'ArticleShowComplete', array( &$article ) )

Definition at line 77 of file hooks.txt.

Referenced by EditPage::__construct(), ProtectionForm::__construct(), CategoryViewer::columnList(), ParserCache::get(), ParserCache::getDirty(), MediaWiki::initializeArticle(), Article::newFromWikiPage(), and CategoryFinder::run().

◆ $attribs

either a unescaped string or a HtmlArmor object & $attribs

Definition at line 2014 of file hooks.txt.

◆ $auto

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used the name of the old file when set the default code will be skipped true if there is text before this autocomment $auto

Definition at line 1586 of file hooks.txt.

Referenced by PatrolLog::buildParams(), RecentChange::doMarkPatrolled(), Linker::formatAutocomments(), DeleteAutoPatrolLogs::getRowsOld(), RecentChange::markPatrolled(), and PatrolLog::record().

◆ $changesList

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges $changesList

Definition at line 1518 of file hooks.txt.

Referenced by ChangesList::getArticleLink(), OldChangesListTest::testRecentChangesLine_prefix(), and EnhancedChangesListTest::testRecentChangesPrefix().

◆ $code

static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place or wrap services the preferred way to define a new service is the $wgServiceWiringFiles array change it to the message you want to define $code

Definition at line 865 of file hooks.txt.

◆ $colours

the value of this variable comes from LanguageConverter indexed by page_id& $colours

Definition at line 1686 of file hooks.txt.

Referenced by LinkHolderArray::doVariants(), and LinkHolderArray::replaceInternal().

◆ $context

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow (e.g. with the RejectParserCacheValue hook) because MediaWiki won't do it for you. &$defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on and they can depend only on the ResourceLoaderContext $context

Definition at line 2808 of file hooks.txt.

◆ $customAttribs

null means default & $customAttribs

Definition at line 1995 of file hooks.txt.

Referenced by EditPage::buildTextboxAttribs(), MediaWiki\EditPage\TextboxBuilder::buildTextboxAttribs(), MediaWiki\EditPage\TextConflictHelper::getEditConflictMainTextBox(), DummyLinker::link(), Linker::link(), DummyLinker::linkKnown(), Linker::linkKnown(), EditPage::showTextbox(), and EditPage::showTextbox1().

◆ $differenceEngine

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache allow viewing deleted revs& $differenceEngine

Definition at line 1634 of file hooks.txt.

Referenced by ContentHandler::createDifferenceEngine().

◆ $e

returning false will NOT prevent logging $e

Definition at line 2176 of file hooks.txt.

◆ $editor

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections & $editor

Definition at line 1402 of file hooks.txt.

Referenced by TestFileEditor::edit(), ConfirmEditHooks::onAlternateEditPreview(), EnotifNotifyJob::run(), RecentChange::save(), EditAction::show(), WatchedItemStore::updateNotificationTimestamp(), and TitleBlacklistHooks::validateBlacklist().

◆ $engine

the value to return A Title object or null for latest all implement SearchIndexField $engine

Definition at line 2869 of file hooks.txt.

Referenced by ContentHandler::addSearchField(), ApiQueryRevisionsBase::extractRevisionInfo(), ContentHandler::getDataForSearchIndex(), TextContentHandler::getDataForSearchIndex(), WikitextContentHandler::getDataForSearchIndex(), DifferenceEngine::getDiffBodyCacheKeyParams(), ContentHandler::getFieldsForSearchIndex(), FileContentHandler::getFieldsForSearchIndex(), TextContentHandler::getFieldsForSearchIndex(), WikitextContentHandler::getFieldsForSearchIndex(), DummySearchIndexFieldDefinition::getMapping(), PageArchive::listPagesBySearch(), ParserFunctionsHooks::onScribuntoExternalLibraries(), ApiOpenSearchTest::replaceSearchEngine(), TitleBlacklistHooks::scribuntoExternalLibraries(), ContentHandlerTest::testDataIndexFields(), ApiOpenSearchTest::testGetAllowedParams(), SearchEngineTest::testSearchIndexFields(), and DifferenceEngine::textDiff().

◆ $extTypes

presenting them properly to the user as errors is done by the caller return true use this to change the list & $extTypes

Definition at line 1546 of file hooks.txt.

◆ $handler

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves $handler

Definition at line 900 of file hooks.txt.

◆ $handlerParams

see documentation in includes Linker php for Linker::makeImageLink& $handlerParams

Definition at line 1793 of file hooks.txt.

Referenced by File::getUnscaledThumb(), DummyLinker::makeImageLink(), Linker::makeImageLink(), DummyLinker::makeThumbLink2(), and Linker::makeThumbLink2().

◆ $html

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an<a> element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses& $html

Definition at line 2013 of file hooks.txt.

◆ $image

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check $image

Definition at line 893 of file hooks.txt.

◆ $ldapServer

processing should stop and the error should be shown to the user if you wanted to authenticate users to a custom you could $ldapServer

Definition at line 190 of file hooks.txt.

◆ $link

usually copyright or history_copyright This message must be in HTML not wikitext& $link

Definition at line 3014 of file hooks.txt.

Referenced by LinksUpdate::__construct(), ImageGalleryBase::add(), OutputPage::addHelpLink(), OutputPage::addReturnTo(), Skin::addToSidebarPlain(), RCCacheEntryFactoryTest::assertQueryLink(), SkinTemplate::buildContentNavigationUrls(), OutputPage::buildCssLinksArray(), ProtectionForm::buildForm(), SpecialEditWatchlist::buildRemoveLine(), Article::confirmDelete(), DifferenceEngine::deletedIdMarker(), SpecialReplaceText::doSpecialReplaceText(), MovePageForm::doSubmit(), SpecialRenameuser::execute(), SpecialApiHelp::execute(), DumpLinks::execute(), VectorTemplate::execute(), SpecialNewpages::filterLinks(), StubUserLang::findVariantLink(), IuConverter::findVariantLink(), KkConverter::findVariantLink(), KuConverter::findVariantLink(), ShiConverter::findVariantLink(), SrConverter::findVariantLink(), Language::findVariantLink(), LanguageConverter::findVariantLink(), Linker::formatAutocomments(), ApiParse::formatCategoryLinks(), DateFormatter::formatDate(), ApiParse::formatLangLinks(), AncientPagesPage::formatResult(), MostcategoriesPage::formatResult(), MostinterwikisPage::formatResult(), MostlinkedPage::formatResult(), DeletedContribsPager::formatRevisionRow(), CategoryPager::formatRow(), ContribsPager::formatRow(), SpecialProtectedtitles::formatRow(), ImageListPager::formatValue(), CategoryViewer::generateLink(), MediaWiki\Widget\Search\FullSearchResultWidget::generateMainLinkHtml(), Skin::getCategoryLinks(), CreditsAction::getContributors(), Skin::getCopyright(), SpecialUndelete::getFileComment(), SpecialUndelete::getFileLink(), SpecialUndelete::getFileUser(), LogEventsList::getFilterLinks(), BaseTemplate::getFooterLinks(), ResourceLoaderModule::getHeaders(), OutputPage::getHeadLinksArray(), ApiHelp::getHelpInternal(), EnhancedChangesList::getLineData(), RevDelArchivedFileItem::getLink(), RevDelFileItem::getLink(), RenameuserLogFormatter::getMessageParameters(), ApiParamInfo::getModuleInfo(), SpecialUndelete::getPageLink(), WebInstaller::getPageListItem(), Block::getPermissionsError(), TablePager::getStartBody(), RevDelFileItem::getUserTools(), HistoryPager::historyLine(), ImagePage::imageDupes(), ImagePage::imageLinks(), ImageGalleryBase::insert(), SpecialWhatLinksHere::listItem(), Linker::makeCommentLink(), Linker::makeExternalLink(), Linker::makeHeadline(), DummyLinker::makeHeadline(), Parser::makeKnownLinkHolder(), BaseTemplate::makeListItem(), LogFormatter::makePageLink(), WebInstallerOptions::makeScreenshotsLink(), ChangesList::maybeWatchedLink(), RenameuserLogFormatter::myPageLink(), ImportStreamSource::newFromInterwiki(), ComposerPackageModifier::newMediaWikiLink(), Language::numLink(), ImagePage::openShowImage(), SpecialRecentChanges::optionsPanel(), SpecialSpecialpages::outputPageList(), LanguageConverter::parseCachedTable(), SkinTemplate::prepareQuickTemplate(), SpecialBlock::preText(), MediaWiki\Preferences\DefaultPreferencesFactory::profilePreferences(), ImageMap::render(), MediaWiki\Widget\Search\FullSearchResultWidget::render(), MediaWiki\Widget\Search\InterwikiSearchResultWidget::render(), MediaWiki\Widget\Search\SimpleSearchResultWidget::render(), Parser::renderImageGallery(), LinkHolderArray::replaceInternal(), Parser::replaceInternalLinks2(), LinkHolderArray::replaceInterwiki(), Linker::revDeleteLink(), DifferenceEngine::revisionDeleteLink(), HistoryPager::revLink(), Linker::revUserLink(), Linker::revUserTools(), ComposerPackageModifier::setLinkAsProvides(), Article::showDeletedRevisionHeader(), DifferenceEngine::showDiffPage(), FileDeleteForm::showForm(), SpecialRevisionDelete::showForm(), SpecialAutoblockList::showList(), SpecialBlockList::showList(), Article::showPatrolFooter(), SpecialPrefixindex::showPrefixChunk(), SpecialUndelete::showRevision(), MovePageForm::showSubpagesList(), SpecialUpload::showViewDeletedLinks(), OutputPage::styleLink(), Skin::subPageSubtitle(), ApiMain::substituteResultWithError(), MediaWiki\Auth\AuthManagerTest::testAuthentication(), LinkRendererTest::testMergeAttribs(), TraditionalImageGallery::toHTML(), SpecialUndelete::undelete(), and CreditsAction::userLink().

◆ $linkRenderer

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned $linkRenderer

Definition at line 2054 of file hooks.txt.

Referenced by UploadForm::__construct(), OutputPage::addCategoryLinks(), OutputPage::addReturnTo(), OutputPage::buildBacklinkSubtitle(), ProtectionForm::buildForm(), SpecialPageFactory::capturePath(), MediaWiki\Linker\LinkRendererFactory::createForUser(), MediaWiki\Linker\LinkRendererFactory::createFromLegacyOptions(), LinkHolderArray::doVariants(), SpecialPageFactory::executePath(), DeletedContribsPager::formatRevisionRow(), ContribsPager::formatRow(), AllMessagesTablePager::formatValue(), ImageListPager::formatValue(), BlockListPager::formatValue(), CategoryViewer::generateLink(), PreferencesForm::getButtons(), InfoAction::getContributors(), Preferences::getDefaultPreferencesFactory(), RevisionItem::getDiffLink(), MWGrants::getGrantsLink(), Linker::getLinkColour(), SpecialPage::getLinkRenderer(), RevisionItem::getRevisionLink(), SpecialContributions::getUserLinks(), HistoryPager::lastLink(), Linker::link(), ReplaceTextUtils::link(), InfoAction::pageInfo(), CategoryViewer::pagingLinks(), SpecialBlock::postText(), MarkpatrolledAction::preText(), LinkHolderArray::replaceInternal(), LinkHolderArray::replaceInterwiki(), ImportReporter::reportPage(), MediaWiki\Widget\Search\DidYouMeanWidget::rewrittenHtml(), SpecialPage::setLinkRenderer(), FileDeleteForm::showForm(), OutputPage::showPermissionsErrorPage(), SpecialSearch::showResults(), LinkRendererFactoryTest::testCreateForUser(), LinkRendererFactoryTest::testCreateFromLegacyOptions(), LinkRendererTest::testGetLinkClasses(), LinkRendererTest::testMakeBrokenLink(), LinkRendererTest::testMakeKnownLink(), LinkRendererTest::testMakeLink(), and LinkRendererTest::testMergeAttribs().

◆ $linksUpdate

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables & $linksUpdate

Definition at line 2086 of file hooks.txt.

Referenced by LinksUpdate::__construct(), LinksUpdate::doUpdate(), CiteHooks::onLinksUpdate(), and CiteHooks::onLinksUpdateComplete().

◆ $localize

namespace are movable Hooks may change this value to override the return value of MWNamespace::isMovable (). 'NewDifferenceEngine' if it s text intended for display in a monospaced font $localize

Definition at line 2594 of file hooks.txt.

◆ $mimeMagic

configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place or wrap services the preferred way to define a new service is the $wgServiceWiringFiles array change it to the message you want to define you are encouraged to submit patches to MediaWiki s core to add new MIME types to mime types $mimeMagic

static

Definition at line 2294 of file hooks.txt.

Referenced by File::checkExtensionCompatibility().

◆ $name

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter $name

inline

Definition at line 293 of file hooks.txt.

◆ $namespaces

namespace and then decline to actually register it& $namespaces

Definition at line 935 of file hooks.txt.

Referenced by ApiQuerySiteinfo::appendNamespaceAliases(), ChangesListSpecialPage::buildQuery(), CategoryTree::decodeNamespaces(), PrefixSearch::defaultSearchBackend(), FixDefaultJsonContentPages::doDBUpdates(), ReplaceTextSearch::doSearchQuery(), SpecialAllPages::execute(), SpecialPrefixindex::execute(), CategoryTreePage::executeInputForm(), MediaWikiTestCase::getDefaultWikitextNS(), ApiHelp::getHelpInternal(), SpecialReplaceText::getMatchingTitles(), SpecialSearch::getNamespaces(), Languages::getProblematicProjectTalks(), InputBox::getSearchForm(), PrefixSearch::handleResultFromHook(), Title::inNamespaces(), SearchEngine::namespacesAsText(), SearchEngineConfig::namespacesAsText(), SpecialReplaceText::namespaceTables(), SearchEngine::normalizeNamespaces(), ShortPagesPage::reallyDoQuery(), CategoryTree::renderChildren(), SearchExactMatchRescorer::rescore(), ApiQueryDuplicateFiles::run(), ApiQueryAllDeletedRevisions::run(), PrefixSearch::search(), PrefixSearch::searchBackend(), PrefixSearchTest::searchProvision(), SearchEnginePrefixTest::searchProvision(), PrefixSearch::searchWithVariants(), SearchEngine::setNamespaces(), Language::setNamespaces(), BackupReader::setNsfilter(), SpecialAllPages::showChunk(), SpecialReplaceText::showForm(), SpecialPrefixindex::showPrefixChunk(), SearchEngineTest::testCompletionSearchMustRespectCapitalLinkOverrides(), PrefixSearchTest::testSearch(), PrefixSearchTest::testSearchWithOffset(), ImportTest::testSiteInfoContainsNamespaces(), PrefixSearch::titleSearch(), and PrefixSearch::validateNamespaces().

◆ $newminor

also included in $newHeader if any $newminor

Definition at line 1257 of file hooks.txt.

Referenced by DifferenceEngine::showDiffPage().

◆ $newtalks

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect $newtalks

Definition at line 1721 of file hooks.txt.

Referenced by Skin::getNewtalks().

◆ $oldminor

passed in as a query string parameter to the various URLs constructed here (i.e. $nextlink) $rdel also included in $oldHeader $oldminor

Definition at line 1272 of file hooks.txt.

Referenced by DifferenceEngine::showDiffPage().

◆ $options

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped& $options

Definition at line 2001 of file hooks.txt.

◆ $out

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output $out

Definition at line 863 of file hooks.txt.

◆ $output

configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place $output

static

Definition at line 2247 of file hooks.txt.

Referenced by Maintenance::activateProfiler(), LanguageConverter::autoConvert(), ProtectionForm::buildForm(), WikiExporter::closeStream(), StringUtils::delimiterReplaceCallback(), UploadBase::detectVirus(), Parser::doQuotes(), LinkHolderArray::doVariants(), CodeEditorHooks::editPageShowEditFormInitial(), CategoryTreePage::execute(), SpecialRenameuser::execute(), SpecialContributions::execute(), SpecialEditTags::execute(), SpecialRevisionDelete::execute(), SpecialExpandTemplates::execute(), SpecialWatchlist::execute(), BlockLevelPass::execute(), DumpCategoriesAsRdf::execute(), SpecialPageExecutor::executeSpecialPage(), Parser::extensionSubstitution(), GadgetDefinitionContent::fillParserOutput(), JsonContent::fillParserOutput(), TextContent::fillParserOutput(), WikitextContent::fillParserOutput(), DummyContentForTesting::fillParserOutput(), DummyNonTextContent::fillParserOutput(), ExecutableFinder::findExecutable(), MediaWiki\Logger\Monolog\LineFormatter::format(), AutoloadGenerator::generatePHPAutoload(), CategoryMembershipChangeJob::getCategoriesAtRev(), ContentHandler::getDataForSearchIndex(), TextContentHandler::getDataForSearchIndex(), ReCaptchaNoCaptcha::getFormInformation(), SpecialPageExecutor::getHTMLFromSpecialPage(), HTMLReCaptchaNoCaptchaField::getInputHTML(), ChangesListBooleanFilter::getJsData(), ChangesListFilter::getJsData(), ChangesListFilterGroup::getJsData(), ChangesListStringOptionsFilterGroup::getJsData(), WebInstallerLanguage::getLanguageSelector(), EditPage::getPreviewLimitReport(), ChangesListSpecialPage::getStructuredFilterJsData(), PageDataRequestHandler::handleRequest(), DumpRenderer::handleRevision(), SyntaxHighlight::highlight(), CryptHKDF::HKDFExpand(), PageDataRequestHandler::httpContentNegotiation(), StringUtils::hungryDelimiterReplace(), Profiler::logData(), Profiler::logDataPageOutputOnly(), MediaWiki::main(), SpecialExpandTemplates::makeOutput(), PageDataRequestHandlerTest::makeOutputPage(), MediaWiki::maybeDoHttpsRedirect(), Maintenance::maybeHelp(), mccGetHelp(), onApiFormatHighlight(), onContentGetParserOutput(), InputBoxHooks::onMediaWikiPerformAction(), SpamBlacklistHooks::onParserOutputStashForEdit(), SpamBlacklistHooks::onUploadVerifyUpload(), ImagePage::openShowImage(), WikiExporter::openStream(), SpecialWatchlist::outputChangesList(), WikiExporter::outputLogStream(), WikiExporter::outputPageStream(), InfoAction::pageInfo(), MediaWiki::performAction(), MediaWiki::performRequest(), Wikimedia\Rdbms\DatabasePostgres::pg_array_parse(), MediaWiki::preOutputCommit(), ParserTestPrinter::quickDiff(), SectionProfiler::remapCallTree(), ImageMap::render(), LinkHolderArray::replaceInternal(), LinkHolderArray::replaceInterwiki(), Parser::replaceTransparentTags(), UserNotLoggedIn::report(), ParserTestRunner::runTest(), SpecialAllPages::showChunk(), SpecialGadgets::showExportForm(), UserrightsPage::showLogFragment(), SpecialGadgets::showMainForm(), SpecialPrefixindex::showPrefixChunk(), SpecialEditWatchlist::showTitles(), JpegHandler::swapICCProfile(), BalancerTest::testBalancer(), WfShellExecTest::testBug67870(), FirejailCommandTest::testBuildFinalCommand(), DatabaseMysqlBaseTest::testBuildIntegerCast(), DatabaseSQLTest::testBuildIntegerCast(), DatabaseOracleTest::testBuildSubstring(), DatabaseMssqlTest::testBuildSubstring(), DatabaseSqliteRdbmsTest::testBuildSubstring(), DatabaseSQLTest::testBuildSubstring(), ListToggleTest::testConstruct(), ContentHandlerTest::testDataIndexFields(), SpecialPageDataTest::testExecute(), ArrayDiffFormatterTest::testFormat(), FormatMetadataTest::testGetFormattedData(), ListToggleTest::testGetHTML(), CSSMinTest::testGetLocalFileReferences(), BaseBlacklistTest::testGetTypeFromTitle(), PageDataRequestHandlerTest::testHandleRequest(), PageDataRequestHandlerTest::testHttpContentNegotiation(), WfTimestampTest::testHttpDate(), ApiParseTest::testModules(), MediaWiki\Tests\Storage\SlotRecordTest::testNewWithSuppressedContent(), WfTimestampTest::testNormalTimestamps(), WfTimestampTest::testOldTimestamps(), JpegPixelFormatTest::testPixelFormatRendering(), PreprocessorTest::testPreprocessorOutputFiles(), LocalisationUpdate\UpdaterTest::testReadMessages(), FormatMetadataTest::testResolveMultivalueValue(), CSSMinTest::testSerializeStringValue(), SpecialPageDataTest::testSpecialPageWithoutParameters(), CommandTest::testT69870(), ApiResultTest::testTransformations(), AbstractChangesListSpecialPageTestCase::testValidateOptions(), WfAssembleUrlTest::testWfAssembleUrl(), WfShorthandToIntegerTest::testWfShorthandToInteger(), TraditionalImageGallery::toHTML(), MediaWiki::tryNormaliseRedirect(), wfArrayInsertAfter(), wfRemoveDotSegments(), and GenerateJqueryMsgData::writeJavascriptFile().

◆ $parser

function wfGetCustomMagicWordValue $parser

Initial value:

{

$parser->setFunctionHook( 'mag_custom', 'wfGetCustomMagicWordValue' )

$parser

do that in ParserLimitReportFormat instead $parser

Definition hooks.txt:2603

Definition at line 2600 of file hooks.txt.

◆ $pre

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used the name of the old file when set the default code will be skipped $pre

Definition at line 1585 of file hooks.txt.

Referenced by Linker::formatAutocomments(), DbTestPreviewer::getTestStatusInfo(), SearchHighlighter::highlightSimple(), DeferredUpdatesTest::testGetPendingUpdates(), and ExtensionProcessorTest::testRegisterHooks().

◆ $query

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute & $query

Definition at line 1617 of file hooks.txt.

◆ $refreshCache

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next $refreshCache

Definition at line 1632 of file hooks.txt.

Referenced by DifferenceEngine::__construct(), and ContentHandler::createDifferenceEngine().

◆ $req

this hook is for auditing only $req

Definition at line 965 of file hooks.txt.

◆ $request

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow (e.g. with the RejectParserCacheValue hook) because MediaWiki won't do it for you. &$defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on $request

Definition at line 2785 of file hooks.txt.

◆ $requests

Allows to change the fields on the form that will be generated are created Can be used to omit specific feeds from being outputted You must not use this hook to add use OutputPage::addFeedLink () instead. &$feedLinks hooks can tweak the array to change how login etc forms should look $requests ( ) &

Definition at line 773 of file hooks.txt.

Referenced by AuthManagerSpecialPage::fieldInfoToFormDescriptor(), SpecialChangeCredentials::getAuthForm(), SpecialLinkAccounts::getAuthForm(), LoginSignupSpecialPage::getAuthForm(), AuthManagerSpecialPage::getAuthFormDescriptor(), SpecialChangeCredentials::getAuthFormDescriptor(), MediaWiki\Auth\AuthenticationRequest::getRequestByClass(), MediaWiki\Auth\ButtonAuthenticationRequest::getRequestByName(), AuthManagerSpecialPage::handleFormSubmit(), SpecialChangeCredentials::handleFormSubmit(), AuthManagerSpecialPage::isActionAllowed(), LoginSignupSpecialPage::mainLoginForm(), AuthManagerSpecialPage::needsSubmitButton(), FancyCaptcha::onAuthChangeFormFields(), ConfirmEditHooks::onAuthChangeFormFields(), MathCaptcha::onAuthChangeFormFields(), QuestyCaptcha::onAuthChangeFormFields(), ReCaptcha::onAuthChangeFormFields(), ReCaptchaNoCaptcha::onAuthChangeFormFields(), SimpleCaptcha::onAuthChangeFormFields(), SpecialChangeCredentials::onAuthChangeFormFields(), AuthManagerSpecialPage::performAuthenticationStep(), LoginSignupSpecialPage::postProcessFormDescriptor(), and MediaWiki\Session\SessionBackendTest::testSave().

◆ $res

see documentation in includes Linker php for Linker::makeImageLink or false for current& $res

Definition at line 953 of file hooks.txt.

◆ $resourceLoader

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow (e.g. with the RejectParserCacheValue hook) because MediaWiki won't do it for you. &$defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on and they can depend only on the ResourceLoaderContext such as when responding to a resource loader request or generating HTML output& $resourceLoader

Definition at line 2814 of file hooks.txt.

Referenced by LessTestSuite::__construct(), ResourceLoaderContext::__construct(), OutputPage::filterModules(), WebInstallerOutput::getCSS(), ResourceLoaderStartUpModule::getModuleRegistrations(), ResourceLoaderContext::getResourceLoader(), ResourceLoaderTestCase::getResourceLoaderContext(), ResourceLoaderModule::getScriptURLsForDebug(), ResourceLoaderModule::getStyleURLsForDebug(), CiteHooks::onResourceLoaderRegisterModules(), onResourceLoaderRegisterModules(), CiteHooks::onResourceLoaderTestModules(), GadgetHooks::registerModules(), PdfHandler::registerWarningModule(), ResourceLoaderTest::testConstructRegistrationHook(), ResourceLoaderTest::testGetModuleNames(), ResourceLoaderTest::testRegisterEmptyString(), ResourceLoaderTest::testRegisterInvalidName(), ResourceLoaderTest::testRegisterInvalidType(), ResourceLoaderTest::testRegisterValidArray(), and ResourceLoaderTest::testRegisterValidObject().

◆ $ResourceLoader

For QUnit the mediawiki tests qunit testrunner dependency will be added to any module& $ResourceLoader

Definition at line 2827 of file hooks.txt.

◆ $response

this hook is for auditing only $response

Definition at line 782 of file hooks.txt.

◆ $result

namespace being checked& $result

Definition at line 2324 of file hooks.txt.

Referenced by MemcachedClient::_fgets(), MemcachedClient::_fread(), MemcachedClient::_fwrite(), ChangeTags::activateTagWithChecks(), RedisBagOStuff::add(), SearchEngineTest::addAugmentors(), ChangeTags::addTagsAccompanyingChangeWithChecks(), ParserEditTests::alternatingAligned(), FileOp::attemptAsync(), MediaWiki\Tidy\Balancer::balance(), Parser::callParserFunction(), RedisBagOStuff::changeTTL(), Autopromote::checkCondition(), XMPReader::checkParseSafety(), SqliteInstaller::checkPrerequisites(), MemcachedPeclBagOStuff::checkResult(), BlockLevelPass::closeParagraph(), AbstractContent::convert(), ChangeTags::createTagWithChecks(), ChangeTags::deactivateTagWithChecks(), RedisBagOStuff::delete(), ChangeTags::deleteTagWithChecks(), Skin::doEditSectionLink(), RedisBagOStuff::doGet(), JobQueueFederated::doGetSiblingQueueSizes(), ExprParser::doOperation(), ParserEditTests::dwdiff(), PoolCounterWork::execute(), RecountCategories::execute(), PasswordReset::execute(), MediaWiki\Sparql\SparqlClient::extractData(), SearchResultSet::extractResults(), FileRepo::fileExistsBatch(), ResourceLoader::filter(), LocalRepo::findBySha1(), RepoGroup::findBySha1(), FileRepo::findBySha1s(), LocalRepo::findBySha1s(), RepoGroup::findBySha1s(), FileRepo::findFiles(), TitleTest::flattenErrorsArray(), MediaWiki\Logger\Monolog\AvroFormatter::formatBatch(), ApiParse::formatCategoryLinks(), ApiParse::formatHeadItems(), ApiParse::formatIWLinks(), ApiParse::formatLangLinks(), ApiParse::formatLimitReportData(), ApiParse::formatLinks(), SvgHandler::formatMetadata(), MediaHandler::formatMetadataHelper(), DoubleRedirectsPage::formatResult(), MediaHandlerTest::generateTestFitBoxWidthData(), DifferenceEngine::generateTextDiffBody(), LinksUpdate::getAddedLinks(), UsersPager::getAllGroups(), ApiImport::getAllowedImportSources(), ApiImageRotate::getAllowedParams(), ApiPageSet::getAllowedParams(), ApiPurge::getAllowedParams(), ApiQuery::getAllowedParams(), ApiSetNotificationTimestamp::getAllowedParams(), ApiWatch::getAllowedParams(), ResourceLoaderFileModule::getAllStyleFiles(), ApiQueryInfo::getAllVariants(), ChangesListSpecialPage::getChangeTagList(), ApiUpload::getChunkResult(), AvroValidator::getErrors(), StatusValue::getErrorsByType(), ForeignTitle::getFullText(), PageProps::getGoodIDs(), WikiPage::getHiddenCategories(), TitleBlacklist::getHttp(), ApiPageSet::getInvalidTitlesAndRevisions(), ApiQueryGadgets::getList(), Category::getMembers(), UsageException::getMessageArray(), GenerateJqueryMsgData::getMessagesAndTests(), RedisBagOStuff::getMulti(), WANObjectCache::getMulti(), ApiModuleManager::getNames(), ApiModuleManager::getNamesWithClasses(), BackupReader::getNsIndex(), RightsLogFormatter::getParametersForApi(), SyntaxHighlightAce::getPygmentsToAceMap(), LinksUpdate::getRemovedLinks(), DnsSrvDiscoverer::getServers(), ApiUpload::getStashResult(), Status::getStatusArray(), SpecialEditTags::getTagSelect(), ApiUpload::getWarningsResult(), MemcachedPeclBagOStuff::getWithToken(), User::idFromName(), ExtParserFunctions::ifexprObj(), RedisBagOStuff::incr(), MemoizedCallable::invokeArgs(), MWNamespace::isMovable(), Title::isMovable(), MediaWiki\Interwiki\ClassicInterwikiLookup::isValidInterwiki(), User::loadFromSession(), EditPage::mergeChangesIntoContent(), StatusValue::newFatal(), SearchResult::newFromTitle(), StatusValue::newGood(), RestbaseVirtualRESTService::onParsoidRequests(), ParsoidVirtualRESTService::onRequests(), SwiftVirtualRESTService::onRequests(), VirtualRESTService::onRequests(), RestbaseVirtualRESTService::onRequests(), SwiftVirtualRESTService::onResponses(), BlockLevelPass::openList(), InfoAction::pageCounts(), TitleBlacklist::parseBlacklist(), ApiUpload::performUpload(), User::pingLimiter(), ApiPageSet::populateGeneratorData(), SpecialPage::prefixSearchString(), CategoryTreePage::prefixSearchSubpages(), FileDuplicateSearchPage::prefixSearchSubpages(), XMPTest::provideXMPParse(), ApiQueryContinueTestBase::query(), AutoloadGenerator::readFile(), AllMessagesTablePager::reallyDoQuery(), SqliteInstaller::realpath(), Cite::recursiveFetchRefsFromDB(), SearchExactMatchRescorer::redirectTargetsToRedirect(), MediaWiki\Widget\Search\InterwikiSearchResultSetWidget::render(), MediaWiki\Widget\Search\SimpleSearchResultSetWidget::render(), Wikimedia\Rdbms\Database::resultObject(), Wikimedia\Rdbms\DatabaseMssql::resultObject(), Title::resultToError(), ExtParserFunctions::runCount(), ExtParserFunctions::runExplode(), TitlePermissionTest::runGroupPermissions(), ExtParserFunctions::runReplace(), ExtParserFunctions::runSub(), ParserEditTests::runTests(), MediaWiki\Preferences\DefaultPreferencesFactory::saveFormData(), WinCacheBagOStuff::set(), RedisBagOStuff::set(), User::setEmailWithConfirmation(), RedisBagOStuff::setMulti(), SqlBagOStuff::setMulti(), HTMLForm::show(), HTMLForm::showAlways(), StoreBatchTest::storeit(), ArrayBackedMemoizedCallable::storeResult(), FileRepo::storeTemp(), SqliteInstaller::submitConnectForm(), SkinTemplate::tabAction(), SearchEngineTest::testAugmentorSearch(), ExtParserFunctions::timeCommon(), Password::toString(), FileBackendDBRepoWrapper::translateArrayResults(), SimpleCaptcha::triggersCaptcha(), HTMLForm::tryAuthorizedSubmit(), WikiPage::updateRevisionOn(), ChangeTags::updateTagsWithChecks(), UploadSourceAdapter::url_stat(), HTMLUsersMultiselectField::validate(), Sanitizer::validateEmail(), ApiTag::validateLogId(), UploadBase::validateName(), ResourceLoaderModule::validateScriptFile(), UploadBase::verifyUpload(), wfAssembleUrl(), wfClientAcceptsGzip(), wfGenerateThumbnail(), wfUnpack(), and Status::wrap().

◆ $ret

either a unescaped string or a HtmlArmor object after in associative array form & $ret

Definition at line 2002 of file hooks.txt.

◆ $retval

please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account incomplete not yet checked for validity& $retval

Definition at line 266 of file hooks.txt.

Referenced by ExternalStore::batchFetchFromURLs(), ExternalStoreMedium::batchFetchFromURLs(), MediaWiki\Tidy\RaggettExternal::cleanWrapped(), MediaWiki\Tidy\RaggettInternalHHVM::cleanWrapped(), MediaWiki\Tidy\RaggettInternalPHP::cleanWrapped(), HTMLForm::displaySection(), PdfHandler::doTransform(), DjVuHandler::doTransform(), ApiBlock::execute(), ApiEmailUser::execute(), ApiExpandTemplates::execute(), ApiPatrol::execute(), ApiRollback::execute(), ApiUnblock::execute(), ApiUndelete::execute(), MediaWiki\Shell\Command::execute(), NamespaceConflictChecker::execute(), ResourceLoaderContext::expandModuleNames(), Wikimedia\Rdbms\Database::fieldNamesWithAlias(), ArrayDiffFormatter::format(), ApiQueryBacklinks::getAllowedParams(), MediaWiki\Interwiki\ClassicInterwikiLookup::getAllPrefixesDB(), FindHooks::getHooksFromOnlineDocCategory(), TransformationalImageHandler::getMagickVersion(), LinkSearchPage::getQueryInfo(), UnusedimagesPage::getQueryInfo(), ApiQueryUserInfo::getRateLimits(), SiteConfiguration::getSetting(), WikiPage::insertRedirect(), MediaHandler::logErrorForExternalProcess(), ApiMove::moveSubpages(), Title::moveSubpages(), RecentChange::parseToRCType(), ApiQueryImageInfo::processMetaData(), WfExpandUrlTest::provideExpandableUrls(), SvgHandler::rasterize(), Maintenance::readlineEmulation(), DoubleRedirectsPage::reallyGetQueryInfo(), ApiFormatXml::recXmlPrint(), MediaHandler::removeBadFile(), PdfImage::retrieveMetaData(), DjVuImage::retrieveMetaData(), BitmapHandler::rotate(), JpegHandler::rotate(), Hooks::run(), Hooks::runWithoutAbort(), SpecialInterwiki::showList(), EmailConfirmation::showRequestForm(), JpegHandler::swapICCProfile(), Wikimedia\Rdbms\Database::tableNamesWithAlias(), MediaWiki\Session\SessionTest::testMethods(), JpegPixelFormatTest::testPixelFormatRendering(), BitmapHandler::transformCustom(), BitmapHandler::transformImageMagick(), MediaWiki\Tidy\RaggettBase::validate(), OATHAuthKey::verifyToken(), wfShellExec(), wfShellExecWithStderr(), wfUrlProtocols(), RandomImageGenerator::writeImageWithApi(), and RandomImageGenerator::writeImageWithCommandLine().

◆ $rev

presenting them properly to the user as errors is done by the caller return true use this to change the list i e etc $rev

Definition at line 1775 of file hooks.txt.

◆ $revert

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters create2 Corresponds to logging log_action database field and which is displayed in the UI& $revert

Definition at line 2206 of file hooks.txt.

Referenced by WikiStatsOutput::formatPercent(), ContentModelLogFormatter::getActionLinks(), DeleteLogFormatter::getActionLinks(), MergeLogFormatter::getActionLinks(), MoveLogFormatter::getActionLinks(), and LogEventsList::logLine().

◆ $rollback

also included in $newHeader $rollback

Definition at line 1256 of file hooks.txt.

Referenced by DifferenceEngine::showDiffPage().

◆ $rowAugmentors

the value to return A Title object or null for latest all implement SearchIndexField must implement ResultSetAugmentor& $rowAugmentors

Definition at line 2882 of file hooks.txt.

Referenced by SearchEngineTest::addAugmentors(), and SearchEngine::augmentSearchResults().

◆ $rows

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow (e.g. with the RejectParserCacheValue hook) because MediaWiki won't do it for you. &$defaults also a ContextSource after deleting those rows but within the same transaction $rows

Definition at line 2758 of file hooks.txt.

◆ $section

usually copyright or history_copyright This message must be in HTML not wikitext if the section is included from a template $section

Definition at line 3022 of file hooks.txt.

Referenced by HTMLForm::__construct(), JobQueueFederated::__construct(), HTMLForm::addFooterText(), CategoryViewer::addFragmentToTitle(), HTMLForm::addHeaderText(), ParserOutput::addHeadItem(), ApiQuerySearch::addInterwikiResults(), CoreParserFunctions::anchorencode(), SkinTemplate::buildContentNavigationUrls(), HTMLForm::displaySection(), SimpleCaptcha::doConfirmEdit(), Skin::doEditSectionLink(), IndexPager::doQuery(), TestFileEditor::emitTest(), ApiEditPage::execute(), TestFileEditor::execute(), Linker::formatAutocomments(), DummyLinker::formatTemplates(), Linker::formatTemplates(), Linker::generateTOC(), Wikimedia\Rdbms\LBFactoryMulti::getAllMainLBs(), HTMLForm::getFooterText(), HTMLForm::getHeaderText(), OOUIHTMLForm::getHeaderText(), HTMLMultiSelectField::getInputOOUI(), Wikimedia\Rdbms\LBFactoryMulti::getMainLB(), GadgetHooks::getPreferences(), RawAction::getRawText(), Wikimedia\Rdbms\LBFactoryMulti::getSectionForDomain(), MediaWikiGadgetsDefinitionRepo::listFromDefinition(), SimpleCaptcha::loadText(), Exif::makeFilteredData(), Wikimedia\Rdbms\LBFactoryMulti::newMainLB(), Sanitizer::normalizeSectionNameWhitespace(), WebInstallerOutput::outputFooter(), TestFileEditor::parseTest(), EditPageTest::provideAutoMerge(), MediaWiki\Widget\Search\FullSearchResultWidget::render(), ParserTestRunner::runTest(), ProfilerSectionOnly::scopedProfileIn(), ProfilerXhprof::scopedProfileIn(), SectionProfiler::scopedProfileIn(), SectionProfiler::scopedProfileOut(), Profiler::scopedProfileOut(), FileBackend::scopedProfileSection(), HTMLForm::setFooterText(), HTMLForm::setHeaderText(), SimpleCaptcha::shouldCheck(), SpecialGadgets::showMainForm(), EditPageTest::testExtractSectionTitle(), EditPageTest::testSectionEdit(), Exif::validate(), HTMLForm::wrapFieldSetSection(), and OOUIHTMLForm::wrapFieldSetSection().

◆ $services

configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place or wrap services the preferred way to define a new service is the $wgServiceWiringFiles array $services

static

Definition at line 2258 of file hooks.txt.

◆ $skin

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an<a> element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned $skin

Definition at line 2009 of file hooks.txt.

Referenced by ApiQuerySiteinfo::appendSkins(), ResourceLoaderOOUIFileModule::extendSkinSpecific(), ResourceLoaderImageModule::getGlobalVariants(), ResourceLoaderImageModule::getImages(), ResourceLoaderContext::getSkin(), ResourceLoaderOOUIImageModule::loadFromDefinition(), SkinFactory::makeSkin(), ApiParseTest::setupSkin(), and WebInstallerOptions::submit().

◆ $special

this hook is for auditing only RecentChangesLinked and Watchlist $special

Definition at line 992 of file hooks.txt.

Referenced by BaseTemplate::getToolbox().

◆ $suppressed

returning false will NOT prevent logging a wrapping ErrorException $suppressed

Definition at line 2177 of file hooks.txt.

Referenced by MWExceptionHandler::logError(), and DifferenceEngine::showDiffPage().

◆ $tabindex

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections and Diff& $tabindex

Definition at line 1430 of file hooks.txt.

Referenced by EditPage::getCheckboxesWidget(), EditPage::getEditButtons(), Xml::listDropDown(), and EditPage::showStandardInputs().

◆ $tables

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist& $tables

Definition at line 1007 of file hooks.txt.

◆ $template

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping $template

Definition at line 822 of file hooks.txt.

Referenced by OutputPage::addTemplate(), TemplatesOnThisPageFormatter::format(), LoginSignupSpecialPage::getBCFieldDefinitions(), LoginSignupSpecialPage::getFakeTemplate(), LoginSignupSpecialPage::getFieldDefinitions(), HTMLFormFieldCloner::getInputHTML(), SpecialExport::getLinks(), GenerateJqueryMsgData::getMessagesAndTests(), ApiOpenSearch::getOpenSearchTemplate(), TimelessTemplate::getPortlet(), PPFuzzTest::getReport(), BaseTemplate::getSidebar(), EditPage::getTemplates(), BaseTemplate::getToolbox(), Wikimedia\Rdbms\LBFactoryMulti::makeServerArray(), AuthPlugin::modifyUITemplate(), Wikimedia\Rdbms\LBFactoryMulti::newExternalLB(), Wikimedia\Rdbms\LBFactoryMulti::newLoadBalancer(), Wikimedia\Rdbms\LBFactoryMulti::newMainLB(), SkinTemplateTest::testMakeListItem(), and TemplateCategoriesTest::testTemplateCategories().

◆ $term

For QUnit the mediawiki tests qunit testrunner dependency will be added to any module whereas SearchGetNearMatch runs after $term

Definition at line 2844 of file hooks.txt.

◆ $time

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters create2 Corresponds to logging log_action database field and which is displayed in the UI similar to $comment $time

Definition at line 1795 of file hooks.txt.

Referenced by OldLocalFile::__construct(), MediaWikiPHPUnitTestListener::addError(), MediaWikiPHPUnitTestListener::addFailure(), MediaWikiPHPUnitTestListener::addIncompleteTest(), MediaWikiPHPUnitTestListener::addSkippedTest(), Wikimedia\Rdbms\LoadBalancer::approveMasterChanges(), MediaWiki\Shell\Command::buildFinalCommand(), ApiFormatBase::closePrinter(), JobRunner::commitMasterChanges(), JobQueueAggregatorRedis::doGetAllReadyWikiQueues(), DBFileJournal::doGetPositionAtTime(), FileBackendTest::doTestGetFileStat(), PoolWorkArticleView::doWork(), MediaWikiPHPUnitTestListener::endTest(), LoginSignupSpecialPage::execute(), SyncFileBackend::execute(), Parser::fetchFileAndTitle(), FileRepo::findFile(), RepoGroup::findFile(), FileRepo::findFileFromKey(), MediaWiki\Logger\LegacyLogger::formatAsWfDebugLog(), FileDuplicateSearchPage::formatResult(), MIMEsearchPage::formatResult(), SpecialNewpages::formatRow(), NewFilesPager::formatRow(), DifferenceEngine::generateTextDiffBody(), ProtectionForm::getExpiry(), SpecialUndelete::getFileLink(), User::getFirstEditTimestamp(), Language::getHumanTimestamp(), Wikimedia\Rdbms\DatabaseMysqlBase::getLagFromPtHeartbeat(), WANObjectCache::getMultiCheckKeyTime(), SpecialUndelete::getPageLink(), FileJournal::getPositionAtTime(), SectionProfiler::getTime(), UIDGenerator::getTimeAndDelay(), UIDGenerator::getTimestampedID128(), UIDGenerator::getTimestampedID88(), UIDGenerator::intervalsSinceGregorianBinary(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProvider::isTimestampValid(), ApiStashEdit::lastEditTime(), SpecialUndelete::loadRequest(), LogEventsList::logLine(), ApiMain::logRequest(), DummyLinker::makeBrokenImageLinkObj(), Linker::makeBrokenImageLinkObj(), FormatMetadata::makeFormattedData(), Parser::makeImage(), DummyLinker::makeImageLink(), Linker::makeImageLink(), DummyLinker::makeMediaLinkObj(), Linker::makeMediaLinkObj(), DummyLinker::makeThumbLink2(), Linker::makeThumbLink2(), UIDGenerator::millisecondsSinceEpochBinary(), FileRepo::newFile(), ForeignAPIRepo::newFile(), OldLocalFile::newFromTitle(), User::newTouchedTimestamp(), IPTC::parse(), MediaWiki\Preferences\DefaultPreferencesFactory::profilePreferences(), ZipDirectoryReader::readCentralDirectory(), BagOStuff::setMockTime(), WANObjectCache::setMockTime(), EmailConfirmation::showRequestForm(), SpecialUndelete::showRevision(), MediaWiki\Session\CookieSessionProviderTest::testCookieData(), MediaWiki\Session\CookieSessionProviderTest::testPersistSession(), MediaWiki\Session\ImmutableSessionProviderWithCookieTest::testPersistSession(), WatchedItemStoreUnitTest::testResetNotificationTimestamp_futureNotificationTimestampForced(), WatchedItemStoreUnitTest::testResetNotificationTimestamp_futureNotificationTimestampNotForced(), WatchedItemStoreUnitTest::testResetNotificationTimestamp_notWatchedPageForced(), WatchedItemStoreUnitTest::testResetNotificationTimestamp_oldidSpecifiedLatestRevisionForced(), WatchedItemStoreUnitTest::testResetNotificationTimestamp_oldidSpecifiedNotLatestRevisionForced(), IPTC::timeHelper(), UIDGenerator::timeWaitUntil(), and Language::translateBlockExpiry().

◆ $title

do that in ParserLimitReportFormat instead use this to modify the parameters of the image $title

Definition at line 958 of file hooks.txt.

Referenced by WikiPage::__construct(), LinksUpdate::__construct(), MediaWiki\Storage\RevisionRecord::__construct(), ImageGalleryBase::add(), SpecialPageFactory::capturePath(), SpecialEditWatchlist::checkTitle(), HTMLFileCache::clearFileCache(), NaiveForeignTitleFactory::createForeignTitle(), ApiQuery::doExport(), GenderCache::doTitlesArray(), Revision::ensureTitle(), ApiQueryImageInfo::execute(), ConvertLinks::execute(), SpecialPageFactory::executePath(), Message::extractParam(), SpecialEditWatchlist::extractTitles(), Parser::fetchFileAndTitle(), Parser::fetchTemplateAndTitle(), SearchSuggestion::fromTitle(), NamespaceConflictChecker::getAlternateTitle(), MediaTransformOutput::getDescLinkAttribs(), ApiQueryRecentChangesIntegrationTest::getExternalRC(), ApiQueryWatchlistIntegrationTest::getExternalRC(), UserGroupMembership::getGroupPage(), LinksUpdate::getInterlangInsertions(), ApiPageSet::getInvalidTitlesAndRevisions(), WatchedItemStoreUnitTest::getMockTitle(), MessageCache::getMsgFromNamespace(), SearchNearMatcher::getNearMatch(), SearchNearMatcher::getNearMatchInternal(), RenameuserLogFormatter::getPreloadTitles(), ApiQueryInfo::getProtectionInfo(), RandomPage::getRandomTitle(), SpecialMyLanguage::getRedirect(), AbstractContent::getRedirectChain(), CssContent::getRedirectTarget(), JavaScriptContent::getRedirectTarget(), WikitextContent::getRedirectTarget(), WikitextContent::getRedirectTargetAndText(), ApiPageSet::getRedirectTargets(), TitleArrayFromResultTest::getRowWithTitle(), DatabaseLogEntry::getTarget(), RCDatabaseLogEntry::getTarget(), Parser::getTemplateDom(), MediaWiki\Storage\RevisionStore::getTitle(), SpecialReplaceText::getTitlesForEditingWithContext(), SpecialReplaceText::getTitlesForMoveAndUnmoveableTitles(), ExternalUserNames::getUserLinkTitle(), SpecialEditWatchlist::getWatchlist(), ApiComparePages::guessTitleAndModel(), WikiImporter::handlePage(), ApiPageSet::initFromQueryResult(), SearchResult::initFromTitle(), MediaWikiTestCase::insertPage(), SpecialNuke::listForm(), MediaWiki::main(), SpecialExpandTemplates::makeForm(), BaseTemplate::makeLink(), Title::makeName(), MediaWiki\Tests\EditPage\TextboxBuilderTest::mockProtectedTitle(), XmlDumpWriter::namespaces(), Title::newFromID(), Category::newFromName(), Category::newFromRow(), Category::newFromTitle(), Title::newMainPage(), RecentChange::notifyEdit(), RecentChange::notifyNew(), InputBoxHooks::onMediaWikiPerformAction(), ParsoidVirtualRESTService::onParsoid1Request(), RestbaseVirtualRESTService::onParsoid1Request(), SpecialReplaceText::pageListForm(), NamespaceAwareForeignTitleFactory::parseTitleNoNs(), NamespaceAwareForeignTitleFactory::parseTitleWithNs(), Skin::preloadExistence(), ApiPageSet::processDbRow(), WikiImporter::processTitle(), ApiPageSet::processTitlesArray(), MediaWiki\Tests\Storage\MutableRevisionRecordTest::provideConstructor(), MediaWiki\Tests\Storage\RevisionArchiveRecordTest::provideConstructor(), MediaWiki\Tests\Storage\RevisionStoreRecordTest::provideConstructor(), MediaWiki\Tests\Storage\MutableRevisionRecordTest::provideConstructorFailure(), MediaWiki\Tests\Storage\RevisionArchiveRecordTest::provideConstructorFailure(), MediaWiki\Tests\Storage\RevisionStoreRecordTest::provideConstructorFailure(), LinkerTest::provideLinkBeginHook(), LinkerTest::provideLinkEndHook(), JobTest::provideTestJobFactory(), DoubleRedirectsPage::reallyGetQueryInfo(), ImageMap::render(), MessageCache::replace(), ApiQueryProtectedTitles::run(), ApiQueryQueryPage::run(), ApiQueryBacklinksprop::run(), ApiOpenSearch::search(), Message::serialize(), EditPage::setContextTitle(), ImageGalleryBase::setContextTitle(), ParserOptions::setRedirectTarget(), SearchSuggestion::setSuggestedTitle(), Parser::statelessFetchTemplate(), ExtraParserTest::statelessFetchTemplate(), ResourceLoaderWikiModuleTest::testGetContent(), ImportTest::testHandlePageContainsRedirect(), SampleTest::testSetUpMainPageTitleForNextTest(), Message::title(), ExtParserFunctions::titleparts(), and Maintenance::updateSearchIndexForPage().

◆ $unhide

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache $unhide

Definition at line 1633 of file hooks.txt.

Referenced by ContentHandler::createDifferenceEngine(), Article::setOldSubtitle(), and Article::showDiffPage().

◆ $user

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted $user

Definition at line 247 of file hooks.txt.

Referenced by UploadFromStash::__construct(), ImageListPager::__construct(), SpecialOATHDisable::__construct(), SpecialOATHEnable::__construct(), MediaWiki\Storage\RevisionArchiveRecord::__construct(), MediaWiki\Storage\RevisionStoreRecord::__construct(), UploadFromChunks::__construct(), MediaWiki\Auth\AuthPluginPrimaryAuthenticationProvider::autoCreatedAccount(), ApiTestCase::doApiRequest(), WikiPage::doCreate(), WikiPage::doEditContent(), WikiPage::doModify(), Article::doRollback(), ApiQueryImageInfo::execute(), ApiQueryContributions::execute(), DeleteBatch::execute(), DeleteDefaultMessages::execute(), DeleteEqualMessages::execute(), ImportImages::execute(), ImportSiteScripts::execute(), RollbackEdits::execute(), WrapOldPasswords::execute(), MediaWiki\Auth\CheckBlocksSecondaryAuthenticationProviderTest::getBlockedUser(), User::getInstanceForUpdate(), Skin::getRelevantUser(), CategoryMembershipChange::getUser(), ResourceLoaderContext::getUser(), BlockTest::getUserForBlocking(), ApiBase::getWatchlistUser(), ParserOptions::initialiseFromUser(), ReassignEdits::initialiseUser(), CentralIdLookup::localUserFromCentralId(), MovePage::move(), RecentChange::newForCategorization(), User::newFromAnyId(), User::newFromRow(), User::newFromSession(), RecentChange::newLogEntry(), User::newSystemUser(), RecentChange::notifyEdit(), RecentChange::notifyNew(), MediaWiki\Auth\AuthPluginPrimaryAuthenticationProvider::onLocalUserCreated(), SpecialChangeContentModel::onSubmit(), MediaWiki\Auth\AuthPluginPrimaryAuthenticationProvider::onUserLoggedIn(), PostgresInstaller::openConnectionToAnyDB(), ParserTestRunner::perTestSetup(), WikiPage::prepareContentForEdit(), ApiQueryBlocks::prepareUsername(), MediaWiki\Tests\Storage\RevisionArchiveRecordTest::provideConstructor(), MediaWiki\Tests\Storage\RevisionStoreRecordTest::provideConstructor(), MediaWiki\Tests\Storage\RevisionArchiveRecordTest::provideConstructorFailure(), MediaWiki\Tests\Storage\RevisionStoreRecordTest::provideConstructorFailure(), CaptchaPreAuthenticationProviderTest::provideTestForAccountCreation(), Block::setBlocker(), DataUpdate::setCause(), PreferencesForm::setModifiedUser(), LoginSignupSpecialPage::setSessionUserForCurrentRequest(), Parser::setUser(), MediaWiki\Storage\MutableRevisionRecord::setUser(), LogEventsList::showLogExtract(), MediaWiki\Auth\ResetPasswordSecondaryAuthenticationProviderTest::testBasics(), EditPageTest::testCreatePage(), EditPageTest::testCreatePageTrx(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest::testProviderAllowsAuthenticationDataChange(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProviderTest::testProviderAllowsAuthenticationDataChange(), MediaWiki\Auth\TemporaryPasswordPrimaryAuthenticationProviderTest::testProviderChangeAuthenticationData(), MediaWiki\Auth\LocalPasswordPrimaryAuthenticationProviderTest::testProviderChangeAuthenticationData(), MediaWiki\Auth\AuthManagerTest::testSecuritySensitiveOperationStatus(), and EditPageTest::testUpdatePage().

◆ $username

this hook is for auditing only or null if authentication failed before getting that far $username

Definition at line 785 of file hooks.txt.

◆ $vars

configuration should be added through ResourceLoaderGetConfigVars instead& $vars

static

Definition at line 2226 of file hooks.txt.

◆ $wgCapitalizeTitle

An extension or a local will often add custom code to the function with or without a global variable For someone wanting email notification when an article is shown may $wgCapitalizeTitle

Definition at line 56 of file hooks.txt.

◆ $wgHooks

When an event the function (or object method) will be called with the optional data provided as well as event-specific parameters. The above examples would result in the following code being executed when 'EventName' happened $wgHooks[ 'PageContentSaveComplete'][] = 'reverseArticleTitle'

◆ $wgNotifyArticle

An extension or a local will often add custom code to the function with or without a global variable For someone wanting email notification when an article is shown may $wgNotifyArticle

Definition at line 56 of file hooks.txt.

◆ AbortAutoAccount

please add to it if you re going to add events to the MediaWiki code AbortAutoAccount

Definition at line 243 of file hooks.txt.

◆ add

you don t have to do a grep find to see where the $wgReverseTitle variable is say If the code is well enough it can even be excluded when not used making for some slight savings in memory and load up performance at runtime Admins who want to have all the reversed titles can add

Definition at line 53 of file hooks.txt.

Referenced by LinkBatch::addObj(), PathRouter::addStrict(), BagOStuff::incrWithInit(), BagOStuff::lock(), BagOStuff::mergeViaCas(), and FancyCaptcha::pickImageFromList().

◆ addition

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In addition

Definition at line 88 of file hooks.txt.

Referenced by RedisLockManager::getLocksOnServer().

◆ admin

An extension or a local admin

Definition at line 51 of file hooks.txt.

◆ Alternatively

passed in as a query string parameter to the various URLs constructed here (i.e. $prevlink) $ldel you ll need to handle error etc yourself Alternatively

Definition at line 1399 of file hooks.txt.

Referenced by RecountCategories::__construct().

◆ article

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a third party developers and local administrators to define code that will be run at certain points in the mainline and to modify the data run by that mainline code Hooks can keep mainline code and make it easier to write extensions Hooks are a principled alternative to local patches for two options in MediaWiki One reverses the order of a title before displaying the article

Definition at line 33 of file hooks.txt.

◆ ATTENTION

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place ATTENTION

Definition at line 842 of file hooks.txt.

◆ AuthPluginAutoCreate

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that AuthPluginAutoCreate

Definition at line 788 of file hooks.txt.

◆ AutopromoteCondition

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub AutopromoteCondition

Definition at line 798 of file hooks.txt.

◆ becomes

Using a hook running we can avoid having all this option specific stuff in our mainline code Using the function becomes

Definition at line 74 of file hooks.txt.

◆ BeforeDisplayNoArticleText

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array BeforeDisplayNoArticleText

Definition at line 835 of file hooks.txt.

◆ BeforeInitialize

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable BeforeInitialize

Definition at line 847 of file hooks.txt.

◆ BeforeParserFetchFileAndTitle

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable BeforeParserFetchFileAndTitle

Definition at line 867 of file hooks.txt.

◆ BitmapHandlerTransform

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result BitmapHandlerTransform

Definition at line 898 of file hooks.txt.

◆ block

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters block

Definition at line 2198 of file hooks.txt.

Referenced by SpecialUnblock::execute(), DiffFormatter::format(), SpecialUnblock::getFields(), and SpecialBlock::maybeAlterFormDefaults().

◆ BlockIp

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves set to a MediaTransformOutput BlockIp

Definition at line 905 of file hooks.txt.

◆ BlockIpComplete

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves set to a MediaTransformOutput the error message to be returned in an array BlockIpComplete

Definition at line 910 of file hooks.txt.

◆ bolding

presenting them properly to the user as errors is done by the caller return true but is called only if expensive checks are enabled Add a permissions error when permissions errors are checked for Return false if the user can t do and populate $result with the reason in the form of error messages should be plain text with no special bolding

Definition at line 1747 of file hooks.txt.

◆ broken

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped broken

Definition at line 2001 of file hooks.txt.

Referenced by CleanupInvalidDbKeys::__construct(), CheckLanguageCLI::help(), CheckExtensionsCLI::help(), and Parser::replaceInternalLinks2().

◆ bugs

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid bugs

Definition at line 2612 of file hooks.txt.

◆ check

</code > has no name attribute</span ></p > !end !article vol XXI</ref >< references group="klingon"/> ! html< p > Wikipedia rocks< sup id="cite_ref-1" class="reference">< a href="#cite_note-1"> &</p >< div class="mw-references-wrap">< ol class="references">< li id="cite_note-1">< span class="mw-cite-backlink">< a href="#cite_ref-1"> ↑</a ></span >< span class="reference-text"> Proceeds of vol XXI</span ></li ></ol ></div > !end !test Bug regression check

Definition at line 1481 of file hooks.txt.

Referenced by CategoryFinder::check(), Xml::checkLabel(), BrokenRedirectsPage::formatResult(), CheckLanguageCLI::help(), CheckExtensionsCLI::help(), ParserOutput::isLinkInternal(), CategoryFinder::run(), ApiQueryBasicTest::testAllTogether(), MWRestrictionsTest::testCheck(), ApiQueryBasicTest::testGenerator(), ApiQueryBasicTest::testGeneratorRedirects(), ApiQueryBasicTest::testLists(), and ApiQueryBasicTest::testProps().

◆ classes

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those classes

Definition at line 1002 of file hooks.txt.

◆ code

Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for and distribution as defined by Sections through of this document Licensor shall mean the copyright owner or entity authorized by the copyright owner that is granting the License Legal Entity shall mean the union of the acting entity and all other entities that control are controlled by or are under common control with that entity For the purposes of this definition control direct or to cause the direction or management of such whether by contract or including but not limited to software source documentation and configuration files Object form shall mean any form resulting from mechanical transformation or translation of a Source including but not limited to compiled object code

Definition at line 28 of file hooks.txt.

Referenced by CheckLanguageCLI::help(), and CheckExtensionsCLI::help().

◆ coloring

presenting them properly to the user as errors is done by the caller return true but is called only if expensive checks are enabled Add a permissions error when permissions errors are checked for Return false if the user can t do and populate $result with the reason in the form of error messages should be plain text with no special coloring

Definition at line 1747 of file hooks.txt.

◆ complete

Returning false makes less sense for events where the action is complete

Definition at line 197 of file hooks.txt.

Referenced by XhprofData::getCompleteMetrics(), CheckLanguageCLI::help(), and CheckExtensionsCLI::help().

◆ conditional

namespace addition is conditional

Definition at line 933 of file hooks.txt.

◆ Consider

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a third party developers and local administrators to define code that will be run at certain points in the mainline and to modify the data run by that mainline code Hooks can keep mainline code and make it easier to write extensions Hooks are a principled alternative to local patches Consider

Definition at line 32 of file hooks.txt.

◆ core

do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow (e.g. with the RejectParserCacheValue hook) because MediaWiki won't do it for you. &$defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on and they can depend only on the ResourceLoaderContext such as when responding to a resource loader request or generating HTML output included in core

Definition at line 2819 of file hooks.txt.

Referenced by LocalisationUpdate\Finder::__construct().

◆ Currently

the other converts the title to all uppercase letters Currently

Definition at line 34 of file hooks.txt.

◆ data

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of data

Definition at line 18 of file hooks.txt.

◆ deleteAnArticle

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing deleteAnArticle

Definition at line 91 of file hooks.txt.

◆ diff

passed in as a query string parameter to the various URLs constructed here (i.e. $nextlink) $rdel also included in $oldHeader indicating whether we should show just the diff

Definition at line 1259 of file hooks.txt.

Referenced by DiffHistoryBlob::compress(), DiffEngine::diff_range(), EditPage::edit(), EditPage::getEditPermissionErrors(), MWTimestamp::getRelativeTimestamp(), EditPage::getSummaryPreview(), EditPage::importFormData(), EditPage::showEditForm(), and EditPage::showHeader().

◆ do

processing should stop and the error should be shown to the user if you wanted to authenticate users to a custom you could do

Definition at line 188 of file hooks.txt.

◆ e

in this case you re responsible for computing and outputting the entire conflict i e

Definition at line 1421 of file hooks.txt.

Referenced by BenchmarkParse::execute(), SpecialJavaScriptTest::exportQUnit(), RedisLockManager::freeLocksOnServer(), RedisLockManager::getLocksOnServer(), DatabaseOracle::open(), PoolCounterRedis::release(), SearchPostgres::searchQuery(), and XmlTypeCheckTest::testRecursiveEntity().

◆ EditPageGetCheckboxesDefinition

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections and Diff or overridable Default is either copyrightwarning or copyrightwarning2 EditPageGetCheckboxesDefinition

Definition at line 1451 of file hooks.txt.

◆ EmailConfirmed

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections and Diff or overridable Default is either copyrightwarning or copyrightwarning2 overridable Default is editpage tos summary EmailConfirmed

Definition at line 1480 of file hooks.txt.

◆ error

</code > has conflicting group attribute</span >< br/>< span class="error mw-ext-cite-error" lang="en" dir="ltr"> Cite error

Definition at line 2687 of file hooks.txt.

◆ errors

presenting them properly to the user as errors is done by the caller return true but is called only if expensive checks are enabled Add a permissions error when permissions errors are checked for Return false if the user can t do and populate $result with the reason in the form of error messages should be plain text with no special etc to show that they re errors

Definition at line 1748 of file hooks.txt.

◆ etc

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing etc

Definition at line 91 of file hooks.txt.

◆ event

and how to run hooks for an event

Initial value:

==Glossary==
 
event
     Something that happens with the wiki. For example: a user logs in. A wiki
     page is saved. A wiki page is deleted. Often there are two events
     associated with a single action: one before the code is run to make the
     event happen

Definition at line 4 of file hooks.txt.

◆ example

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For example

Definition at line 13 of file hooks.txt.

◆ exportArticle

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing exportArticle

Definition at line 91 of file hooks.txt.

◆ false

null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return false

Definition at line 183 of file hooks.txt.

◆ feeds

Allows to change the fields on the form that will be generated are created Can be used to omit specific feeds from being outputted You must not use this hook to add feeds

Definition at line 304 of file hooks.txt.

◆ file

to their LocalSettings php file

Definition at line 92 of file hooks.txt.

Referenced by InvalidateUserSesssions::execute(), CheckLanguageCLI::help(), User::isLocallyBlockedProxy(), DatabaseInstaller::populateInterwikiTable(), DumpBackup::processOptions(), MergeMessageFileList::readFile(), TextSuppressor::suppress(), and CheckStyleSuppressor::suppress().

◆ FileDeleteComplete

return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used FileDeleteComplete

Definition at line 1555 of file hooks.txt.

◆ form

Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for and distribution as defined by Sections through of this document Licensor shall mean the copyright owner or entity authorized by the copyright owner that is granting the License Legal Entity shall mean the union of the acting entity and all other entities that control are controlled by or are under common control with that entity For the purposes of this definition control direct or to cause the direction or management of such whether by contract or including but not limited to software source documentation and configuration files Object form shall mean any form resulting from mechanical transformation or translation of a Source including but not limited to compiled object generated and conversions to other media types Work shall mean the work of whether in Source or Object made available under the as indicated by a copyright notice that is included in or attached to the whether in Source or Object that is based or other modifications as a an original work of authorship For the purposes of this Derivative Works shall not include works that remain separable or merely the Work and Derivative Works thereof Contribution shall mean any work of including the original version of the Work and any modifications or additions to that Work or Derivative Works that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner For the purposes of this submitted means any form of or written communication sent to the Licensor or its including but not limited to communication on electronic mailing source code control and issue tracking systems that are managed or on behalf the Licensor for the purpose of discussing and improving the but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as Not a Contribution Contributor shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work Grant of Copyright License Subject to the terms and conditions of this each Contributor hereby grants to You a non no royalty irrevocable copyright license to prepare Derivative Works publicly publicly and distribute the Work and such Derivative Works in Source or Object form Grant of Patent License Subject to the terms and conditions of this each Contributor hereby grants to You a non no royalty have offer to and otherwise transfer the where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed Redistribution You may reproduce and distribute copies of the Work or Derivative Works thereof in any with or without and in Source or Object form

Definition at line 1996 of file hooks.txt.

Referenced by SkinFallbackTemplate::execute(), CheckLanguageCLI::help(), CheckExtensionsCLI::help(), VectorTemplate::renderNavigation(), and Parser::replaceInternalLinks2().

◆ format

usually copyright or history_copyright This message must be in HTML format

Definition at line 1650 of file hooks.txt.

Referenced by MediaWiki\Logger\Monolog\AvroFormatter::formatBatch(), SpecialVersion::getCopyrightAndAuthorList(), MWTimestamp::getTimezoneMessage(), Parser::getVariableValue(), MediaWiki\Logger\LegacyLogger::log(), HistoryAction::onView(), and Language::sprintfDate().

◆ framework

For QUnit framework

Definition at line 2825 of file hooks.txt.

◆ functions

null for the local wiki Added should default to null in handler functions

Definition at line 1592 of file hooks.txt.

◆ GalleryGetModes

null for the local wiki Added should default to null in handler for backwards compatibility GalleryGetModes

Definition at line 1594 of file hooks.txt.

◆ Generally

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist Generally

Definition at line 1016 of file hooks.txt.

◆ GetCanonicalURL

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options GetCanonicalURL

Definition at line 1613 of file hooks.txt.

◆ GetDefaultSortkey

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list GetDefaultSortkey

Definition at line 1622 of file hooks.txt.

◆ GetDoubleUnderscoreIDs

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache allow viewing deleted revs difference engine object to be used for diff GetDoubleUnderscoreIDs

Definition at line 1637 of file hooks.txt.

◆ GetLinkColours

the value of this variable comes from LanguageConverter GetLinkColours

Definition at line 1683 of file hooks.txt.

◆ GetLocalURL

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys GetLocalURL

Definition at line 1688 of file hooks.txt.

◆ GetRelativeTimestamp

the value of this variable comes from LanguageConverter indexed by page_id indexed by prefixed DB keys can modify can modify can modify this should be populated with an alert message to that effect to be fed to an HTMLForm object GetRelativeTimestamp

Definition at line 1731 of file hooks.txt.

◆ getUserPermissionsErrorsExpensive

presenting them properly to the user as errors is done by the caller return true getUserPermissionsErrorsExpensive

Definition at line 1755 of file hooks.txt.

◆ GitViewers

presenting them properly to the user as errors is done by the caller return true GitViewers

Definition at line 1769 of file hooks.txt.

◆ handler

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check set to true or false to override the $wgMaxImageArea check result gives extension the possibility to transform it themselves set to a MediaTransformOutput the error message to be returned in an array you should do so by altering $wgNamespaceProtection and $wgNamespaceContentModels outside the handler

Definition at line 930 of file hooks.txt.

◆ herself

they could be provided by a third party developer or written by the admin him herself

Initial value:

==Writing hooks==
 
A hook is a chunk of code run at some particular event. It consists of:
 
  * a function with some optional accompanying data

Definition at line 127 of file hooks.txt.

◆ history

presenting them properly to the user as errors is done by the caller return true use this to change the list i e etc next in line in page history

Definition at line 1777 of file hooks.txt.

Referenced by WikiExporter::__construct(), SpecialImport::doImport(), Parser::doTableStuff(), TextPassDumper::dump(), WikiExporter::dumpFrom(), UpdateLogging::execute(), TextPassDumper::processOptions(), and SpecialImport::showForm().

◆ hook

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a hook

Initial value:

==Rationale==
 
Hooks allow us to decouple optionally-run code from code that is run for
everyone. It allows MediaWiki hackers

Definition at line 21 of file hooks.txt.

◆ hooks

they could be provided by a third party developer or written by the admin him or *an object with a method and some optional accompanying data Hooks are registered by adding them to the global $wgHooks array for a given event All the following are valid ways to define hooks

Definition at line 74 of file hooks.txt.

Referenced by SpecialUpload::processVerificationError().

◆ However

configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place or wrap services However

static

Definition at line 2256 of file hooks.txt.

◆ imagelinks

either a unescaped string or a HtmlArmor object after in associative array form imagelinks

Definition at line 2085 of file hooks.txt.

◆ ImageOpenShowImageInlineBefore

see documentation in includes Linker php for Linker::makeImageLink or false for current used if you return false ImageOpenShowImageInlineBefore

Definition at line 1798 of file hooks.txt.

◆ in

null for the local wiki Added in

Definition at line 1591 of file hooks.txt.

Referenced by CheckLanguageCLI::help(), and CheckExtensionsCLI::help().

◆ insert

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and insert

Definition at line 2091 of file hooks.txt.

Referenced by Wikimedia\Rdbms\Database::nonNativeInsertSelect(), Wikimedia\Rdbms\Database::replace(), and Wikimedia\Rdbms\Database::upsert().

◆ Instead

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure Instead

Definition at line 1002 of file hooks.txt.

◆ isolated

you don t have to do a grep find to see where the $wgReverseTitle variable is say If the code is well enough isolated

Definition at line 117 of file hooks.txt.

◆ it

presenting them properly to the user as errors is done by the caller return true but is called only if expensive checks are enabled Add a permissions error when permissions errors are checked for Return false if the user can t do it

Definition at line 1757 of file hooks.txt.

◆ key

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a set this to the key of the message First element is the message key

Definition at line 2164 of file hooks.txt.

◆ link

usually copyright or history_copyright This message must be in HTML not wikitext if the section is included from a template to be included in the link

◆ Live

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections Live

Definition at line 1429 of file hooks.txt.

◆ LogEventsListGetExtraInputs

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation LogEventsListGetExtraInputs

Definition at line 2145 of file hooks.txt.

◆ LogLine

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters LogLine

Definition at line 2195 of file hooks.txt.

◆ MarkPatrolled

configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title MarkPatrolled

static

Definition at line 2230 of file hooks.txt.

◆ MediaWiki

those of us who don t want or need it can just leave it out The extensions don t even have to be shipped with MediaWiki

Definition at line 3 of file hooks.txt.

◆ message

either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a message

Definition at line 2163 of file hooks.txt.

Referenced by MediaWiki\Auth\AuthManagerTest::provideAccountCreation(), MediaWiki\Auth\AuthManagerTest::provideAccountLink(), MediaWiki\Auth\AuthManagerTest::provideAuthentication(), EditPageTest::provideAutoMerge(), MediaWiki\Auth\AuthManagerTest::testAccountCreation(), MediaWiki\Auth\AuthManagerTest::testAccountLink(), MediaWiki\Auth\AuthManagerTest::testAuthentication(), MediaWiki\Auth\AuthManagerTest::testAutoCreateOnLogin(), MediaWiki\Auth\AuthManagerTest::testContinueAccountCreation(), and MediaWiki\Auth\AuthManagerTest::testContinueAccountLink().

◆ messages

passed in as a query string parameter to the various URLs constructed here (i.e. $prevlink) $ldel you ll need to handle error messages

Definition at line 1398 of file hooks.txt.

Referenced by CheckLanguageCLI::help(), and CheckExtensionsCLI::help().

◆ ModifyExportQuery

for adding new MIME types to the list ModifyExportQuery

Definition at line 2300 of file hooks.txt.

◆ object

either a unescaped string or a HtmlArmor object

Definition at line 2057 of file hooks.txt.

◆ occur

return true to allow those checks to occur

Definition at line 1482 of file hooks.txt.

Referenced by CleanupInvalidDbKeys::__construct().

◆ occurs

When an event occurs

Definition at line 148 of file hooks.txt.

◆ on

We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going on

Definition at line 86 of file hooks.txt.

◆ PageContentSave

and how to run hooks for an and one after Each event has a preferably in CamelCase For PageContentSave

Definition at line 13 of file hooks.txt.

◆ PageContentSaveComplete

and how to run hooks for an and one after Each event has a preferably in CamelCase For PageContentSaveComplete

Definition at line 14 of file hooks.txt.

◆ pagelinks

either a unescaped string or a HtmlArmor object after in associative array form pagelinks

Definition at line 2085 of file hooks.txt.

◆ ParserLimitReportPrepare

namespace are movable Hooks may change this value to override the return value of MWNamespace::isMovable (). 'NewDifferenceEngine' if it s text intended for display in a monospaced font $report should be output in English ParserLimitReportPrepare

Definition at line 2596 of file hooks.txt.

◆ part

in this case you re responsible for computing and outputting the entire conflict part

Definition at line 1421 of file hooks.txt.

Referenced by Preprocessor_Hash::preprocessToObj().

◆ performed

this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been performed

Definition at line 892 of file hooks.txt.

Referenced by UpdateLogging::execute().

◆ plain

either a plain

Definition at line 2056 of file hooks.txt.

Referenced by Skin::addToSidebar(), Parser::braceSubstitution(), SpecialEditTags::buildCheckBoxes(), Cite::error(), SpecialContributions::execute(), WebInstallerComplete::execute(), WebInstallerExistingWiki::execute(), WebInstallerInstall::execute(), WebInstallerOptions::execute(), WebInstallerRestart::execute(), WebInstallerUpgrade::execute(), WebInstallerWelcome::execute(), ApiAuthManagerHelper::formatFields(), AllMessagesTablePager::formatValue(), SpecialInterwiki::getDescription(), WebInstaller::getRadioElements(), MssqlInstaller::getSettingsForm(), ReplaceAll::getSummary(), CategoryTree::getTag(), DatabaseInstaller::getWebUserBox(), Block::isWhitelistedFromAutoblocks(), MergeHistory::merge(), MovePage::moveToInternal(), ImagePage::printSharedImageText(), EditPageTest::provideAutoMerge(), CategoryTree::renderNodeInfo(), WebInstallerUpgrade::showDoneMessage(), WebInstallerExistingWiki::showKeyForm(), WebInstaller::showMessage(), MessageTest::testExpiryParams(), MessageTest::testRawParams(), MessageTest::testToStringKey(), Cite::warning(), and OutputPage::wrapWikiMsg().

◆ Preview

in this case you re responsible for computing and outputting the entire conflict i the difference between revisions and your text headers and sections Preview

Definition at line 1429 of file hooks.txt.

◆ processing

either a unescaped string or a HtmlArmor object after processing

Definition at line 2014 of file hooks.txt.

Referenced by Exif::__construct(), and MediaWikiTitleCodec::splitTitleString().

◆ RecentChangesLinked

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist RecentChangesLinked

Definition at line 1016 of file hooks.txt.

◆ replace

configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set but before ordinary actions take place replace

static

Definition at line 2255 of file hooks.txt.

Referenced by MediaWiki\Tidy\BalanceActiveFormattingElements::reconstruct(), ReplaceAll::showFileFormat(), and MessageCache::updateMessageOverride().

◆ request

returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters create2 Corresponds to logging log_action database field and which is displayed in the UI similar to $comment this hook should only be used to add variables that depend on the current page request

Definition at line 2224 of file hooks.txt.

Referenced by Http::get(), and Http::post().

◆ rollback

presenting them properly to the user as errors is done by the caller return true use this to change the list i e rollback

Definition at line 1774 of file hooks.txt.

Referenced by Wikimedia\Rdbms\Database::cancelAtomic(), Wikimedia\Rdbms\Database::close(), Wikimedia\Rdbms\Database::deadlockLoop(), and Wikimedia\Rdbms\Database::runOnTransactionIdleCallbacks().

◆ rss

Allows to change the fields on the form that will be generated rss

Definition at line 302 of file hooks.txt.

◆ saved

This code would result in ircNotify being run twice when an article is saved

Definition at line 174 of file hooks.txt.

◆ SearchGetNearMatch

set to $title object and return false for a match SearchGetNearMatch

Definition at line 2847 of file hooks.txt.

◆ SearchGetNearMatchBefore

set to $title object and return false for a match SearchGetNearMatchBefore

Definition at line 2852 of file hooks.txt.

◆ SearchGetNearMatchComplete

the value to return A Title object or null SearchGetNearMatchComplete

Definition at line 2857 of file hooks.txt.

◆ SearchIndexFields

the value to return A Title object or null for latest SearchIndexFields

Definition at line 2867 of file hooks.txt.

◆ simple

and how to run hooks for an and one after Each event has a preferably in CamelCase For ArticleDelete hook A clump of code and data that should be run when an event happens This can be either a function and a chunk of or an object and a method hook function The function part of a third party developers and local administrators to define code that will be run at certain points in the mainline and to modify the data run by that mainline code Hooks can keep mainline code simple

Definition at line 29 of file hooks.txt.

◆ source

null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify as strings Extensions should add to this list prev or next refreshes the diff cache allow viewing deleted revs difference engine object to be used for diff source

Initial value:

=> 'name of hook'
    ).
$file: File object of file in question
$context: RequestContext (including language to use)
$single: Only extract the current language

Definition at line 1645 of file hooks.txt.

◆ strategy

Using a hook running strategy

Definition at line 73 of file hooks.txt.

◆ string

This code would result in ircNotify being run twice when an article is and once for brion Hooks can return three possible true was required This is the default since MediaWiki* some string

Definition at line 181 of file hooks.txt.

◆ structure

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that structure

Definition at line 1004 of file hooks.txt.

Referenced by RedisLockManager::freeLocksOnServer().

◆ them

this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist and Watchlist you will want to construct new ChangesListBooleanFilter or ChangesListStringOptionsFilter objects When constructing them

Definition at line 1018 of file hooks.txt.

Referenced by PoolCounterRedis::initAndPopPoolSlotList().

◆ true

return true

Definition at line 2006 of file hooks.txt.

◆ understand

Having all this code related to the title reversion option in one place means that it s easier to read and understand

Definition at line 114 of file hooks.txt.

◆ undo

presenting them properly to the user as errors is done by the caller return true use this to change the list i e undo

Definition at line 1774 of file hooks.txt.

◆ up

configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title after the basic globals have been set up

static

Definition at line 2245 of file hooks.txt.

◆ used

you don t have to do a grep find to see where the $wgReverseTitle variable is used

Definition at line 115 of file hooks.txt.

Referenced by CheckLanguageCLI::help(), and CheckExtensionsCLI::help().

◆ UserLogin

and how to run hooks for an and one after Each event has a preferably in CamelCase For UserLogin

Definition at line 13 of file hooks.txt.

◆ values

null means default in associative array with keys and values unescaped Should be merged with default values

Definition at line 177 of file hooks.txt.

Referenced by Exif::__construct(), CheckLanguageCLI::help(), CheckExtensionsCLI::help(), and HtmlTest::testExpandAttributesSpaceSeparatedAttributesWithBoolean().

◆ weird

We ve cleaned up the code here by removing clumps of weird

Definition at line 84 of file hooks.txt.

◆ writer

An extension writer

Definition at line 51 of file hooks.txt.

Referenced by WikiExporter::__construct(), MediaWiki\Logger\Monolog\AvroFormatter::__construct(), BatchRowUpdate::__construct(), WikiExporter::closeStream(), BatchRowUpdate::execute(), LCStoreCDB::finishWrite(), MediaWiki\Logger\Monolog\AvroFormatter::format(), WikiExporter::openStream(), WikiExporter::outputLogStream(), WikiExporter::outputPageStream(), LCStoreCDB::set(), and LCStoreCDB::startWrite().

Typedefs

Functions

Variables

Typedef Documentation

◆ $status

◆ name

Function Documentation

◆ addExtraTypes()

◆ array() [1/2]

◆ array() [2/2]

◆ follows()

◆ groups()

◆ if()

◆ ldapLogin()

◆ options()

◆ own()

◆ query()

◆ system()

◆ values()

◆ wfMessage()

Variable Documentation

◆ $abortMsg

◆ $article

◆ $attribs

◆ $auto

◆ $changesList

◆ $code

◆ $colours

◆ $context

◆ $customAttribs

◆ $differenceEngine

◆ $e

◆ $editor

◆ $engine

◆ $extTypes

◆ $handler

◆ $handlerParams

◆ $html

◆ $image

◆ $ldapServer

◆ $link

◆ $linkRenderer

◆ $linksUpdate

◆ $localize

◆ $mimeMagic

◆ $name

◆ $namespaces

◆ $newminor

◆ $newtalks

◆ $oldminor

◆ $options

◆ $out

◆ $output

◆ $parser

◆ $pre

◆ $query

◆ $refreshCache

◆ $req

◆ $request

◆ $requests

◆ $res

◆ $resourceLoader

◆ $ResourceLoader

◆ $response

◆ $result

◆ $ret

◆ $retval

◆ $rev

◆ $revert

◆ $rollback

◆ $rowAugmentors

◆ $rows

◆ $section

◆ $services

◆ $skin

◆ $special

◆ $suppressed

◆ $tabindex

◆ $tables

◆ $template