Difference between revisions of "Template:Extension/doc"

Jump to navigation Jump to search
>Mainframe98
(Undo revision 2293358 by 198.223.227.19 (talk))
Line 29: Line 29:
|version        =  
|version        =  
|update          =  
|update          =  
|version preview =
|update preview  =
|mediawiki      =
|php            =
|needs-updatephp =
|composer        =
|table1          =
|table2          =
|license        =
|download        =
|readme          =
|changelog      =
|example        =
|namespace      =
|parameters      =
|tags            =
|rights          =
|compatibility  =
|bugzilla        =
|phabricator    =
|vagrant-role    =
}}</pre>


For help with parameter values, see [[#Content parameters|below]].
| align="right"|{{ {{TNTN|Extension}} |templatemode=nocats
|name            = {{{name}}}
|status          = {{{status}}}
|type1          = {{{type1}}}
|type2          = {{{type2}}}
|hook1          = hook1
|hook2          = hook2
|newhook1        = newhook1
|newhook1        = newhook1
|newhook2        = newhook2
|newhook2        = newhook2
Line 46: Line 77:
|table2          = {{{table2}}}
|table2          = {{{table2}}}
|license        = {{{license}}}
|license        = {{{license}}}
|download        =
|download        = {{{download}}}
|readme          = {{{readme}}}
|changelog      = {{{changelog}}}
|example        = {{{example}}}
|namespace      = {{{namespace}}}
|description    = {{{description}}}
|parameters      = {{{parameters}}}
|tags            = {{{tags}}}
|rights          = {{{rights}}}
|compatibility  = {{{compatibility}}}
|bugzilla        = {{{bugzilla}}}
|phabricator    = {{{phabricator}}}
|vagrant-role    = {{{vagrant-role}}} 
|pagedrive1      = true
|demo            = true
}}
|}
<br style="clear:both"/>
 
== Content parameters ==


This section describes parameters that govern infobox content. For help with '''templatemode''' and other control parameters, please see ''[[#Control parameters|Control parameters]]''.
This section describes parameters that govern infobox content. For help with '''templatemode''' and other control parameters, please see ''[[#Control parameters|Control parameters]]''.
Line 55: Line 105:
     If you change an id, please update the code in Template:Extension accordingly.
     If you change an id, please update the code in Template:Extension accordingly.
-->   
-->   
{| class="wikitable"
|+ '''Content parameters'''
|+ '''Content parameters'''
|-
|-
! Parameter
! Parameter
! Description'</span> || '''name of the extension'':Unstable extensions{{translation}}|unstable]]'' (broken - do not use this extension)
! Description
|-
|<span id="name">'''name'''</span> || '''name of the extension'''
|-
|<span id="status">'''status'''</span> || '''current release status'''
One of:
* ''[[:Category:Unstable extensions{{translation}}|unstable]]'' (broken - do not use this extension)
* ''[[:Category:Experimental extensions{{translation}}|experimental]]'' (early stages of development, may change drastically)
* ''[[:Category:Experimental extensions{{translation}}|experimental]]'' (early stages of development, may change drastically)
* ''[[:Category:Beta status extensions{{translation}}|beta]]'' (stable but not extensions{{translation}}|stable]]'' (stable version)
* ''[[:Category:Beta status extensions{{translation}}|beta]]'' (stable but not fully tested)
* ''[[:Category:Not LTS ready{{translation}}|unmaintained]]'' (unmaintained - previously claimed to be stable, now unmaintai:Archive extensions{{translation}}|arunknown status{{translation}}|unknown]]'' (default)
* ''[[:Category:Stable extensions{{translation}}|stable]]'' (stable version)
* ''[[:Category:Not LTS ready{{translation}}|unmaintained]]'' (unmaintained - previously claimed to be stable, now unmaintained)
* ''[[:Category:Archive extensions{{translation}}|archive]]'' (archived - deprecated or merged with another extension)
* ''[[:Category:Extensions with unknown status{{translation}}|unknown]]'' (default)
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 categorized 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.
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 categorized 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.
* [[Extension status|release status colour scheme]]
* [[Extension status|release status colour scheme]]
|-
|-
| '''type1'''<br/>''type2''<br/>''type3''<br/>''type4''<br/>''type5''<br/>''type6''<br/> || <span id="type">'''implementation type
| '''type1'''<br/>''type2''<br/>''type3''<br/>''type4''<br/>''type5''<br/>''type6''<br/> || <span id="type">'''implementation type'''</span><!-- id here so at top of documentation -->


The  implementation strategy(s) employed in building this extension. This parameter is used to create categories that help programmers find examples of various MediaWiki specific implementation strategies or patterns. Although the values of this parameter sometimes coincide with the use case or purpose of an extension, that is not reason for this parameter. If the values you have chosen for this parameter do not adequately identify the [[w:Requirements|purpose]] or possible [[w:Use case|use case]]s, we recommend you add additional [[Help:Categories|category links]] as needed.
The  implementation strategy(s) employed in building this extension. This parameter is used to create categories that help programmers find examples of various MediaWiki specific implementation strategies or patterns. Although the values of this parameter sometimes coincide with the use case or purpose of an extension, that is not reason for this parameter. If the values you have chosen for this parameter do not adequately identify the [[w:Requirements|purpose]] or possible [[w:Use case|use case]]s, we recommend you add additional [[Help:Categories|category links]] as needed.
Line 417: Line 477:
"hook3": {
"hook3": {
"description": "Name of a hook used by the extension."
"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."
"description": "Name of a hook used by the extension."
},
"hook6": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook7": {
"description": "Name of a hook used by the extension."
"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."
"description": "Name of a hook used by the extension."
},
"hook20": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
 
},
"hook21": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook22": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook23": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"description": "Name of a hook used by the extension.
"hook24": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
 
},
"hook25": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook26": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook27": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook28": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook29": {
"description": "Name of a hook used by the extension."
"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."
"description": "Name of a hook used by the extension."
 
},
"hook32": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
"description": "Name of a hook
"description": "Name of a hook used by the
"description": "Name of a hook used by the e
"description": "Name of a hook used by the extension.
"description": "Name of a hook used by the extension.
"description": "Name of a hook used by the  "Name of a hook used by the extension."
"descriptionName of a hook  of a hook used by the extension."
},
},
"hook33": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
},
"hook34": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
},
Line 492: Line 597:
"hook43": {
"hook43": {
"description": "Name of a hook used by the extension."
"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."
"description": "Name of a hook used by the extension."
},
"hook46": {
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
description": "Name of a hook used by the extension."
},
}
"hook47": {
 
"description": "Name of a hook used by the extension."
"description": "Name of a hook used by the extension."
},
"hook48": {
"description": "Name of a hook used by the extension."
"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."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook14": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook15": {
 
"description": "Name of a hook provided by the extension."
 
"Name of a hook provided by the extension."
},
},
"": {
"newhook16": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook17": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook18": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook19": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook20": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook21": {
"description": "Name ": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook22": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook23": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook24": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"{
"newhook25": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
"newhook26": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook27": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
" {
"newhook28": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook29": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook30": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook31": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook32": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook33": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook34": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook35": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook36": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook37": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook38": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook39": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook40": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook41": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook42": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook43": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook44": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook45": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook46": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook47": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"newhook48": {
"description": "Name of a hook provided by the extension."
"description": "Name of a hook provided by the extension."
},
},
"": {
"compatibility": {
"description": "Name of a hook provided by the ext
"description": "Compatibility chart, e.g. Template: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."
},
"bugzilla": {
"description": "Bugzilla MediaWiki extension component name",
"deprecated": true
},
"vagrant-role": {
"label": "Vagrant role",
"description": "A MediaWiki-Vagrant role that lets you use this extension, if present",
"type": "string"
},
"latest release date": {},
"latest_release_date": {},
"latest preview version": {},
"latest_peview_version": {},
"version_preview": {},
"latest_preview_version": {},
"update_preview": {},
"!": {},
"nousage": {},
"CheckUsageNameOverride": {}
},
"format": "block",
"paramOrder": [
"status",
"name",
"license",
"templatemode",
"image",
"imagesize",
"type",
"type1",
"type2",
"type3",
"type4",
"type5",
"type6",
"description",
"author",
"username",
"version",
"update",
"version preview",
"update preview",
"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",
"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",
"compatibility",
"translate",
"bugzilla",
"vagrant-role",
"latest release date",
"latest_release_date",
"latest preview version",
"latest_peview_version",
"version_preview",
"latest_preview_version",
"update_preview",
"!",
"nousage",
"CheckUsageNameOverride"
]
}
</templatedata>