Template:Extension
<languages/> Template:Documentation/start box2 Lua error: Internal error: The interpreter has terminated with signal "-129". Lua error: Internal error: The interpreter has terminated with signal "-129". Lua error: Internal error: The interpreter has terminated with signal "-129". <translate> This template should be added to all extension pages on this wiki (but only the main page).</translate> <translate> It will add a useful infobox (see below) and will automatically add the extension to <tvar name=1>{{ Lua error: Internal error: The interpreter has terminated with signal "-129". }}</tvar>, along with the appropriate {{<tvar name=2>ll|Category:Extensions by status</tvar>|status}} and {{<tvar name=3>ll|Category:Extensions by implementation type</tvar>|implementation type}} categories.</translate>
<translate>
Usage
</translate>
|
<translate> Copy and paste:</translate> {{Extension |templatemode =
|name =
|status =
|type1 =
|type2 =
|hook1 =
|hook2 =
|newhook1 =
|newhook2 =
|username =
|author =
|description =
|image =
|imagesize =
|version =
|update =
|version preview =
|update preview =
|compatibility policy =
|mediawiki =
|php =
|needs-updatephp =
|composer =
|table1 =
|table2 =
|license =
|download =
|repo =
|readme =
|changelog =
|help =
|example =
|namespace =
|parameters =
|tags =
|rights =
|compatibility =
|phabricator =
|translate =
|vagrant-role =
}}
<translate> For help with parameter values, see [[<tvar name=1>#Content parameters</tvar>|below]].</translate> |
Lua error: Internal error: The interpreter has terminated with signal "-129". |
<translate>
Content parameters
</translate> <translate> This section describes parameters that govern infobox content.</translate> <translate> For help with <tvar name=1>templatemode</tvar> and other control parameters, please see [[<tvar name=2>#Control parameters</tvar>|Control parameters]].</translate>
| <translate> Parameter</translate> | <translate> Description</translate> |
|---|---|
| name | <translate> name of the extension</translate> |
| status |
<translate> current release status</translate> <translate> One of:</translate>
<translate> 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.</translate> <translate> In cases where the value is omitted, it will be categorized as [[<tvar name=1>Special:MyLanguage/Category:extensions with unknown status</tvar>|unknown]].</translate> <translate> In cases where the value is invalid, it will be placed in a [[<tvar name=1>Special:MyLanguage/Category:extensions with invalid status</tvar>|special category]] so that the error can be caught and fixed.</translate> <translate>
|
| type1 type2 type3 type4 type5 type6 | <translate> implementation type</translate>
<translate> The implementation strategy(s) employed in building this extension.</translate> <translate> This parameter is used to create categories that help programmers find examples of various MediaWiki specific implementation strategies or patterns.</translate> <translate> Although the values of this parameter sometimes coincide with the use case or purpose of an extension, that is not reason for this parameter.</translate> <translate> If the values you have chosen for this parameter do not adequately identify the purpose or possible use cases, we recommend you add additional [[<tvar name=1>Special:MyLanguage/Help:Categories</tvar>|category links]] as needed.</translate> <translate> Allowed values for the type1, type2, ... parameters are:</translate>
<translate> Any other value for 'type' is invalid, and will cause the extension to be placed in <tvar name=typemissingcat>[[:Category:Extensions with invalid or missing type{{#translation:}}]]</tvar>.</translate> <translate> Note: Many extensions have more than one type, if this applies to yours, replace <tvar name=type>|type=</tvar> with <tvar name=value>|type1=|type2=|type3=...</tvar>. You may define up to six types for an extension.</translate> |
| hook1 hook2 hook3 hook4 ... |
<translate> name of each hook used by the extension</translate>
<translate> Entering values in this field is a good way to get exposure for your extension and help other developers.</translate> <translate> Each documented hook will automatically add the extension to a category listing extensions that use that hook.</translate> <translate> This category is autolinked to each hook page so that programmers can easily find examples of extensions that use a particular hook.</translate> <translate> For built-in hooks:
For custom hooks defined by extensions:
|
| newhook1 newhook2 newhook3 newhook4 ... newhook90 |
<translate> name of each hook provided by the extension You might also want to add the hooks to <tvar name=exthooks>Extension hook registry</tvar>. </translate> |
| username | <translate> The author's username on MediaWiki.org (if they have one).</translate> <translate> May be omitted, but if present it will be used to link to the author's user & user_talk page.</translate> <translate> It should be provided without namespace and without <tvar name=1>[[]]</tvar>s.</translate> |
| <translate> The extension author's name, if different from their MediaWiki.org username.</translate> <translate> Free text.</translate> <translate> If omitted then the 'username' field will be used (if present).</translate> | |
| description | <translate> short description</translate> |
| image | <translate> Screenshot or logo of extension.</translate> <translate> It should be provided without namespace and without <tvar name=1>[[]]</tvar>s.</translate> |
| imagesize | <translate> Facultative, size of the image without adding px, e.g. 360 (default size is 300px)</translate> |
| version | <translate> Last version</translate> |
| update | <translate> Date of the last update</translate> |
| version preview | <translate> Preview version</translate> |
| update preview | <translate> Date of the last update to the preview version</translate> |
| compatibility policy | <translate> {{<tvar name=1>ll|Compatibility#mediawiki_extensions</tvar>|Compatibility policy}} (accepted values: <tvar name=4>master, main, rel, ltsrel</tvar>).</translate> (<translate> backlog</translate>) |
| mediawiki | <translate> Required version of MediaWiki.</translate> <translate> Most extensions should not need to use this — it defaults to the value of the <tvar name=1>'requires'</tvar> property of <tvar name=2>extension.json</tvar>.</translate> <translate> See also <tvar name=1>Category:Extensions without MediaWiki version</tvar> and <tvar name=2>Category:Extensions with manual MediaWiki version</tvar>.</translate> |
| php | <translate> Required version of PHP</translate> |
| needs-updatephp |
<translate>
<tvar name=yes> Extensions which conform to MediaWiki extension standards come with a schema change script which you need to start manually (once) before starting and accessing the MediaWiki through your browser, and after you copied all the extension files to <tvar name=target>
1>$IP</> stands for the Installation Path (or "directory") of your MediaWiki installation, the same directory that holds <tvar |
| composer | <translate> The extension's Composer package name, in the [<tvar name=url>https://getcomposer.org/doc/04-schema.md#name</tvar> standard format].</translate> <translate> It will be automatically included if set in an extension's "<tvar name=1>composer.json</tvar>" file (i.e. this parameter is not required in that case).</translate> <translate> It will be linked to the extension's page on [<tvar name=url>https://packagist.org/</tvar> Packagist].</translate> |
| table1 table2 table3 table4 ... table30 | <translate> name of each non-core table used by the extension</translate> <translate> Links to a subpage of your extension page. For instance, "<tvar name=table1>table1 = cu_changes</tvar>" at <tvar name=url1>Extension:CheckUser</tvar> will link to <tvar name=url2>Extension:CheckUser/cu_changes table</tvar>. Don't list core tables such as <tvar name=page>page</tvar> or <tvar name=revision>revision</tvar>; only list tables that are added by extensions.</translate> |
| license | <translate> License governing use of this extension, as one of the codes found in <tvar name=url>https://spdx.org/licenses/</tvar>, e.g. <tvar name=later2>GPL-2.0-or-later</tvar>, <tvar name=only2>GPL-2.0-only</tvar> or <tvar name=later3>GPL-3.0-or-later</tvar>, etc.</translate> |
| download | <translate> link to the download : <tvar name=url>Git</tvar>, <tvar name=wikimediadownload>{{[[Template:WikimediaDownload{{#translation:}}|WikimediaDownload{{#translation:}}]]}}</tvar>. </translate> |
| repo | <translate> Name of the Gerrit repository the extension's code is stored in, if different from the page name. Setting this automatically sets |download=, and allows the template to automatically load data from the appropriate <tvar name=1>extension.json</tvar> file.</translate> |
| readme | <translate> External link to the <tvar name=readme>readme</tvar> file, e.g. <tvar name=url>https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README</tvar></translate> |
| changelog | <translate> External link to the changelog file, e.g. <tvar name=url>Extension:GeoGebra/Changelog</tvar></translate> |
| help | <translate> Link to user-help for the extension.</translate> If not provided, will look for Help:Extension:ExtensionName. <translate> If provided, full wikitext link should be given (because you may want to link to e.g. an external page).</translate> |
| example | <translate> Example, website or screenshot of working extension</translate> |
| namespace | <translate> [[<tvar name=1>Special:MyLanguage/Manual:Namespace</tvar>|namespace]] in which this extension is used</translate> |
| parameters | <translate> Available parameters for LocalSettings.php</translate> |
| <translate> Any tags your extension uses (e.g. <tvar name=tags><tag1>, <tag2></tvar>).</translate> | |
| rights | <translate> [[<tvar name=1>Special:MyLanguage/Manual:User rights</tvar>|Rights]] added by the extension. Not to be confused with the license! Rights are such as <tvar name=makebot>makebot</tvar> or <tvar name=desysop>desysop</tvar>, not such as GFDL or LGPL or GPL - those are licenses!</translate> |
| compatibility | <translate> Additional compatibility information, for instance compatibility charts. It's encouraged to add any client-side compatibility information here too, especially when diverging from [[<tvar name=1>Special:MyLanguage/Compatibility#Browsers</tvar>|expectations of full support for a browser]].</translate> |
| bugzilla | <translate> Bugzilla MediaWiki extension component name</translate> |
| phabricator | <translate> Phabricator project name</translate> |
| translate |
<translate> Optional parameter to link the exact page where ([[<tvar name=1>Special:MyLanguage/Help:Extension:Translate/Glossary</tvar>|message group id]] with which) the extension will be translatable on <tvar name=translatewiki>translatewiki.net</tvar> if enabled. If the default link is incorrect, manually set it to:
</translate> |
| vagrant-role | <translate> <tvar name=1>{{ Lua error: Internal error: The interpreter has terminated with signal "-129". }}</tvar> role</translate> |
| CheckUsageNameOverride | <translate> Override the page name used for the check usage link.</translate> |
<translate>
Control parameters
</translate>
| <translate> Parameter</translate> | <translate> Description</translate> |
|---|---|
| templatemode |
<translate> Controls auto-categorization of host page. Normally left blank. Alternate values are: </translate>
|
<translate>
Using the infobox
Existing extension pages
If you want to add the infobox to an existing page, copy and paste the code at the [[<tvar name=1>#CutAndPaste</tvar>|top of this page]]. </translate>
Lua error: Internal error: The interpreter has terminated with signal "-129". <translate>
Create a new extension page
</translate> <translate> If you want to create a new extension page, enter the name below and click the button.</translate> <translate> A new page will be created with the infobox template already in place.</translate>
<translate> A developer sharing their code in the MediaWiki code repository should expect:</translate>
- <translate> Feedback / Criticism / Code reviews</translate>
- <translate> Review and comments by other developers on things like [<tvar
<translate>
Enhancing this template
</translate> <translate> If you would like to improve on this template, thanks!</translate> <translate> This is a complicated template so here is some help along the way:</translate>
<translate>
The Create extension button
To improve the create extension button behavior:
- <tvar name=extsample>Template:Extension/Sample</tvar>: The boilerplate extension that is preloaded into newly-created pages.
- <tvar name=extinpbox>{{ Lua error: Internal error: The interpreter has terminated with signal "-129". }}</tvar>: An input box that can be inserted wherever you want users to easily create extensions. For documentation on the <tvar name=tagvalue>
<inputbox></tvar> tag, please see <tvar name=url>Extension:InputBox</tvar>.
Infobox parameters
In general:
- To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays. If you add a parameter, please be sure to also add it to the [[<tvar name=1>Special:MyLanguage/Template:Extension#Content parameters</tvar>|content parameter documentation]] and link its label to that documentation.
To change/correct/add to the implementation type parameters:
- Check the [[<tvar name=url>Template_talk:Extension</tvar>|talk page]] - there have been some extensive discussions about this field.</translate>
<translate>
- The valid types and what they link to are defined at <tvar name=1>Module:Extension</tvar>
To change the behavior of the hook parameters:
- <tvar name=hookinuse>Template:Extension/HookInUse</tvar>: Adds links and categories for a hook in use. Multiple hooks in use are implemented by calling this template with <tvar name=foreach>Template:Foreach</tvar>.
- <tvar name=hookinusenocats>Template:Extension/HookInUseNoCats</tvar>: Used instead of <tvar name=hookinuse>Template:Extension/HookInUse</tvar> when this template is used in <tvar name=nocats>
templatemode=nocats</tvar>. Templates used with <tvar name=feach>Template:Foreach</tvar> can only take one parameter so we need to wrap the call to <tvar name=hookuse>Template:Extension/HookInUse</tvar> with another template that sets the mode.
Test case
See if the following pages are still ok, after edited this template.</translate>
TemplateData
TemplateData
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.
Lua error: Internal error: The interpreter has terminated with signal "-129".
TemplateData for Extension An infobox for a MediaWiki extension.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Template:Documentation/end box2 Maintenance: vulnerabilities, archived
[[Category:Infobox templates{{#translation:}}|Extension]]
