Difference between revisions of "Template:Extension/doc"

From WPRDC Wiki
Jump to navigation Jump to search
>Egfrank~mediawikiwiki
(→‎Control parameters: clarification)
>Pppery
(Drop parameters that aren't supported from the TemplateData)
 
(312 intermediate revisions by more than 100 users not shown)
Line 1: Line 1:
== Purpose ==
<noinclude>{{Documentation subpage}}
This template should be added to the main page of all extensions documented on this wiki (and only the main page).  It will add a useful infobox using the information supplied (see below) and will automatically add the extension to [[:Category:All extensions]], plus the appropriate [[:Category:Extensions by status|status]] and [[:Category:Extensions by type|type]] categories.
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
 
</noinclude>== TemplateData ==
== Usage ==  
{{collapse top|title=TemplateData}}
{| width="100%"
{{TemplateData header|editlinks=1|docpage=Extension/doc}}
|-
<templatedata>
! width=40% |
{
! width=60% |
"description": "An infobox for a MediaWiki extension.",
|- valign="top"
"params": {
| align="left" |
"status": {
<span id="CutAndPaste">Cut and paste:</span>
"description": "Current release status. One of: unstable, experimental, beta, stable, unmaintained, unknown.",
<pre>{{Extension|templatemode =
"default": "unknown",
|name        =
"label": "Status",
|status     =
"type": "string",
|type        =
"example": "stable",
|author      =
"suggested": true
|username    =
},
|image      =
"name": {
|version    =
"description": "Name of the extension",
|update      =
"label": "Name",
|mediawiki  =
"type": "string",
|download    =
"default": "Current page name",
|readme      =
"suggested": true
|changelog  =
},
|description =
"license": {
|parameters  =
"description": "Extension's license.",
|rights      =
"label": "License",
|example    =
"type": "string",
}}</pre>
"suggested": true
 
},
For help with parameter values, see [[#Content parameters|below]].
"templatemode": {
 
"description": "Controls auto-categorization of host page. Normally left blank. Alternate values are: nocats, nousage.",
| align="right"|{{Extension|templatemode=nocats
"label": "Mode"
|name        = {{{name}}}
},
|status      = {{{status}}}
"image": {
|type        = {{{type}}}
"description": "Screenshot or logo of extension. It should be provided without namespace and without [[]]s.",
|author      = Sombebody
"label": "Screenshot or logo",
|username    = unknown
"example": "Example.jpg",
|image      = Placeholder.png
"type": "wiki-file-name",
|version    = {{{version}}}
"suggested": true
|update      = {{{update}}}
},
|mediawiki  = {{{mediawiki}}}
"imagesize": {
|license    = {{{license}}}}
"description": "Optional size of the image",
|download    = {{{download}}}
"label": "Image size",
|readme      = {{{readme}}}
"default": "220"
|changelog  = {{{changelog}}}
},
|description = {{{description}}}
"type": {
|parameters  = {{{parameters}}}
"description": "Implementation type. If more that one type is required, use \"Primary type\", \"Secondary type\", ... instead",
|rights      = {{{rights}}}
"label": "Type",
|example    = {{{example}}}
"type": "string",
}}
"suggested": true
|}
},
<br style="clear:both"/>
"type1": {
 
"description": "Implementation type. See detailed doc.",
== Content parameters ==
"label": "Primary type",
This section describes parameters that govern infobox content.  For help with '''templatemode''' and other control parameters, please see  ''{{SeeSection|Control parameters}}''.
"type": "string"
{|
},
|
"type2": {
{|border="1"
"description": "Implementation type. See detailed doc.",
|+ '''Content parameters'''
"label": "Secondary type"
|-
},
| '''name''' || '''name of the extension'''
"type3": {
|-
"description": "Implementation type. See detailed doc.",
| '''status''' || '''current release status'''
"label": "Third type",
One of:  
"type": "string"
* ''[[:Category:Unstable extensions|unstable]]'' (broken - do not use this extension)
},
* ''[[:Category:Experimental extensions|experimental]]'' (early stages of development, may change drastically.)
"type4": {
* ''[[:Category:Beta status extensions|beta]]'' (stable but not fully tested)
"description": "Implementation type. See detailed doc.",
* ''[[:Category:Stable extensions|stable]]'' (stable version)
"label": "Fourth type",
* ''[[:Category:Extensions with unknown status|unknown]]'' (default)
"type": "string"
If the status is anything other than the above, it will be ignored and the default value of 'Unknown' will be displayed in the template instead.  In cases where the value is omitted, it will be categorised as [[:category:extensions with unknown status|unknown]]. In cases where the value is invalid, it will be placed in a [[:category:extensions with invalid status|special category]] so that the error can be caught and fixed.
},
|-
"type5": {
| <span id="type">'''type1'''</span><br/>''type2''<br/>''type3''<br/>''type4''<br/>''type5''<br/>''type6''<br/> || '''type of extension'''
"description": "Implementation type. See detailed doc.",
Can contain any value, but the following special values ensure proper categorisation:
"label": "Fifth type",
* ''[[:Category:Category extensions|category]]'' - Category
"type": "string"
* ''[[:Category:Database extensions|database]]'' - adds tables and/or fields to the database backing a MediaWiki installation
},
* ''[[:Category:Database extensions|db]]'' - same as ''database''
"type6": {
* ''[[:Category:Data extraction extensions|data extraction]]'' - Data extraction
"description": "Implementation type. See detailed doc.",
* ''[[:Category:Extension examples|example]]'' - Not a real extension, but an example of how to write one
"label": "Sixth type",
* ''[[:Category:Extended syntax extensions|extended syntax]]'' - Extensions that add non-standard wiki syntax (i.e. <em>not</em> [[Manual:Tag extensions|tags]], [[Manual:Parser functions|parser functions]], or [[Manual:Variables|variables]]).
"type": "string"
* ''[[:Category:Form extensions|form]]'' - Form
},
* ''[[:Category:Hook extensions|hook]]'' - Hook extension - defines a <em>new</em> hook - see hook1, etc below if you want to define hooks <em>used</em> by your extension
"description": {
* ''[[:Category:User interface extensions|interface]]'' - User interface extension (e.g. [[w:javascript|javascript]] code)
"description": "Short description",
* ''[[:Category:Link markup extensions|link]]'' - Link markup extensions
"label": "Description",
* ''[[:Category:List extensions|list]]'' - List
"suggested": true
* ''[[:Category:Media handling extensions|media]]'' - Media
},
* ''[[:Category:Namespace extensions|namespace]]'' - Namespace
"author": {
* ''[[:Category:Parser extensions|parser]]'' - Parser extension (uncategorized)
"description": "The extension author's name, if different from their MediaWiki.org username. Free text. If omitted then the 'username' field will be used (if present).",
* ''[[:Category:Parser function extensions|parser function]]'' - Parser function
"label": "Author",
* ''[[:Category:Parser function extensions|pfunc]]'' - same as ''parser function''
"suggested": true
* ''[[:Category:Special page extensions|special]]'' - [[Manual:Special pages|Special page]]
},
* ''[[:Category:Table extensions|table]]'' - Table
"username": {
* ''[[:Category:Tag extensions|tag]]'' - [[Manual:Tag extensions|Tag extension]]
"description": "The author's username on MediaWiki.org (if they have one). May be omitted, but if present it will be used to link to the author's user & user_talk page. It should be provided without namespace and without [[]]s.",
* ''[[:Category:Variable extensions|variable]]'' - defines [[Manual:Variables|wiki variables]]
"label": "Username"
 
},
Any other value for 'type' is invalid, and will cause the extension to be placed in [[:Category:Extensions with invalid or missing type]].
"mediawiki": {
 
"description": "Required versions of MediaWiki. Not needed if this information is in extension.json.",
Note: Many extensions have more than one type, if this applies to yours,replace <code><nowiki>|type=</nowiki></code> with <code><nowiki>|type1=|type2=|type3=...</nowiki></code>.  You may define up to six types for an extension.
"label": "MediaWiki version",
|-
"example": ">= 1.35",
| <span id="type">'''hook1'''</span><br/>''hook2''<br/>''hook3''<br/>''hook4''<br/>''hook5''<br/>''hook6''<br/><span id="type">hook7</span><br/>''hook8''<br/>''hook9''<br/>''hook10''|| '''name of each hook used by the extension''' - please see [[Manual:Hooks]] and [[Extension hook registry]] for a list of valid values.
"type": "string",
|-
"deprecated": "This value will be read from extension.json where possible."
| author    || The extension author's name, if different from their MediaWiki.org username. Free text. If omitted then the 'username' field will be used (if present).
},
|-
"php": {
| username  || The author's username on MediaWiki.org (if they have one). May be omitted, but if present it will be used to link to the author's user & user_talk page.
"description": "Required version of PHP",
|-
"label": "PHP version",
| image      || screenshot (of base 270px)
"example": "5.4+",
|-
"type": "string"
| version    || last version
},
|-
"needs-updatephp": {
| update    || date of the last update
"description": "Yes indicates that the extension requires a database table schema change or a similar action, before the MediaWiki can run. It is a common pitfall: your MediaWiki will stall, if you forgot to run update.php - if the extension requires it. No should be set as a value since this assures that the extension does not need update.php to be run and thus avoids uncertainty.",
|-
"label": "Needs update.php",
| mediawiki  || required version of MediaWiki
"type": "boolean"
|-
},
| license    || license(s) governing use of this extension, e.g. GPL
"composer": {
|-
"description": "If applicable the name of the \"vendor\" as well as the \"package\" should be entered in the format vendor/package, e.g. mediawiki/semantic-media-wiki to point people directly to packagist.org, which serves as the package archive.",
| '''download''' || '''link to the download''' : [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ SVN] or other
"label": "Composer package name",
|-
"example": "mediawiki/semantic-media-wiki",
| readme    || link to the readme file : [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Sort/Sort README] or other
"type": "string"
|-
},
| changelog  || link to the changelog file : [http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Sort/Sort CHANGELOG] or other
"phabricator": {
|-
"example": "MediaWiki-extensions-Babel",
| '''description''' || '''short description'''
"type": "string",
|-
"suggested": true,
| parameters || available parameters for LocalSettings.php
"label": "Phabricator project name"
|-
},
| rights    || rights added by the extension. '''Not to be confused with the license!''' Rights are such as ''[[Extension:MakeBot|makebot]]'' or ''[[Extension:Desysop|desysop]]'', not such as GFDL or LGPL or GPL - those are licenses!
"table1": {
|-
"description": "Name of a non-core table used by the extension.",
| example    || example, website or screenshot of working extension
"label": "Non-core table 1",
|}
"type": "string"
 
},
== Control parameters ==
"table2": {
{| border="1"
"description": "Name of a non-core table used by the extension.",
|+ '''Control parameters'''
"label": "Non-core table 2",
|-
"type": "string"
| '''templatemode''' || '''Controls auto-categorization of host page.'''
},
 
"table3": {
Normally left blank.  Alternate values are:
"description": "Name of a non-core table used by the extension.",
* ''nocats'' - suppresses categorization. Use this value if you are adding this template to [[Help:Subpage|subpages]] of an extension or to how-to documentation of extensions. For example, the usage image above sets <code>templatemode=nocats</code>).
"label": "Non-core table 3",
 
"type": "string"
 
},
If this is left blank, this template will add the host page to [[:Category:All extensions]] and to one or more additional categories, depending on the values assigned to the {{SeeSection|Content parameters}}.
"table4": {
|}
"description": "Name of a non-core table used by the extension.",
 
"label": "Non-core table 4",
== Using the infobox ==
"type": "string"
=== Existing extension pages ===
},
If you want to add the infobox to an existing page, copy and paste the code at the [[#CutAndPaste|top of this page]].
"table5": {
 
"description": "Name of a non-core table used by the extension.",
=== Create a new extension article ===
"label": "Non-core table 5",
If you want to create a new extension page, enter the name below and click the button. A new page will be created with the infobox template already in place.
"type": "string"
 
},
{{Extension/CreateExtensionInputBox}}
"table6": {
"description": "Name of a non-core table used by the extension.",
"label": "Non-core table 6",
"type": "string"
},
"table7": {
"description": "Name of a non-core table used by the extension.",
"label": "Non-core table 7",
"type": "string"
},
"table8": {
"description": "Name of a non-core table used by the extension.",
"label": "Non-core table 8",
"type": "string"
},
"table9": {
"description": "Name of a non-core table used by the extension.",
"label": "Non-core table 9",
"type": "string"
},
"table10": {
"description": "Name of a non-core table used by the extension.",
"label": "Non-core table 10",
"type": "string"
},
"download": {
"description": "External link to download",
"label": "Download link",
"type": "url"
},
"readme": {
"description": "External link to the readme file",
"label": "README link",
"type": "url"
},
"changelog": {
"description": "External link to the changelog file",
"label": "Changelog link",
"type": "url"
},
"example": {
"description": "Example, website or screenshot of working extension",
"label": "Example"
},
"namespace": {
"description": "Namespace in which this extension is used",
"label": "Namespace"
},
"parameters": {
"description": "Available parameters for LocalSettings.php",
"label": "Parameters"
},
"tags": {
"description": "Any tags the extension uses",
"label": "Tags"
},
"rights": {
"description": "User rights added by the extension.",
"label": "Rights"
},
"hook1": {
"description": "Name of a hook used by the extension."
},
"hook2": {
"description": "Name of a hook used by the extension."
},
"hook3": {
"description": "Name of a hook used by the extension."
},
"hook4": {
"description": "Name of a hook used by the extension."
},
"hook5": {
"description": "Name of a hook used by the extension."
},
"hook6": {
"description": "Name of a hook used by the extension."
},
"hook7": {
"description": "Name of a hook used by the extension."
},
"hook8": {
"description": "Name of a hook used by the extension."
},
"hook9": {
"description": "Name of a hook used by the extension."
},
"hook10": {
"description": "Name of a hook used by the extension."
},
"hook11": {
"description": "Name of a hook used by the extension."
},
"hook12": {
"description": "Name of a hook used by the extension."
},
"hook13": {
"description": "Name of a hook used by the extension."
},
"hook14": {
"description": "Name of a hook used by the extension."
},
"hook15": {
"description": "Name of a hook used by the extension."
},
"hook16": {
"description": "Name of a hook used by the extension."
},
"hook17": {
"description": "Name of a hook used by the extension."
},
"hook18": {
"description": "Name of a hook used by the extension."
},
"hook19": {
"description": "Name of a hook used by the extension."
},
"hook20": {
"description": "Name of a hook used by the extension."
},
"hook21": {
"description": "Name of a hook used by the extension."
},
"hook22": {
"description": "Name of a hook used by the extension."
},
"hook23": {
"description": "Name of a hook used by the extension."
},
"hook24": {
"description": "Name of a hook used by the extension."
},
"hook25": {
"description": "Name of a hook used by the extension."
},
"hook26": {
"description": "Name of a hook used by the extension."
},
"hook27": {
"description": "Name of a hook used by the extension."
},
"hook28": {
"description": "Name of a hook used by the extension."
},
"hook29": {
"description": "Name of a hook used by the extension."
},
"hook30": {
"description": "Name of a hook used by the extension."
},
"hook31": {
"description": "Name of a hook used by the extension."
},
"hook32": {
"description": "Name of a hook used by the extension."
},
"hook33": {
"description": "Name of a hook used by the extension."
},
"hook34": {
"description": "Name of a hook used by the extension."
},
"hook35": {
"description": "Name of a hook used by the extension."
},
"hook36": {
"description": "Name of a hook used by the extension."
},
"hook37": {
"description": "Name of a hook used by the extension."
},
"hook38": {
"description": "Name of a hook used by the extension."
},
"hook39": {
"description": "Name of a hook used by the extension."
},
"hook40": {
"description": "Name of a hook used by the extension."
},
"hook41": {
"description": "Name of a hook used by the extension."
},
"hook42": {
"description": "Name of a hook used by the extension."
},
"hook43": {
"description": "Name of a hook used by the extension."
},
"hook44": {
"description": "Name of a hook used by the extension."
},
"hook45": {
"description": "Name of a hook used by the extension."
},
"hook46": {
"description": "Name of a hook used by the extension."
},
"hook47": {
"description": "Name of a hook used by the extension."
},
"hook48": {
"description": "Name of a hook used by the extension."
},
"hook49": {
"description": "Name of a hook used by the extension."
},
"hook50": {
"description": "Name of a hook used by the extension."
},
"hook51": {
"description": "Name of a hook used by the extension."
},
"hook52": {
"description": "Name of a hook used by the extension."
},
"hook53": {
"description": "Name of a hook used by the extension."
},
"hook54": {
"description": "Name of a hook used by the extension."
},
"hook55": {
"description": "Name of a hook used by the extension."
},
"hook56": {
"description": "Name of a hook used by the extension."
},
"hook57": {
"description": "Name of a hook used by the extension."
},
"hook58": {
"description": "Name of a hook used by the extension."
},
"hook59": {
"description": "Name of a hook used by the extension."
},
"hook60": {
"description": "Name of a hook used by the extension."
},
"hook61": {
"description": "Name of a hook used by the extension."
},
"hook62": {
"description": "Name of a hook used by the extension."
},
"hook63": {
"description": "Name of a hook used by the extension."
},
"hook64": {
"description": "Name of a hook used by the extension."
},
"hook65": {
"description": "Name of a hook used by the extension."
},
"hook66": {
"description": "Name of a hook used by the extension."
},
"hook67": {
"description": "Name of a hook used by the extension."
},
"hook68": {
"description": "Name of a hook used by the extension."
},
"hook69": {
"description": "Name of a hook used by the extension."
},
"hook70": {
"description": "Name of a hook used by the extension."
},
"hook71": {
"description": "Name of a hook used by the extension."
},
"hook72": {
"description": "Name of a hook used by the extension."
},
"hook73": {
"description": "Name of a hook used by the extension."
},
"hook74": {
"description": "Name of a hook used by the extension."
},
"hook75": {
"description": "Name of a hook used by the extension."
},
"hook76": {
"description": "Name of a hook used by the extension."
},
"hook77": {
"description": "Name of a hook used by the extension."
},
"hook78": {
"description": "Name of a hook used by the extension."
},
"hook79": {
"description": "Name of a hook used by the extension."
},
"hook80": {
"description": "Name of a hook used by the extension."
},
"hook81": {
"description": "Name of a hook used by the extension."
},
"hook82": {
"description": "Name of a hook used by the extension."
},
"hook83": {
"description": "Name of a hook used by the extension."
},
"hook84": {
"description": "Name of a hook used by the extension."
},
"hook85": {
"description": "Name of a hook used by the extension."
},
"hook86": {
"description": "Name of a hook used by the extension."
},
"hook87": {
"description": "Name of a hook used by the extension."
},
"hook88": {
"description": "Name of a hook used by the extension."
},
"hook89": {
"description": "Name of a hook used by the extension."
},
"hook90": {
"description": "Name of a hook used by the extension."
},
"newhook1": {
"description": "Name of a hook provided by the extension."
},
"newhook2": {
"description": "Name of a hook provided by the extension."
},
"newhook3": {
"description": "Name of a hook provided by the extension."
},
"newhook4": {
"description": "Name of a hook provided by the extension."
},
"newhook5": {
"description": "Name of a hook provided by the extension."
},
"newhook6": {
"description": "Name of a hook provided by the extension."
},
"newhook7": {
"description": "Name of a hook provided by the extension."
},
"newhook8": {
"description": "Name of a hook provided by the extension."
},
"newhook9": {
"description": "Name of a hook provided by the extension."
},
"newhook10": {
"description": "Name of a hook provided by the extension."
},
"newhook11": {
"description": "Name of a hook provided by the extension."
},
"newhook12": {
"description": "Name of a hook provided by the extension."
},
"newhook13": {
"description": "Name of a hook provided by the extension."
},
"newhook14": {
"description": "Name of a hook provided by the extension."
},
"newhook15": {
"description": "Name of a hook provided by the extension."
},
"newhook16": {
"description": "Name of a hook provided by the extension."
},
"newhook17": {
"description": "Name of a hook provided by the extension."
},
"newhook18": {
"description": "Name of a hook provided by the extension."
},
"newhook19": {
"description": "Name of a hook provided by the extension."
},
"newhook20": {
"description": "Name of a hook provided by the extension."
},
"newhook21": {
"description": "Name of a hook provided by the extension."
},
"newhook22": {
"description": "Name of a hook provided by the extension."
},
"newhook23": {
"description": "Name of a hook provided by the extension."
},
"newhook24": {
"description": "Name of a hook provided by the extension."
},
"newhook25": {
"description": "Name of a hook provided by the extension."
},
"newhook26": {
"description": "Name of a hook provided by the extension."
},
"newhook27": {
"description": "Name of a hook provided by the extension."
},
"newhook28": {
"description": "Name of a hook provided by the extension."
},
"newhook29": {
"description": "Name of a hook provided by the extension."
},
"newhook30": {
"description": "Name of a hook provided by the extension."
},
"newhook31": {
"description": "Name of a hook provided by the extension."
},
"newhook32": {
"description": "Name of a hook provided by the extension."
},
"newhook33": {
"description": "Name of a hook provided by the extension."
},
"newhook34": {
"description": "Name of a hook provided by the extension."
},
"newhook35": {
"description": "Name of a hook provided by the extension."
},
"newhook36": {
"description": "Name of a hook provided by the extension."
},
"newhook37": {
"description": "Name of a hook provided by the extension."
},
"newhook38": {
"description": "Name of a hook provided by the extension."
},
"newhook39": {
"description": "Name of a hook provided by the extension."
},
"newhook40": {
"description": "Name of a hook provided by the extension."
},
"newhook41": {
"description": "Name of a hook provided by the extension."
},
"newhook42": {
"description": "Name of a hook provided by the extension."
},
"newhook43": {
"description": "Name of a hook provided by the extension."
},
"newhook44": {
"description": "Name of a hook provided by the extension."
},
"newhook45": {
"description": "Name of a hook provided by the extension."
},
"newhook46": {
"description": "Name of a hook provided by the extension."
},
"newhook47": {
"description": "Name of a hook provided by the extension."
},
"newhook48": {
"description": "Name of a hook provided by the extension."
},
"newhook49": {
"description": "Name of a hook provided by the extension."
},
"newhook50": {
"description": "Name of a hook provided by the extension."
},
"newhook51": {
"description": "Name of a hook provided by the extension."
},
"newhook52": {
"description": "Name of a hook provided by the extension."
},
"newhook53": {
"description": "Name of a hook provided by the extension."
},
"newhook54": {
"description": "Name of a hook provided by the extension."
},
"newhook55": {
"description": "Name of a hook provided by the extension."
},
"newhook56": {
"description": "Name of a hook provided by the extension."
},
"newhook57": {
"description": "Name of a hook provided by the extension."
},
"newhook58": {
"description": "Name of a hook provided by the extension."
},
"newhook59": {
"description": "Name of a hook provided by the extension."
},
"newhook60": {
"description": "Name of a hook provided by the extension."
},
"newhook61": {
"description": "Name of a hook provided by the extension."
},
"newhook62": {
"description": "Name of a hook provided by the extension."
},
"newhook63": {
"description": "Name of a hook provided by the extension."
},
"newhook64": {
"description": "Name of a hook provided by the extension."
},
"newhook65": {
"description": "Name of a hook provided by the extension."
},
"newhook66": {
"description": "Name of a hook provided by the extension."
},
"newhook67": {
"description": "Name of a hook provided by the extension."
},
"newhook68": {
"description": "Name of a hook provided by the extension."
},
"newhook69": {
"description": "Name of a hook provided by the extension."
},
"newhook70": {
"description": "Name of a hook provided by the extension."
},
"newhook71": {
"description": "Name of a hook provided by the extension."
},
"newhook72": {
"description": "Name of a hook provided by the extension."
},
"newhook73": {
"description": "Name of a hook provided by the extension."
},
"newhook74": {
"description": "Name of a hook provided by the extension."
},
"newhook75": {
"description": "Name of a hook provided by the extension."
},
"newhook76": {
"description": "Name of a hook provided by the extension."
},
"newhook77": {
"description": "Name of a hook provided by the extension."
},
"newhook78": {
"description": "Name of a hook provided by the extension."
},
"newhook79": {
"description": "Name of a hook provided by the extension."
},
"newhook80": {
"description": "Name of a hook provided by the extension."
},
"newhook81": {
"description": "Name of a hook provided by the extension."
},
"newhook82": {
"description": "Name of a hook provided by the extension."
},
"newhook83": {
"description": "Name of a hook provided by the extension."
},
"newhook84": {
"description": "Name of a hook provided by the extension."
},
"newhook85": {
"description": "Name of a hook provided by the extension."
},
"newhook86": {
"description": "Name of a hook provided by the extension."
},
"newhook87": {
"description": "Name of a hook provided by the extension."
},
"newhook88": {
"description": "Name of a hook provided by the extension."
},
"newhook89": {
"description": "Name of a hook provided by the extension."
},
"newhook90": {
"description": "Name of a hook provided by the extension."
},
"compatibility": {
"label": "Compatibility chart",
"example": "{{Extension Testing | ... }}"
},
"translate": {
"description": "Optional parameter to link the exact page where (message group id with which) the extension will be translatable on translatewiki.net if enabled.",
"label": "TranslateWiki group",
"example": "ext-discussiontools",
"type": "string"
},
"bugzilla": {
"deprecated": true,
"label": "Bugzilla component name",
"type": "string"
},
"vagrant-role": {
"label": "Vagrant role",
"description": "A MediaWiki-Vagrant role that lets you use this extension",
"type": "string",
"example": "visualeditor"
},
"CheckUsageNameOverride": {
"label": "Check usage link",
"description": "Override the page name used for the check usage link."
},
"compatibility policy": {
"description": "For older versions of MediaWiki, should one use the extension's master branch or the REL1_XX branch corresponding to the MediaWiki version? Allowed values: master, rel, ltsrel",
"type": "string",
"suggested": true,
"label": "Compatibility policy"
},
"latest release date": {
"aliases": [
"update",
"latest_release_date"
],
"label": "Latest version release date",
"suggested": true
},
"latest preview version": {
"aliases": [
"version preview",
"latest_preview_version",
"version_preview"
],
"label": "Latest preview version"
},
"latest release version": {
"aliases": [
"version",
"latest_release_version"
],
"label": "Latest version",
"suggested": true
},
"latest preview date": {
"aliases": [
"update preview",
"latest_preview_date",
"update_preview"
],
"label": "Latest preview version update date"
},
"maintainer": {
"label": "Maintainer",
"description": "Username or other information about who maintains this extension.",
"type": "string"
}
},
"paramOrder": [
"name",
"status",
"license",
"templatemode",
"image",
"imagesize",
"type",
"type1",
"type2",
"type3",
"type4",
"type5",
"type6",
"description",
"author",
"username",
"maintainer",
"latest release version",
"latest release date",
"latest preview version",
"latest preview date",
"compatibility policy",
"mediawiki",
"php",
"needs-updatephp",
"composer",
"phabricator",
"table1",
"table2",
"table3",
"table4",
"table5",
"table6",
"table7",
"table8",
"table9",
"table10",
"download",
"readme",
"changelog",
"example",
"namespace",
"parameters",
"tags",
"rights",
"hook1",
"hook2",
"hook3",
"hook4",
"hook5",
"hook6",
"hook7",
"hook8",
"hook9",
"hook10",
"hook11",
"hook12",
"hook13",
"hook14",
"hook15",
"hook16",
"hook17",
"hook18",
"hook19",
"hook20",
"hook21",
"hook22",
"hook23",
"hook24",
"hook25",
"hook26",
"hook27",
"hook28",
"hook29",
"hook30",
"hook31",
"hook32",
"hook33",
"hook34",
"hook35",
"hook36",
"hook37",
"hook38",
"hook39",
"hook40",
"hook41",
"hook42",
"hook43",
"hook44",
"hook45",
"hook46",
"hook47",
"hook48",
"hook49",
"hook50",
"hook51",
"hook52",
"hook53",
"hook54",
"hook55",
"hook56",
"hook57",
"hook58",
"hook59",
"hook60",
"hook61",
"hook62",
"hook63",
"hook64",
"hook65",
"hook66",
"hook67",
"hook68",
"hook69",
"hook70",
"hook71",
"hook72",
"hook73",
"hook74",
"hook75",
"hook76",
"hook77",
"hook78",
"hook79",
"hook80",
"hook81",
"hook82",
"hook83",
"hook84",
"hook85",
"hook86",
"hook87",
"hook88",
"hook89",
"hook90",
"newhook1",
"newhook2",
"newhook3",
"newhook4",
"newhook5",
"newhook6",
"newhook7",
"newhook8",
"newhook9",
"newhook10",
"newhook11",
"newhook12",
"newhook13",
"newhook14",
"newhook15",
"newhook16",
"newhook17",
"newhook18",
"newhook19",
"newhook20",
"newhook21",
"newhook22",
"newhook23",
"newhook24",
"newhook25",
"newhook26",
"newhook27",
"newhook28",
"newhook29",
"newhook30",
"newhook31",
"newhook32",
"newhook33",
"newhook34",
"newhook35",
"newhook36",
"newhook37",
"newhook38",
"newhook39",
"newhook40",
"newhook41",
"newhook42",
"newhook43",
"newhook44",
"newhook45",
"newhook46",
"newhook47",
"newhook48",
"newhook49",
"newhook50",
"newhook51",
"newhook52",
"newhook53",
"newhook54",
"newhook55",
"newhook56",
"newhook57",
"newhook58",
"newhook59",
"newhook60",
"newhook61",
"newhook62",
"newhook63",
"newhook64",
"newhook65",
"newhook66",
"newhook67",
"newhook68",
"newhook69",
"newhook70",
"newhook71",
"newhook72",
"newhook73",
"newhook74",
"newhook75",
"newhook76",
"newhook77",
"newhook78",
"newhook79",
"newhook80",
"newhook81",
"newhook82",
"newhook83",
"newhook84",
"newhook85",
"newhook86",
"newhook87",
"newhook88",
"newhook89",
"newhook90",
"compatibility",
"translate",
"vagrant-role",
"CheckUsageNameOverride",
"bugzilla"
]
}</templatedata>
{{collapse bottom}}
<includeonly>{{Sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Info templates{{#translation:}}]]
[[Category:Extension creation{{#translation:}}]]
[[Category:Categorizing templates{{#translation:}}]]
[[Category:Extension templates{{#translation:}}]]
}}</includeonly>

Latest revision as of 23:55, 20 October 2021

Template:Documentation subpage

TemplateData

TemplateData

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

Extension

[[Category:TemplateData documentation{{#translation:}}]]

An infobox for a MediaWiki extension.

Template parameters

ParameterDescriptionTypeStatus
Namename

Name of the extension

Default
Current page name
Stringsuggested
Statusstatus

Current release status. One of: unstable, experimental, beta, stable, unmaintained, unknown.

Default
unknown
Example
stable
Stringsuggested
Licenselicense

Extension's license.

Stringsuggested
Modetemplatemode

Controls auto-categorization of host page. Normally left blank. Alternate values are: nocats, nousage.

Unknownoptional
Screenshot or logoimage

Screenshot or logo of extension. It should be provided without namespace and without [[]]s.

Example
Example.jpg
Filesuggested
Image sizeimagesize

Optional size of the image

Default
220
Unknownoptional
Typetype

Implementation type. If more that one type is required, use "Primary type", "Secondary type", ... instead

Stringsuggested
Primary typetype1

Implementation type. See detailed doc.

Stringoptional
Secondary typetype2

Implementation type. See detailed doc.

Unknownoptional
Third typetype3

Implementation type. See detailed doc.

Stringoptional
Fourth typetype4

Implementation type. See detailed doc.

Stringoptional
Fifth typetype5

Implementation type. See detailed doc.

Stringoptional
Sixth typetype6

Implementation type. See detailed doc.

Stringoptional
Descriptiondescription

Short description

Unknownsuggested
Authorauthor

The extension author's name, if different from their MediaWiki.org username. Free text. If omitted then the 'username' field will be used (if present).

Unknownsuggested
Usernameusername

The author's username on MediaWiki.org (if they have one). May be omitted, but if present it will be used to link to the author's user & user_talk page. It should be provided without namespace and without [[]]s.

Unknownoptional
Maintainermaintainer

Username or other information about who maintains this extension.

Stringoptional
Latest versionlatest release version version latest_release_version

no description

Unknownsuggested
Latest version release datelatest release date update latest_release_date

no description

Unknownsuggested
Latest preview versionlatest preview version version preview latest_preview_version version_preview

no description

Unknownoptional
Latest preview version update datelatest preview date update preview latest_preview_date update_preview

no description

Unknownoptional
Compatibility policycompatibility policy

For older versions of MediaWiki, should one use the extension's master branch or the REL1_XX branch corresponding to the MediaWiki version? Allowed values: master, rel, ltsrel

Stringsuggested
MediaWiki versionmediawiki

Required versions of MediaWiki. Not needed if this information is in extension.json.

Example
>= 1.35
Stringdeprecated
PHP versionphp

Required version of PHP

Example
5.4+
Stringoptional
Needs update.phpneeds-updatephp

Yes indicates that the extension requires a database table schema change or a similar action, before the MediaWiki can run. It is a common pitfall: your MediaWiki will stall, if you forgot to run update.php - if the extension requires it. No should be set as a value since this assures that the extension does not need update.php to be run and thus avoids uncertainty.

Booleanoptional
Composer package namecomposer

If applicable the name of the "vendor" as well as the "package" should be entered in the format vendor/package, e.g. mediawiki/semantic-media-wiki to point people directly to packagist.org, which serves as the package archive.

Example
mediawiki/semantic-media-wiki
Stringoptional
Phabricator project namephabricator

no description

Example
MediaWiki-extensions-Babel
Stringsuggested
Non-core table 1table1

Name of a non-core table used by the extension.

Stringoptional
Non-core table 2table2

Name of a non-core table used by the extension.

Stringoptional
Non-core table 3table3

Name of a non-core table used by the extension.

Stringoptional
Non-core table 4table4

Name of a non-core table used by the extension.

Stringoptional
Non-core table 5table5

Name of a non-core table used by the extension.

Stringoptional
Non-core table 6table6

Name of a non-core table used by the extension.

Stringoptional
Non-core table 7table7

Name of a non-core table used by the extension.

Stringoptional
Non-core table 8table8

Name of a non-core table used by the extension.

Stringoptional
Non-core table 9table9

Name of a non-core table used by the extension.

Stringoptional
Non-core table 10table10

Name of a non-core table used by the extension.

Stringoptional
Download linkdownload

External link to download

URLoptional
README linkreadme

External link to the readme file

URLoptional
Changelog linkchangelog

External link to the changelog file

URLoptional
Exampleexample

Example, website or screenshot of working extension

Unknownoptional
Namespacenamespace

Namespace in which this extension is used

Unknownoptional
Parametersparameters

Available parameters for LocalSettings.php

Unknownoptional
Tagstags

Any tags the extension uses

Unknownoptional
Rightsrights

User rights added by the extension.

Unknownoptional
hook1hook1

Name of a hook used by the extension.

Unknownoptional
hook2hook2

Name of a hook used by the extension.

Unknownoptional
hook3hook3

Name of a hook used by the extension.

Unknownoptional
hook4hook4

Name of a hook used by the extension.

Unknownoptional
hook5hook5

Name of a hook used by the extension.

Unknownoptional
hook6hook6

Name of a hook used by the extension.

Unknownoptional
hook7hook7

Name of a hook used by the extension.

Unknownoptional
hook8hook8

Name of a hook used by the extension.

Unknownoptional
hook9hook9

Name of a hook used by the extension.

Unknownoptional
hook10hook10

Name of a hook used by the extension.

Unknownoptional
hook11hook11

Name of a hook used by the extension.

Unknownoptional
hook12hook12

Name of a hook used by the extension.

Unknownoptional
hook13hook13

Name of a hook used by the extension.

Unknownoptional
hook14hook14

Name of a hook used by the extension.

Unknownoptional
hook15hook15

Name of a hook used by the extension.

Unknownoptional
hook16hook16

Name of a hook used by the extension.

Unknownoptional
hook17hook17

Name of a hook used by the extension.

Unknownoptional
hook18hook18

Name of a hook used by the extension.

Unknownoptional
hook19hook19

Name of a hook used by the extension.

Unknownoptional
hook20hook20

Name of a hook used by the extension.

Unknownoptional
hook21hook21

Name of a hook used by the extension.

Unknownoptional
hook22hook22

Name of a hook used by the extension.

Unknownoptional
hook23hook23

Name of a hook used by the extension.

Unknownoptional
hook24hook24

Name of a hook used by the extension.

Unknownoptional
hook25hook25

Name of a hook used by the extension.

Unknownoptional
hook26hook26

Name of a hook used by the extension.

Unknownoptional
hook27hook27

Name of a hook used by the extension.

Unknownoptional
hook28hook28

Name of a hook used by the extension.

Unknownoptional
hook29hook29

Name of a hook used by the extension.

Unknownoptional
hook30hook30

Name of a hook used by the extension.

Unknownoptional
hook31hook31

Name of a hook used by the extension.

Unknownoptional
hook32hook32

Name of a hook used by the extension.

Unknownoptional
hook33hook33

Name of a hook used by the extension.

Unknownoptional
hook34hook34

Name of a hook used by the extension.

Unknownoptional
hook35hook35

Name of a hook used by the extension.

Unknownoptional
hook36hook36

Name of a hook used by the extension.

Unknownoptional
hook37hook37

Name of a hook used by the extension.

Unknownoptional
hook38hook38

Name of a hook used by the extension.

Unknownoptional
hook39hook39

Name of a hook used by the extension.

Unknownoptional
hook40hook40

Name of a hook used by the extension.

Unknownoptional
hook41hook41

Name of a hook used by the extension.

Unknownoptional
hook42hook42

Name of a hook used by the extension.

Unknownoptional
hook43hook43

Name of a hook used by the extension.

Unknownoptional
hook44hook44

Name of a hook used by the extension.

Unknownoptional
hook45hook45

Name of a hook used by the extension.

Unknownoptional
hook46hook46

Name of a hook used by the extension.

Unknownoptional
hook47hook47

Name of a hook used by the extension.

Unknownoptional
hook48hook48

Name of a hook used by the extension.

Unknownoptional
hook49hook49

Name of a hook used by the extension.

Unknownoptional
hook50hook50

Name of a hook used by the extension.

Unknownoptional
hook51hook51

Name of a hook used by the extension.

Unknownoptional
hook52hook52

Name of a hook used by the extension.

Unknownoptional
hook53hook53

Name of a hook used by the extension.

Unknownoptional
hook54hook54

Name of a hook used by the extension.

Unknownoptional
hook55hook55

Name of a hook used by the extension.

Unknownoptional
hook56hook56

Name of a hook used by the extension.

Unknownoptional
hook57hook57

Name of a hook used by the extension.

Unknownoptional
hook58hook58

Name of a hook used by the extension.

Unknownoptional
hook59hook59

Name of a hook used by the extension.

Unknownoptional
hook60hook60

Name of a hook used by the extension.

Unknownoptional
hook61hook61

Name of a hook used by the extension.

Unknownoptional
hook62hook62

Name of a hook used by the extension.

Unknownoptional
hook63hook63

Name of a hook used by the extension.

Unknownoptional
hook64hook64

Name of a hook used by the extension.

Unknownoptional
hook65hook65

Name of a hook used by the extension.

Unknownoptional
hook66hook66

Name of a hook used by the extension.

Unknownoptional
hook67hook67

Name of a hook used by the extension.

Unknownoptional
hook68hook68

Name of a hook used by the extension.

Unknownoptional
hook69hook69

Name of a hook used by the extension.

Unknownoptional
hook70hook70

Name of a hook used by the extension.

Unknownoptional
hook71hook71

Name of a hook used by the extension.

Unknownoptional
hook72hook72

Name of a hook used by the extension.

Unknownoptional
hook73hook73

Name of a hook used by the extension.

Unknownoptional
hook74hook74

Name of a hook used by the extension.

Unknownoptional
hook75hook75

Name of a hook used by the extension.

Unknownoptional
hook76hook76

Name of a hook used by the extension.

Unknownoptional
hook77hook77

Name of a hook used by the extension.

Unknownoptional
hook78hook78

Name of a hook used by the extension.

Unknownoptional
hook79hook79

Name of a hook used by the extension.

Unknownoptional
hook80hook80

Name of a hook used by the extension.

Unknownoptional
hook81hook81

Name of a hook used by the extension.

Unknownoptional
hook82hook82

Name of a hook used by the extension.

Unknownoptional
hook83hook83

Name of a hook used by the extension.

Unknownoptional
hook84hook84

Name of a hook used by the extension.

Unknownoptional
hook85hook85

Name of a hook used by the extension.

Unknownoptional
hook86hook86

Name of a hook used by the extension.

Unknownoptional
hook87hook87

Name of a hook used by the extension.

Unknownoptional
hook88hook88

Name of a hook used by the extension.

Unknownoptional
hook89hook89

Name of a hook used by the extension.

Unknownoptional
hook90hook90

Name of a hook used by the extension.

Unknownoptional
newhook1newhook1

Name of a hook provided by the extension.

Unknownoptional
newhook2newhook2

Name of a hook provided by the extension.

Unknownoptional
newhook3newhook3

Name of a hook provided by the extension.

Unknownoptional
newhook4newhook4

Name of a hook provided by the extension.

Unknownoptional
newhook5newhook5

Name of a hook provided by the extension.

Unknownoptional
newhook6newhook6

Name of a hook provided by the extension.

Unknownoptional
newhook7newhook7

Name of a hook provided by the extension.

Unknownoptional
newhook8newhook8

Name of a hook provided by the extension.

Unknownoptional
newhook9newhook9

Name of a hook provided by the extension.

Unknownoptional
newhook10newhook10

Name of a hook provided by the extension.

Unknownoptional
newhook11newhook11

Name of a hook provided by the extension.

Unknownoptional
newhook12newhook12

Name of a hook provided by the extension.

Unknownoptional
newhook13newhook13

Name of a hook provided by the extension.

Unknownoptional
newhook14newhook14

Name of a hook provided by the extension.

Unknownoptional
newhook15newhook15

Name of a hook provided by the extension.

Unknownoptional
newhook16newhook16

Name of a hook provided by the extension.

Unknownoptional
newhook17newhook17

Name of a hook provided by the extension.

Unknownoptional
newhook18newhook18

Name of a hook provided by the extension.

Unknownoptional
newhook19newhook19

Name of a hook provided by the extension.

Unknownoptional
newhook20newhook20

Name of a hook provided by the extension.

Unknownoptional
newhook21newhook21

Name of a hook provided by the extension.

Unknownoptional
newhook22newhook22

Name of a hook provided by the extension.

Unknownoptional
newhook23newhook23

Name of a hook provided by the extension.

Unknownoptional
newhook24newhook24

Name of a hook provided by the extension.

Unknownoptional
newhook25newhook25

Name of a hook provided by the extension.

Unknownoptional
newhook26newhook26

Name of a hook provided by the extension.

Unknownoptional
newhook27newhook27

Name of a hook provided by the extension.

Unknownoptional
newhook28newhook28

Name of a hook provided by the extension.

Unknownoptional
newhook29newhook29

Name of a hook provided by the extension.

Unknownoptional
newhook30newhook30

Name of a hook provided by the extension.

Unknownoptional
newhook31newhook31

Name of a hook provided by the extension.

Unknownoptional
newhook32newhook32

Name of a hook provided by the extension.

Unknownoptional
newhook33newhook33

Name of a hook provided by the extension.

Unknownoptional
newhook34newhook34

Name of a hook provided by the extension.

Unknownoptional
newhook35newhook35

Name of a hook provided by the extension.

Unknownoptional
newhook36newhook36

Name of a hook provided by the extension.

Unknownoptional
newhook37newhook37

Name of a hook provided by the extension.

Unknownoptional
newhook38newhook38

Name of a hook provided by the extension.

Unknownoptional
newhook39newhook39

Name of a hook provided by the extension.

Unknownoptional
newhook40newhook40

Name of a hook provided by the extension.

Unknownoptional
newhook41newhook41

Name of a hook provided by the extension.

Unknownoptional
newhook42newhook42

Name of a hook provided by the extension.

Unknownoptional
newhook43newhook43

Name of a hook provided by the extension.

Unknownoptional
newhook44newhook44

Name of a hook provided by the extension.

Unknownoptional
newhook45newhook45

Name of a hook provided by the extension.

Unknownoptional
newhook46newhook46

Name of a hook provided by the extension.

Unknownoptional
newhook47newhook47

Name of a hook provided by the extension.

Unknownoptional
newhook48newhook48

Name of a hook provided by the extension.

Unknownoptional
newhook49newhook49

Name of a hook provided by the extension.

Unknownoptional
newhook50newhook50

Name of a hook provided by the extension.

Unknownoptional
newhook51newhook51

Name of a hook provided by the extension.

Unknownoptional
newhook52newhook52

Name of a hook provided by the extension.

Unknownoptional
newhook53newhook53

Name of a hook provided by the extension.

Unknownoptional
newhook54newhook54

Name of a hook provided by the extension.

Unknownoptional
newhook55newhook55

Name of a hook provided by the extension.

Unknownoptional
newhook56newhook56

Name of a hook provided by the extension.

Unknownoptional
newhook57newhook57

Name of a hook provided by the extension.

Unknownoptional
newhook58newhook58

Name of a hook provided by the extension.

Unknownoptional
newhook59newhook59

Name of a hook provided by the extension.

Unknownoptional
newhook60newhook60

Name of a hook provided by the extension.

Unknownoptional
newhook61newhook61

Name of a hook provided by the extension.

Unknownoptional
newhook62newhook62

Name of a hook provided by the extension.

Unknownoptional
newhook63newhook63

Name of a hook provided by the extension.

Unknownoptional
newhook64newhook64

Name of a hook provided by the extension.

Unknownoptional
newhook65newhook65

Name of a hook provided by the extension.

Unknownoptional
newhook66newhook66

Name of a hook provided by the extension.

Unknownoptional
newhook67newhook67

Name of a hook provided by the extension.

Unknownoptional
newhook68newhook68

Name of a hook provided by the extension.

Unknownoptional
newhook69newhook69

Name of a hook provided by the extension.

Unknownoptional
newhook70newhook70

Name of a hook provided by the extension.

Unknownoptional
newhook71newhook71

Name of a hook provided by the extension.

Unknownoptional
newhook72newhook72

Name of a hook provided by the extension.

Unknownoptional
newhook73newhook73

Name of a hook provided by the extension.

Unknownoptional
newhook74newhook74

Name of a hook provided by the extension.

Unknownoptional
newhook75newhook75

Name of a hook provided by the extension.

Unknownoptional
newhook76newhook76

Name of a hook provided by the extension.

Unknownoptional
newhook77newhook77

Name of a hook provided by the extension.

Unknownoptional
newhook78newhook78

Name of a hook provided by the extension.

Unknownoptional
newhook79newhook79

Name of a hook provided by the extension.

Unknownoptional
newhook80newhook80

Name of a hook provided by the extension.

Unknownoptional
newhook81newhook81

Name of a hook provided by the extension.

Unknownoptional
newhook82newhook82

Name of a hook provided by the extension.

Unknownoptional
newhook83newhook83

Name of a hook provided by the extension.

Unknownoptional
newhook84newhook84

Name of a hook provided by the extension.

Unknownoptional
newhook85newhook85

Name of a hook provided by the extension.

Unknownoptional
newhook86newhook86

Name of a hook provided by the extension.

Unknownoptional
newhook87newhook87

Name of a hook provided by the extension.

Unknownoptional
newhook88newhook88

Name of a hook provided by the extension.

Unknownoptional
newhook89newhook89

Name of a hook provided by the extension.

Unknownoptional
newhook90newhook90

Name of a hook provided by the extension.

Unknownoptional
Compatibility chartcompatibility

no description

Example
{{Extension Testing | ... }}
Unknownoptional
TranslateWiki grouptranslate

Optional parameter to link the exact page where (message group id with which) the extension will be translatable on translatewiki.net if enabled.

Example
ext-discussiontools
Stringoptional
Vagrant rolevagrant-role

A MediaWiki-Vagrant role that lets you use this extension

Example
visualeditor
Stringoptional
Check usage linkCheckUsageNameOverride

Override the page name used for the check usage link.

Unknownoptional
Bugzilla component namebugzilla

no description

Stringdeprecated