Template:MediaWikiHook/fr

{{#switch: {{#ifeq:{{{templatemode|}}}|nocats| }} {{#if:{{{removed|}}} |{{Removed|{{{removed}}}|{{{removed-msg|}}}|newvarname={{{newvarname|}}}|newvarlink={{{newvarlink|}}}|name=}}} }} |{{#if:{{{deprecated|}}} |{{Deprecated|{{{deprecated}}}|{{{deprecated-msg|}}}|newvarname={{{newvarname|}}}|newvarlink={{{newvarlink|}}}|name={{#if:{{{name|}}}|{{{name}}}|{{#if:{{{deprecated-msg|{{#titleparts:{{PAGENAME}}|1|2}}}}}}} }} |   }}  }} }} Pour plus d'information sur l'ajout des accroches (hooks), voir Manuel:Accroches.
 * {{IfNotEn|

Pour des exemples d'extensions utilisant cette accroche, voir }}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}} extensions . }} {{Documentation|content=
 * #default=

Notes d'utilisation
{	"params": { "templatemode": { "description": "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.", "label": "Template mode" },		"name": { "description": "The name of the hook. This is usually the same name as the sub-page.", "label": "Name" },		"version": { "description": "The version of MediaWiki this hook was first introduced in.", "suggested": true, "label": "Version" },		"removed": { "description": "If the hook has been removed, the version of MediaWiki that it was removed in.", "type": "string", "label": "Version removed" },		"newvarname": { "label": "New variable name" },		"newvarlink": { "label": "New variable link" },		"deprecated": { "description": "If the hook has been deprecated (but not removed), the version of MediaWiki that it was deprecated in.", "label": "Version deprecated" },		"rev": { "description": "SVN revision in which this hook was first introduced. If this parameter is given, it'll link to the appropriate CodeReview page (e.g. Special:Code/MediaWiki/1).", "label": "SVN revision introduced" },		"gerrit": { "description": "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)", "suggested": true, "label": "Gerrit changeset" },		"summary": { "description": "A short description of the hook's purpose. More detailed descriptions are desirable, and should be added to the main page content.", "required": true, "label": "Summary" },		"args": { "description": "The arguments, as used at the top of the function.", "required": true, "label": "Arguments" },		"extension": { "label": "Extension" },		"source": { "description": "Location (file name/path not including ) which calls this hook in the code. Further locations can be added via source2...source10.", "suggested": true, "label": "File source" },		"source2": { "label": "File source 2" },		"source3": { "label": "File source 3" },		"source4": { "label": "File source 4" },		"source5": { "label": "File source 5" },		"source6": { "label": "File source 6" },		"source7": { "label": "File source 7" },		"source8": { "label": "File source 8" },		"source9": { "label": "File source 9" },		"source10": { "label": "File source 10" },		"sourcefunction": { "description": "Name of the function which calls this hook. Another can be added via sourcefunction2.", "suggested": true, "label": "Function source" },		"sourceclass": { "description": "Name of the class which calls this hook.", "suggested": true, "label": "Class source" },		"sourcefunction2": { "label": "Function source 2" }	},	"format": "block", "description": "A card which describes the information of a MediaWiki-registered hook.", "paramOrder": [ "templatemode", "name", "version", "removed", "newvarname", "newvarlink", "deprecated", "rev", "gerrit", "summary", "args", "extension", "source", "source2", "source3", "source4", "source5", "source6", "source7", "source8", "source9", "source10", "sourcefunction", "sourcefunction2", "sourceclass" ] }


 * name
 * Le nom de l'accoche. C'est habituellement le même nom que le nom de la sous-page.


 * version
 * La version de MediaWiki pour laquelle cette accroche a été introduite pour la première fois.


 * rev
 * La révision de SVN pour laquelle cette accroche a été introduite pour la première fois. Si ce paramètre est fourni, il pointera vers la page CodeReview concernée (par exemple Special:Code/MediaWiki/1).


 * gerrit
 * Numéro de modification Gerrit pour lequel cette accroche a été introduite pour la première fois. Si ce paramètre est fourni, il doit pointer vers la page du groupe de modifications approprié de Gerrit (par exemple Gerrit modification 1)


 * removed
 * Si l'accroche a été supprimée, la version de MediaWiki dans laquelle la suppression a eu lieu.


 * deprecated
 * Si l'accroche est obsolète, (mais n'a pas été supprimée), la version de MediaWiki dans laquelle l'obsolescence a été déclarée.


 * summary
 * Une brève description de ce que fait l'accroche.
 * Une description plus détaillée est souhaitable, et doit être ajoutée au contenu de la page principale.
 * Si vous mettez à jour la description courte, pensez également à mettre à jour les deux tables de.


 * args
 * Les arguments, tels qu'ils sont utilisés au début de la fonction.


 * source
 * Emplacement (nom de fichier) qui appelle cette accroche dans le code. D'autres emplacements peuvent être ajoutés via source2...source10.


 * sourcefunction
 * Nom de la fonction qui appelle cette accroche. On peut en ajouter une autre à travers la fonction source.


 * sourceclass
 * Nom de la classe qui appelle cette accroche.


 * templatemode
 * mettre à nocats si la documentation de l'accroche ne doit pas apparaître dans les catégories standard de MediaWiki.
 * Par défaut, l'utilisation de ce modèle place la page de documentation dans les catégories :
 * Accroches de MediaWiki
 * Accroches ajoutées dans MediaWiki...
 * Dans certains cas, il n'est pas souhaitable que la documentation de l'accroche soit automatiquement catégorisée. Des exemples seront inclus dans la documentation d'une accroche, ou pour la documentation du modèle lui-même.

Chercher la version d'une accroche et l'ID de Gerrit
Pour initialiser les attributs  et   de ce modèle, vous pourriez avoir besoin de chercher l'historique du fichier.


 * 1) (A partir de la racine d'un clone Git du code source de MediaWiki)
 * 2) Chercher la plus ancienne validation de   qui mentionne cette accroche :
 * 3) Trouver son ID Gerrit :
 * 4) Copier l'ID de la modification à partir de l'entrée du journal vers la boîte de recherche de Gerrit
 * 5) Sélectionnez la modification adéquate, et obtenez son ID
 * 6) Trouver dans quelle version l'accroche est apparue pour la première fois :
 * 1) Sélectionnez la modification adéquate, et obtenez son ID
 * 2) Trouver dans quelle version l'accroche est apparue pour la première fois :

}}