Template:MediaWikiHook/nl

Template documentation

Kopieer en plak sjabloon

MyHook
Beschikbaar vanaf versie ???
Definieer functie:	public static function onMyHook( $x, $y ) { ... }
Voeg hook toe:	In extension.json: { "Hooks": { "MyHook": "MediaWiki\\Extension\\MyExtension\\Hooks::onMyHook" } }
Aangeroepen vanuit:	Bestand(en):
Interface:	MyHookHook.php

Voor meer informatie over het koppelen van hooks, zie Manual:Hooks .
Voor voorbeelden van uitbreidingen die gebruik maken van deze hook, zie Category:MyHook extensions/nl.

{{MediaWikiHook
|name = MyHook
|version =
|gerrit =
|gerritremoved =
|removed =
|summary =
|args = $x, $y
|source =
|sourcefunction =
|sourceclass =
|newvarname =
|newvarlink =
|nocatdesc =
}}

Gebruiksopmerkingen

Dit is de TemplateData documentatie van dit sjabloon dat gebruikt wordt door de VisualEditor en andere hulpmiddelen.

MediaWikiHook

A card which describes the information of a MediaWiki-registered hook.

Template parameters[Edit template data]

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
Template mode	templatemode	Set to nocats if hook documentation should not appear in standard MediaWiki Categories. By default, using this template places the documentation page into categories: MediaWiki hooks Hooks added in MediaWiki... There are times when it is undesirable to automatically categorize the hook documentation. Examples would include when documenting a hook in an extension, or when documenting the template itself.	String	optional
Name	name	The name of the hook. This is usually the same name as the sub-page.	String	optional
Version	version	The version of MediaWiki this hook was first introduced in. Should always be a full version number (ie. ending with ".0"). Example 1.35.0	String	suggested
Version removed	removed	If the hook has been removed, the version of MediaWiki that it was removed in.	String	optional
Message for removed hook	removed-msg	If it is not suitable to use either the "newvarname" or the "newvarlink" template parameter, use this parameter. This parameter can be used to explain why it was removed, or for example, explain why there is no suitable replacement.	String	optional
Version deprecated	deprecated	If the hook has been deprecated (but not removed), the version of MediaWiki that it was deprecated in.	String	optional
Message for deprecated hook	deprecated-msg	If it is not suitable to use either the "newvarname" or the "newvarlink" template parameter, use this parameter. This parameter can be used to explain why it was removed, or for example, explain why there is no suitable replacement.	String	optional
New variable name	newvarname	For removed or deprecated hooks, the name of the hook that should be used instead	String	optional
New variable link	newvarlink	For removed or deprecated hooks, the link to the hook that should be used instead	Page name	optional
SVN revision introduced	rev	SVN revision in which this hook was first introduced. If this parameter is given, it'll link to the appropriate CodeReview page (e.g. [[phabricator:rSVN1]]). Example [[phabricator:rSVN1]]	URL	optional
Gerrit changeset	gerrit	Gerrit change number in which this hook was first introduced. If this parameter is given, it'll link to the appropriate Gerrit changeset page (e.g. Gerrit change 1)	Number	suggested
Gerrit changeset removed	gerritremoved	Gerrit change number in which this hook was removed. If this parameter is given, it'll link to the appropriate Gerrit changeset page (e.g. Gerrit change 1)	Number	optional
Summary	summary	A short description of the hook's purpose. More detailed descriptions are desirable, and should be added to the main page content. If you update the short description, please also update the two tables on [[Special:MyLanguage/Manual:Hooks]].	String	required
Arguments	args	The arguments, as used at the top of the function.	String	required
extension	extension	The extension which defines this hook.	String	optional
File source 1	source	Location (file name/path not including <code>includes/</code>) which calls this hook in the code. Further locations can be added via source2...source10.	File	suggested
File source 2	source2	see source	File	optional
File source 3	source3	see source	File	optional
File source 4	source4	see source	File	optional
File source 5	source5	see source	File	optional
File source 6	source6	see source	File	optional
File source 7	source7	see source	File	optional
File source 8	source8	see source	File	optional
File source 9	source9	see source	File	optional
File source 10	source10	see source	File	optional
Function source 1	sourcefunction	Name of the function which calls this hook. Another can be added via sourcefunction2.	String	suggested
Function source 2	sourcefunction2	see sourcefunction	String	optional
Class source	sourceclass	Name of the class which calls this hook.	String	suggested
nocatdesc	nocatdesc	If a hook is removed completely from MediaWiki version by setting yes, it will not show up the category description.	String	optional

De versie van een hook vinden en Gerrit ID

Om de version en gerrit attributen van dit sjabloon te vullen, moet u mogelijk zoeken in de geschiedenis van het bestand docs/hooks.txt.

1. (Uit het bovenste niveau van een Git-clone van de MediaWiki broncode)
2. Zoek de oudste commit naar hooks.txt waar de hook genoemd wordt:
   • git grep <hook-name-here> $(git rev-list --all -- docs/hooks.txt) -- docs/hooks.txt | tail -n 1
3. Zoek de bijbehorende Gerrit ID:
   • git log <commit-from-above>
   1. Kopieer het change-id van de logregel in het zoekveld van Gerrit
   2. Selecteer de relevante wijziging, en haal het ID op
4. Zoek de release op waarin de hook voor het eerst in voorkomt:
   • git tag --contains <commit-from-above>

Categorieën

Het sjabloon voegt automatisch de pagina toe aan de volgende categorieën:

• Category:Hooks added in MediaWiki <version>
• Category:MediaWiki hooks included in <file>

en linkt naar de volgende categorie:

• Category:<hook name> extensions

Bij het maken van een nieuwe hook documentatie pagina, moet u deze categorieën maken als ze nog niet bestaan. De eerste twee kunnen met een lege pagina worden gemaakt; de derde moet {{HookUsage|<name>}} bevatten.

Editors can experiment in this template’s sandbox (create | mirror) and testcases (create) pages.
Subpages of this template.