Manual:$wgHooks/de-formal

From Linux Web Expert

<translate> Extensions</translate>: $wgHooks
Global list of hooks.
<translate> Introduced in version:</translate>1.4.0 (r6405)
<translate> Removed in version:</translate><translate> still in use</translate>
<translate> Allowed values:</translate>See details
<translate> Default value:</translate>[]

Details

Global list of hooks. It is an array of arrays: it specifies for every event an array of functions to be called.

In MW 1.40, the use of $wgHooks after initialisation was deprecated (T331602). Use HookContainer::register and HookContainer::scopedRegister instead.

Add a hook by doing:

$wgHooks['event_name'][] = 'function';

or:

$wgHooks['event_name'][] = array( 'function', $data );

or:

$wgHooks['event_name'][] = array( $object, 'method' );

or:

$wgHooks['event_name'][] = $object;

In the last case, the callback is expected to be a method in $object of the same name as the event preceded by "on", e.g. "onUnknownAction"

Hooks are called when events happen, where a hook is a PHP function, and an event is an abstract concept.


See also