3 This document describes how event hooks work in MediaWiki; how to add
4 hooks for an event; and how to run hooks for an event.
9 Something that happens with the wiki. For example: a user logs
10 in. A wiki page is saved. A wiki page is deleted. Often there are
11 two events associated with a single action: one before the code
12 is run to make the event happen, and one after. Each event has a
13 name, preferably in CamelCase. For example, 'UserLogin',
14 'ArticleSave', 'ArticleSaveComplete', 'ArticleDelete'.
17 A clump of code and data that should be run when an event
18 happens. This can be either a function and a chunk of data, or an
22 The function part of a hook.
26 Hooks allow us to decouple optionally-run code from code that is run
27 for everyone. It allows MediaWiki hackers, third-party developers and
28 local administrators to define code that will be run at certain points
29 in the mainline code, and to modify the data run by that mainline
30 code. Hooks can keep mainline code simple, and make it easier to
31 write extensions. Hooks are a principled alternative to local patches.
33 Consider, for example, two options in MediaWiki. One reverses the
34 order of a title before displaying the article; the other converts the
35 title to all uppercase letters. Currently, in MediaWiki code, we
36 would handle this as follows (note: not real code, here):
38 function showAnArticle($article) {
39 global $wgReverseTitle, $wgCapitalizeTitle;
41 if ($wgReverseTitle) {
42 wfReverseTitle($article);
45 if ($wgCapitalizeTitle) {
46 wfCapitalizeTitle($article);
49 # code to actually show the article goes here
52 An extension writer, or a local admin, will often add custom code to
53 the function -- with or without a global variable. For example,
54 someone wanting email notification when an article is shown may add:
56 function showAnArticle($article) {
57 global $wgReverseTitle, $wgCapitalizeTitle;
59 if ($wgReverseTitle) {
60 wfReverseTitle($article);
63 if ($wgCapitalizeTitle) {
64 wfCapitalizeTitle($article);
67 # code to actually show the article goes here
69 if ($wgNotifyArticle) {
70 wfNotifyArticleShow($article));
74 Using a hook-running strategy, we can avoid having all this
75 option-specific stuff in our mainline code. Using hooks, the function
78 function showAnArticle($article) {
80 if (wfRunHooks('ArticleShow', array(&$article))) {
82 # code to actually show the article goes here
84 wfRunHooks('ArticleShowComplete', array(&$article));
88 We've cleaned up the code here by removing clumps of weird,
89 infrequently used code and moving them off somewhere else. It's much
90 easier for someone working with this code to see what's _really_ going
91 on, and make changes or fix bugs.
93 In addition, we can take all the code that deals with the little-used
94 title-reversing options (say) and put it in one place. Instead of
95 having little title-reversing if-blocks spread all over the codebase
96 in showAnArticle, deleteAnArticle, exportArticle, etc., we can
97 concentrate it all in an extension file:
99 function reverseArticleTitle($article) {
103 function reverseForExport($article) {
107 The setup function for the extension just has to add its hook
108 functions to the appropriate events:
110 setupTitleReversingExtension() {
113 $wgHooks['ArticleShow'][] = 'reverseArticleTitle';
114 $wgHooks['ArticleDelete'][] = 'reverseArticleTitle';
115 $wgHooks['ArticleExport'][] = 'reverseForExport';
118 Having all this code related to the title-reversion option in one
119 place means that it's easier to read and understand; you don't have to
120 do a grep-find to see where the $wgReverseTitle variable is used, say.
122 If the code is well enough isolated, it can even be excluded when not
123 used -- making for some slight savings in memory and load-up
124 performance at runtime. Admins who want to have all the reversed
127 require_once('extensions/ReverseTitle.php');
129 ...to their LocalSettings.php file; those of us who don't want or need
130 it can just leave it out.
132 The extensions don't even have to be shipped with MediaWiki; they
133 could be provided by a third-party developer or written by the admin
138 A hook is a chunk of code run at some particular event. It consists of:
140 * a function with some optional accompanying data, or
141 * an object with a method and some optional accompanying data.
143 Hooks are registered by adding them to the global $wgHooks array for a
144 given event. All the following are valid ways to define hooks:
146 $wgHooks['EventName'][] = 'someFunction'; # function, no data
147 $wgHooks['EventName'][] = array('someFunction', $someData);
148 $wgHooks['EventName'][] = array('someFunction'); # weird, but OK
150 $wgHooks['EventName'][] = $object; # object only
151 $wgHooks['EventName'][] = array($object, 'someMethod');
152 $wgHooks['EventName'][] = array($object, 'someMethod', $someData);
153 $wgHooks['EventName'][] = array($object); # weird but OK
155 When an event occurs, the function (or object method) will be called
156 with the optional data provided as well as event-specific parameters.
157 The above examples would result in the following code being executed
158 when 'EventName' happened:
161 someFunction($param1, $param2)
163 someFunction($someData, $param1, $param2)
166 $object->onEventName($param1, $param2)
168 $object->someMethod($param1, $param2)
169 # object with method and data
170 $object->someMethod($someData, $param1, $param2)
172 Note that when an object is the hook, and there's no specified method,
173 the default method called is 'onEventName'. For different events this
174 would be different: 'onArticleSave', 'onUserLogin', etc.
176 The extra data is useful if we want to use the same function or object
177 for different purposes. For example:
179 $wgHooks['ArticleSaveComplete'][] = array('ircNotify', 'TimStarling');
180 $wgHooks['ArticleSaveComplete'][] = array('ircNotify', 'brion');
182 This code would result in ircNotify being run twice when an article is
183 saved: once for 'TimStarling', and once for 'brion'.
185 Hooks can return three possible values:
187 * true: the hook has operated successfully
188 * "some string": an error occurred; processing should
189 stop and the error should be shown to the user
190 * false: the hook has successfully done the work
191 necessary and the calling function should skip
193 The last result would be for cases where the hook function replaces
194 the main functionality. For example, if you wanted to authenticate
195 users to a custom system (LDAP, another PHP program, whatever), you
198 $wgHooks['UserLogin'][] = array('ldapLogin', $ldapServer);
200 function ldapLogin($username, $password) {
205 Returning false makes less sense for events where the action is
206 complete, and will normally be ignored.
210 A calling function or method uses the wfRunHooks() function to run
211 the hooks related to a particular event, like so:
217 if (wfRunHooks('ArticleProtect', array(&$this, &$wgUser))) {
218 # protect the article
219 wfRunHooks('ArticleProtectComplete', array(&$this, &$wgUser));
224 wfRunHooks() returns true if the calling function should continue
225 processing (the hooks ran OK, or there are no hooks to run), or false
226 if it shouldn't (an error occurred, or one of the hooks handled the
227 action already). Checking the return value matters more for "before"
228 hooks than for "complete" hooks.
230 Note that hook parameters are passed in an array; this is a necessary
231 inconvenience to make it possible to pass reference values (that can
232 be changed) into the hook code. Also note that earlier versions of
233 wfRunHooks took a variable number of arguments; the array() calling
234 protocol came about after MediaWiki 1.4rc1.
236 ==Events and parameters==
238 This is a list of known events and parameters; please add to it if
239 you're going to add events to the MediaWiki code.
241 'AbortLogin': Return false to cancel account login.
242 $user: the User object being authenticated against
243 $password: the password being submitted, not yet checked for validity
244 &$retval: a LoginForm class constant to return from authenticateUserData();
245 default is LoginForm::ABORTED. Note that the client may be using
246 a machine API rather than the HTML user interface.
248 'AbortNewAccount': Return false to cancel account creation.
249 $user: the User object about to be created (read-only, incomplete)
250 $message: out parameter: error message to display on abort
252 'AddNewAccount': after a user account is created
253 $user: the User object that was created. (Parameter added in 1.7)
255 'AjaxAddScript': Called in output page just before the initialisation
256 of the javascript ajax engine. The hook is only called when ajax
257 is enabled ( $wgUseAjax = true; ).
259 'AlternateEdit': before checking if an user can edit a page and
260 before showing the edit form ( EditPage::edit() ). This is triggered
262 $EditPage : the EditPage object
264 'ArticleDelete': before an article is deleted
265 $article: the article (object) being deleted
266 $user: the user (object) deleting the article
267 $reason: the reason (string) the article is being deleted
269 'ArticleDeleteComplete': after an article is deleted
270 $article: the article that was deleted
271 $user: the user that deleted the article
272 $reason: the reason the article was deleted
274 'ArticleInsertComplete': After an article is created
275 $article: Article created
276 $user: User creating the article
278 $summary: Edit summary/comment
279 $isMinor: Whether or not the edit was marked as minor
280 $isWatch: (No longer used)
281 $section: (No longer used)
282 $flags: Flags passed to Article::doEdit()
283 $revision: New Revision of the article
285 'ArticleProtect': before an article is protected
286 $article: the article being protected
287 $user: the user doing the protection
288 $protect: boolean whether this is a protect or an unprotect
289 $reason: Reason for protect
290 $moveonly: boolean whether this is for move only or not
292 'ArticleProtectComplete': after an article is protected
293 $article: the article that was protected
294 $user: the user who did the protection
295 $protect: boolean whether it was a protect or an unprotect
296 $reason: Reason for protect
297 $moveonly: boolean whether it was for move only or not
299 'ArticleRollbackComplete': after an article rollback is completed
300 $article: the article that was edited
301 $user: the user who did the rollback
302 $revision: the revision the page was reverted back to
304 'ArticleSave': before an article is saved
305 $article: the article (object) being saved
306 $user: the user (object) saving the article
307 $text: the new article text
308 $summary: the article summary (comment)
313 'ArticleSaveComplete': After an article has been updated
314 $article: Article modified
315 $user: User performing the modification
317 $summary: Edit summary/comment
318 $isMinor: Whether or not the edit was marked as minor
319 $isWatch: (No longer used)
320 $section: (No longer used)
321 $flags: Flags passed to Article::doEdit()
322 $revision: New Revision of the article
324 'ArticleSaveComplete': after an article is saved
325 $article: the article (object) saved
326 $user: the user (object) who saved the article
327 $text: the new article text
328 $summary: the article summary (comment)
333 wfRunHooks( 'ArticleSaveComplete', array( &$this, &$wgUser, $text, $summary, $flags & EDIT_MINOR, null, null, &$flags, $revision ) );
335 'ArticleUndeleted': When one or more revisions of an article are restored
336 $title: Title corresponding to the article restored
337 $create: Whether or not the restoration caused the page to be created
338 (i.e. it didn't exist before)
340 'ArticleViewHeader': Before the parser cache is about to be tried for article viewing.
341 &$article: the article
342 &$pcache: whether to try the parser cache or not
343 &$outputDone: whether the output for this page finished or not
345 'ArticleUpdateBeforeRedirect': After a page is updated (usually on save), before the user is redirected back to the page
346 &$article: the article
347 &$sectionanchor: The section anchor link (e.g. "#overview" )
348 &$extraq: Extra query parameters which can be added via hooked functions
350 'AuthPluginSetup': update or replace authentication plugin object ($wgAuth)
351 Gives a chance for an extension to set it programattically to a variable class.
352 &$auth: the $wgAuth object, probably a stub
354 'AutoAuthenticate': called to authenticate users on external/environmental means
355 $user: writes user object to this parameter
357 'BadImage': When checking against the bad image list
358 $name: Image name being checked
359 &$bad: Whether or not the image is "bad"
361 Change $bad and return false to override. If an image is "bad", it is not
362 rendered inline in wiki pages or galleries in category pages.
364 'BeforeGalleryFindFile': before an image is fetched for a gallery
365 &$gallery,: the gallery object
366 &$nt: the image title
367 &$time: image timestamp
369 'BeforePageDisplay': Prior to outputting a page
370 $out: OutputPage object
372 'BeforeParserFetchTemplateAndtitle': before a template is fetched by Parser
373 &$parser: Parser object
374 &$title: title of the template
375 &$skip: skip this template and link it?
376 &$id: the id of the revision being parsed
378 'BeforeParserMakeImageLinkObj': before an image is rendered by Parser
379 &$parser: Parser object
380 &$nt: the image title
381 &$skip: skip this image and link it?
382 &$time: the image timestamp
384 'BeforeParserrenderImageGallery': before an image gallery is rendered by Parser
385 &$parser: Parser object
386 &$ig: ImageGallery object
388 'BlockIp': before an IP address or user is blocked
389 $block: the Block object about to be saved
390 $user: the user _doing_ the block (not the one being blocked)
392 'BlockIpComplete': after an IP address or user is blocked
393 $block: the Block object that was saved
394 $user: the user who did the block (not the one being blocked)
396 'BookInformation': Before information output on Special:Booksources
397 $isbn: ISBN to show information for
398 $output: OutputPage object in use
400 'CategoryPageView': before viewing a categorypage in CategoryPage::view
401 $catpage: CategoryPage instance
403 'ContributionsToolLinks': Change tool links above Special:Contributions
405 $title: User page title
406 &$tools: Array of tool links
408 'CustomEditor': When invoking the page editor
409 $article: Article being edited
410 $user: User performing the edit
412 Return true to allow the normal editor to be used, or false
413 if implementing a custom editor, e.g. for a special namespace,
416 'DiffViewHeader': called before diff display
417 $diff: DifferenceEngine object that's calling
418 $oldRev: Revision object of the "old" revision (may be null/invalid)
419 $newRev: Revision object of the "new" revision
421 'EditPage::attemptSave': called before an article is
422 saved, that is before insertNewArticle() is called
423 &$editpage_Obj: the current EditPage object
425 'EditFormPreloadText': Allows population of the edit form when creating new pages
426 &$text: Text to preload with
427 &$title: Title object representing the page being created
429 'EditPage::showEditForm:fields': allows injection of form field into edit form
430 &$editor: the EditPage instance for reference
431 &$out: an OutputPage instance to write to
432 return value is ignored (should always return true)
434 'EditFilter': Perform checks on an edit
435 $editor: Edit form (see includes/EditPage.php)
436 $text: Contents of the edit box
437 $section: Section being edited
438 &$error: Error message to return
440 Return false to halt editing; you'll need to handle error messages, etc. yourself.
441 Alternatively, modifying $error and returning true will cause the contents of $error
442 to be echoed at the top of the edit form as wikitext. Return true without altering
443 $error to allow the edit to proceed.
445 'EditSectionLink': Override the return value of Linker::editSectionLink()
446 $skin: Skin rendering the UI
447 $title: Title being linked to
448 $section: Section to link to
450 $result: Result (alter this to override the generated links)
452 'EditSectionLinkForOther': Override the return value of Linker::editSectionLinkForOther()
453 $skin: Skin rendering the UI
454 $title: Title being linked to
455 $section: Section to link to
456 $hint: Anchor title/tooltip attributes
458 $result: Result (alter this to override the generated links)
460 'EmailConfirmed': When checking that the user's email address is "confirmed"
461 $user: User being checked
462 $confirmed: Whether or not the email address is confirmed
463 This runs before the other checks, such as anonymity and the real check; return
464 true to allow those checks to occur, and false if checking is done.
466 'EmailUser': before sending email from one user to another
467 $to: address of receiving user
468 $from: address of sending user
469 $subject: subject of the mail
470 $text: text of the mail
472 'EmailUserComplete': after sending email from one user to another
473 $to: address of receiving user
474 $from: address of sending user
475 $subject: subject of the mail
476 $text: text of the mail
478 'FetchChangesList': When fetching the ChangesList derivative for a particular user
479 &$user: User the list is being fetched for
480 &$skin: Skin object to be used with the list
481 &$list: List object (defaults to NULL, change it to an object instance and return
482 false override the list derivative used)
484 'FileUpload': When a file upload occurs
485 $file : Image object representing the file that was uploaded
487 'GetInternalURL': modify fully-qualified URLs used for squid cache purging
488 $title: Title object of page
489 $url: string value as output (out parameter, can modify)
490 $query: query options passed to Title::getInternalURL()
492 'GetLocalURL': modify local URLs as output into page links
493 $title: Title object of page
494 $url: string value as output (out parameter, can modify)
495 $query: query options passed to Title::getLocalURL()
497 'GetFullURL': modify fully-qualified URLs used in redirects/export/offsite data
498 $title: Title object of page
499 $url: string value as output (out parameter, can modify)
500 $query: query options passed to Title::getFullURL()
502 'getUserPermissionsErrors': Add a permissions error when permissions errors are checked for.
503 Use instead of userCan for most cases. Return false if the user can't do it,
504 and populate $result with the reason in the form of array( messagename, param1, param2 )
505 $title: Title object being checked against
506 $user : Current user object
507 $action: Action being checked
508 $result: User permissions error to add. If none, return true.
510 'ImageOpenShowImageInlineBefore': Call potential extension just before showing the image on an image page
511 $imagePage: ImagePage object ($this)
514 'InitPreferencesForm': called at the end of PreferencesForm's constructor
515 $form: the PreferencesForm
516 $request: the web request to initialized from
518 'InternalParseBeforeLinks': during Parser's internalParse method before links but
519 after noinclude/includeonly/onlyinclude and other processing.
520 &$this: Parser object
521 &$text: string containing partially parsed text
522 &$this->mStripState: Parser's internal StripState object
524 'isValidEmailAddr': Override the result of User::isValidEmailAddr(), for ins-
525 tance to return false if the domain name doesn't match your organization
526 $addr: The e-mail address entered by the user
527 &$result: Set this and return false to override the internal checks
529 'isValidPassword': Override the result of User::isValidPassword()
530 $password: The password entered by the user
531 &$result: Set this and return false to override the internal checks
532 $user: User the password is being validated for
534 'LinksUpdateConstructed': At the end of LinksUpdate() is contruction.
535 &$linksUpdate: the LinkUpdate object
537 'LoginAuthenticateAudit': a login attempt for a valid user account either succeeded or failed.
538 No return data is accepted; this hook is for auditing only.
539 $user: the User object being authenticated against
540 $password: the password being submitted and found wanting
541 $retval: a LoginForm class constant with authenticateUserData() return value (SUCCESS, WRONG_PASS, etc)
543 'LogPageValidTypes': action being logged. DEPRECATED: Use $wgLogTypes
544 &$type: array of strings
546 'LogPageLogName': name of the logging page(s). DEPRECATED: Use $wgLogNames
547 &$typeText: array of strings
549 'LogPageLogHeader': strings used by wfMsg as a header. DEPRECATED: Use $wgLogHeaders
550 &$headerText: array of strings
552 'LogPageActionText': strings used by wfMsg as a header. DEPRECATED: Use $wgLogActions
553 &$actionText: array of strings
555 'MarkPatrolled': before an edit is marked patrolled
556 $rcid: ID of the revision to be marked patrolled
557 $user: the user (object) marking the revision as patrolled
558 $wcOnlySysopsCanPatrol: config setting indicating whether the user
559 needs to be a sysop in order to mark an edit patrolled
561 'MarkPatrolledComplete': after an edit is marked patrolled
562 $rcid: ID of the revision marked as patrolled
563 $user: user (object) who marked the edit patrolled
564 $wcOnlySysopsCanPatrol: config setting indicating whether the user
565 must be a sysop to patrol the edit
567 'MathAfterTexvc': after texvc is executed when rendering mathematics
568 $mathRenderer: instance of MathRenderer
569 $errmsg: error message, in HTML (string). Nonempty indicates failure
570 of rendering the formula
572 'OutputPageBeforeHTML': a page has been processed by the parser and
573 the resulting HTML is about to be displayed.
574 $parserOutput: the parserOutput (object) that corresponds to the page
575 $text: the text that will be displayed, in HTML (string)
577 'PageHistoryBeforeList': When a history page list is about to be constructed.
578 $article: the article that the history is loading for
580 'PageHistoryLineEnding' : right before the end <li> is added to a history line
581 $row: the revision row for this line
582 $s: the string representing this parsed line
584 'PageRenderingHash': alter the parser cache option hash key
585 A parser extension which depends on user options should install
586 this hook and append its values to the key.
587 $hash: reference to a hash key string which can be modified
589 'ParserTestTables': alter the list of tables to duplicate when parser tests
590 are run. Use when page save hooks require the presence of custom tables
591 to ensure that tests continue to run properly.
592 &$tables: array of table names
594 'PersonalUrls': Alter the user-specific navigation links (e.g. "my page,
595 my talk page, my contributions" etc).
597 &$personal_urls: Array of link specifiers (see SkinTemplate.php)
598 &$title: Title object representing the current page
600 'PingLimiter': Allows extensions to override the results of User::pingLimiter()
601 &$user : User performing the action
602 $action : Action being performed
603 &$result : Whether or not the action should be prevented
604 Change $result and return false to give a definitive answer, otherwise
605 the built-in rate limiting checks are used, if enabled.
607 'PreferencesUserInformationPanel': Add HTML bits to user information list in preferences form
608 $form : PreferencesForm object
609 &$html : HTML to append to
611 'RawPageViewBeforeOutput': Right before the text is blown out in action=raw
612 &$obj: RawPage object
613 &$text: The text that's going to be the output
615 'RenderPreferencesForm': called at the end of PreferencesForm::mainPrefsForm
616 $form: the PreferencesForm
617 $out: output page to render to, probably $wgOut
619 'ResetPreferences': called at the end of PreferencesForm::resetPrefs
620 $form: the PreferencesForm
621 $user: the User object to load preferences from
623 'SavePreferences': called at the end of PreferencesForm::savePreferences;
624 returning false prevents the preferences from being saved.
625 $form: the PreferencesForm
626 $user: the User object to save preferences to
627 $message: change this to set an error message (ignored if the hook does notreturn fals)
629 'SearchUpdate': Prior to search update completion
631 $namespace : Page namespace
633 $text : Current text being indexed
635 'ShowRawCssJs': Customise the output of raw CSS and JavaScript in page views
636 $text: Text being shown
637 $title: Title of the custom script/stylesheet page
638 $output: Current OutputPage object
640 'SiteNoticeBefore': Before the sitenotice/anonnotice is composed
641 &$siteNotice: HTML returned as the sitenotice
642 Return true to allow the normal method of notice selection/rendering to work,
643 or change the value of $siteNotice and return false to alter it.
645 'SiteNoticeAfter': After the sitenotice/anonnotice is composed
646 &$siteNotice: HTML sitenotice
647 Alter the contents of $siteNotice to add to/alter the sitenotice/anonnotice.
649 'SkinAfterBottomScripts': At the end of Skin::bottomScripts()
651 &$text: bottomScripts Text
652 Append to $text to add additional text/scripts after the stock bottom scripts.
654 'SkinTemplateContentActions': Alter the "content action" links in SkinTemplates
655 &$content_actions: Content actions
656 [See http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/examples/Content_action.php
659 'SkinTemplateOutputPageBeforeExec': Before SkinTemplate::outputPage() starts page output
660 &$sktemplate: SkinTemplate object
661 &$tpl: Template engine object
663 'SpecialContributionsBeforeMainOutput': Before the form on Special:Contributions
666 'TitleMoveComplete': after moving an article (title)
669 $user: user who did the move
670 $pageid: database ID of the page that's been moved
671 $redirid: database ID of the created redirect
673 'UnknownAction': An unknown "action" has occured (useful for defining
676 $article: article "acted on"
678 'UnwatchArticle': before a watch is removed from an article
680 $article: article object to be removed
682 'UnwatchArticle': after a watch is removed from an article
683 $user: user that was watching
684 $article: article object removed
686 'UnwatchArticleComplete': after a watch is removed from an article
687 $user: user that watched
688 $article: article object that was watched
690 'UploadForm:initial': before the upload form is generated
691 $form: UploadForm object
692 You might set the member-variables $uploadFormTextTop and
693 $uploadFormTextAfterSummary to inject text (HTML) either before
694 or after the editform.
696 'UploadForm:BeforeProcessing': at the beginning of processUpload()
697 $form: UploadForm object
698 Lets you poke at member variables like $mUploadDescription before the
701 'UploadVerification': additional chances to reject an uploaded file
702 string $saveName: destination file name
703 string $tempName: filesystem path to the temporary file for checks
704 string &$error: output: HTML error to show if upload canceled by returning false
706 'UploadComplete': Upon completion of a file upload
707 $image: Image object representing the file that was uploaded
709 'UserCan': To interrupt/advise the "user can do X to Y article" check.
710 If you want to display an error message, try getUserPermissionsErrors.
711 $title: Title object being checked against
712 $user : Current user object
713 $action: Action being checked
714 $result: Pointer to result returned if hook returns false. If null is returned,
715 UserCan checks are continued by internal code.
717 'UserCreateForm': change to manipulate the login form
718 $template: SimpleTemplate instance for the form
720 'UserLoginComplete': after a user has logged in
721 $user: the user object that was created on login
723 'UserLoginForm': change to manipulate the login form
724 $template: SimpleTemplate instance for the form
726 'UserLogout': before a user logs out
727 $user: the user object that is about to be logged out
729 'UserLogoutComplete': after a user has logged out
730 $user: the user object _after_ logout (won't have name, ID, etc.)
732 'UserRights': After a user's group memberships are changed
733 $user : User object that was changed
734 $add : Array of strings corresponding to groups added
735 $remove: Array of strings corresponding to groups removed
737 'UserGetImplicitGroups': Called in User::getImplicitGroups()
738 &$groups: List of implicit (automatically-assigned) groups
740 'UserGetRights': Called in User::getRights()
741 $user: User to get rights for
742 &$rights: Current rights
744 'UserEffectiveGroups': Called in User::getEffectiveGroups()
745 $user: User to get groups for
746 &$groups: Current effective groups
748 'WatchArticle': before a watch is added to an article
749 $user: user that will watch
750 $article: article object to be watched
752 'WatchArticleComplete': after a watch is added to an article
753 $user: user that watched
754 $article: article object watched
757 More hooks might be available but undocumented, you can execute
758 ./maintenance/findhooks.php to find hidden one.