Šablóna:MediaWikiHook

This page is a translated version of the page Template:MediaWikiHook and the translation is 88% complete.
Template documentation

Skopírovánie šablóny a jej vloženie

MyHook
Dostupné od version ???

Definícia funkcie:
public static function onMyHook( $x, $y ) { ... }
Registriácia háku: V extension.json:
{
	"Hooks": {
		"MyHook": "MediaWiki\\Extension\\MyExtension\\Hooks::onMyHook"
	}
}
Volá sa z: Súbor(y):
Rozhranie: MyHookHook.php

Ďalšie informácie o háčkoch nájdete na stránke Manual:Hooks .
Na príklady rozšírení pomocou tohto háku pozri Category:MyHook extensions/sk.

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

Poznámky k použití

[view · talk · edit]

This is the TemplateData documentation for this template used by VisualEditor and other tools.

MediaWikiHook

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

Template parameters[Edit template data]

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
Template modetemplatemode

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.

Stringoptional
Namename

The name of the hook. This is usually the same name as the sub-page.

Stringoptional
Versionversion

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
Stringsuggested
Version removedremoved

If the hook has been removed, the version of MediaWiki that it was removed in.

Stringoptional
Message for removed hookremoved-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.

Stringoptional
Version deprecateddeprecated

If the hook has been deprecated (but not removed), the version of MediaWiki that it was deprecated in.

Stringoptional
Message for deprecated hookdeprecated-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.

Stringoptional
New variable namenewvarname

For removed or deprecated hooks, the name of the hook that should be used instead

Stringoptional
New variable linknewvarlink

For removed or deprecated hooks, the link to the hook that should be used instead

Page nameoptional
SVN revision introducedrev

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]]
URLoptional
Gerrit changesetgerrit

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)

Numbersuggested
Gerrit changeset removedgerritremoved

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)

Numberoptional
Summarysummary

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]].

Stringrequired
Argumentsargs

The arguments, as used at the top of the function.

Stringrequired
extensionextension

The extension which defines this hook.

Stringoptional
File source 1source

Location (file name/path not including <code>includes/</code>) which calls this hook in the code. Further locations can be added via source2...source10.

Filesuggested
File source 2source2

see source

Fileoptional
File source 3source3

see source

Fileoptional
File source 4source4

see source

Fileoptional
File source 5source5

see source

Fileoptional
File source 6source6

see source

Fileoptional
File source 7source7

see source

Fileoptional
File source 8source8

see source

Fileoptional
File source 9source9

see source

Fileoptional
File source 10source10

see source

Fileoptional
Function source 1sourcefunction

Name of the function which calls this hook. Another can be added via sourcefunction2.

Stringsuggested
Function source 2sourcefunction2

see sourcefunction

Stringoptional
Class sourcesourceclass

Name of the class which calls this hook.

Stringsuggested
nocatdescnocatdesc

If a hook is removed completely from MediaWiki version by setting yes, it will not show up the category description.

Stringoptional

Hledání verzie háčika a Gerrit ID

Ak chcete vyplniť atribúty version a gerrit tejto šablóny, možno budete musieť prehladať históriu súboru docs/hooks.txt.

  1. (Z najvyššej úrovne klonu zdrojového kódu MediaWiki)
  2. Nájdite najstaršiu zmenu k hooks.txt ktoré spomínajú háčok:
    • git grep <názov-háčku-tu> $(git rev-list --all -- docs/hooks.txt) -- docs/hooks.txt | tail -n 1
  3. Nájdite jeho Gerrit ID:
    • git log <zmena-z-hora>
    1. Skopírujte change-id zo záznamu do políčka vyhľadávania Gerrit
    2. Vyberte relevantnú zmenu a získajte jej ID
  4. Zistite, v ktorom uvoľnení bol háčok prvýkrát zahrnutý:
    • git tag --contains <zmena-z-hora>

Categories

The template automatically adds the page to the following categories:

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

and links to the following category:

  • Category:<hook name> extensions

When creating a new hook documentation page, you should create this categories if they don't exist yet. The first two can be left with an empty body; the third one should contain {{HookUsage|<name>}}.