<translate> [[<tvar|1>Special:MyLanguage/Phabricator</>|Issue tracker]]:</translate> [[phab:tag/{{{phabricator}}}/|#{{{phabricator}}}]]
Difference between revisions of "Template:Extension/en"
Jump to navigation
Jump to search
>FuzzyBot (Updating to match new version of source page) |
>FuzzyBot (Updating to match new version of source page) |
||
| (13 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
<noinclude> | <noinclude> | ||
<languages/> | <languages/> | ||
</noinclude><includeonly>{{#switch: | </noinclude><!-- | ||
--><templatestyles src="Template:Infobox/styles.css" /><!-- | |||
--><templatestyles src="Template:Extension/styles.css" /><!-- | |||
--><templatestyles src="Template:Extension/status.css" /><!-- | |||
--><includeonly>{{#switch: | |||
| = | | = | ||
{{#ifeq:{{lc:{{{status}}}}}|unmaintained|{{#ifeq:{{NAMESPACE}}|Extension|{{#invoke:Extension|unmaintained}}}}}} | {{#ifeq:{{lc:{{{status}}}}}|unmaintained|{{#ifeq:{{NAMESPACE}}|Extension|{{#invoke:Extension|unmaintained}}}}}} | ||
{{#if: {{{phabricator|{{{bugzilla|}}}}}} | {{Ptag|{{{phabricator|MediaWiki-extensions-{{{bugzilla|}}}}}}}} }} | {{#if: {{{phabricator|{{{bugzilla|}}}}}} | {{Ptag|{{{phabricator|MediaWiki-extensions-{{{bugzilla|}}}}}}}} }} | ||
<table class="infobox infobox-{{dir|{{pagelang}}}} ext-infobox ext-status-{{#switch: {{lc: {{{status|unknown}}} }} | |||
<table class="infobox | |||
|unmaintained|unstable|experimental|beta|stable={{lc: {{{status}}} }} | |unmaintained|unstable|experimental|beta|stable={{lc: {{{status}}} }} | ||
|#default=unknown | |#default=unknown | ||
}}"> | }}"> | ||
<caption>'''{{ll|Manual:Extensions|2=MediaWiki extensions manual}}'''</caption> | <caption>'''{{ll|Manual:Extensions|2=MediaWiki extensions manual}}'''</caption> | ||
<tr class=" | <tr class="infobox-header ext-infobox-header"> | ||
<th colspan="2" style="padding-top: 0.5em;">[[File:{{#ifeq: {{lc: {{{status|}}} }} |unstable| | <th colspan="2" style="padding-top: 0.5em;">[[File:{{#ifeq: {{lc: {{{status|}}} }} |unstable | ||
|OOjs UI icon alert-invert.svg | |||
|<!--else-->OOjs UI icon advanced{{#ifeq:{{{status}}}|beta||-invert}}.svg | |||
}}|link=Special:MyLanguage/Template:Extension#Content|{{dir|{{pagelang}}|right|left}}|40px]] <span style="font-size: 130%; line-height: 100%;">{{#if:{{{name|}}}|{{{name}}}|{{PAGENAME:{{translatable}}}}}}</span><br /> | |||
{{ll|Extension status|2=Release status:}} {{#switch: {{lc: {{{status|unknown}}} }} | {{ll|Extension status|2=Release status:}} {{#switch: {{lc: {{{status|unknown}}} }} | ||
|unmaintained=unmaintained | |unmaintained=unmaintained | ||
| Line 231: | Line 237: | ||
-->{{#if:{{{changelog|}}}|<br />{{{changelog}}}<!-- -->}}</td> | -->{{#if:{{{changelog|}}}|<br />{{{changelog}}}<!-- -->}}</td> | ||
</tr> | </tr> | ||
{{#if: {{{help|}}}{{#ifexist:Help:{{FULLPAGENAME}}|yes}} | | |||
<tr> | |||
<td>'''{{ll|Template:Extension#help|2=Help}}'''</td> | |||
<td>{{#if: {{{help|}}} | {{{help}}} | {{localized link|Help:{{FULLPAGENAME}}}} }}</td> | |||
</tr> | |||
}} | |||
{{#if:{{{example|}}}| | {{#if:{{{example|}}}| | ||
<tr> | <tr> | ||
| Line 383: | Line 395: | ||
{{intricate template}} | {{intricate template}} | ||
{{lua|Module:Extension|Module:ExtensionJson|Module:String}} | {{lua|Module:Extension|Module:ExtensionJson|Module:String}} | ||
{{Uses TemplateStyles|Template:Extension/styles.css}} | {{Uses TemplateStyles|Template:Infobox/styles.css|Template:Extension/styles.css|Template:Extension/status.css}} | ||
This template should be added to all extension pages on this wiki (but only the main page). | This template should be added to all extension pages on this wiki (but only the main page). | ||
It will add a useful infobox (see below) and will automatically add the extension to {{ll|Category:All extensions}}, along with the appropriate {{ll|Category:Extensions by status|status}} and {{ll|Category:Extensions by implementation type|implementation type}} categories. | It will add a useful infobox (see below) and will automatically add the extension to {{ll|Category:All extensions}}, along with the appropriate {{ll|Category:Extensions by status|status}} and {{ll|Category:Extensions by implementation type|implementation type}} categories. | ||
| Line 425: | Line 437: | ||
|readme = | |readme = | ||
|changelog = | |changelog = | ||
|help = | |||
|example = | |example = | ||
|namespace = | |namespace = | ||
| Line 448: | Line 461: | ||
|username = SomeUser | |username = SomeUser | ||
|author = SomeAuthor | |author = SomeAuthor | ||
|image = Placeholder. | |image = Placeholder.svg | ||
|version = {{{version}}} | |version = {{{version}}} | ||
|update = {{{update}}} | |update = {{{update}}} | ||
| Line 464: | Line 477: | ||
|readme = {{{readme}}} | |readme = {{{readme}}} | ||
|changelog = {{{changelog}}} | |changelog = {{{changelog}}} | ||
|help = {{{help}}} | |||
|example = {{{example}}} | |example = {{{example}}} | ||
|namespace = {{{namespace}}} | |namespace = {{{namespace}}} | ||
| Line 506: | Line 520: | ||
* ''{{ll|Category:Stable extensions|stable}}'' - stable version | * ''{{ll|Category:Stable extensions|stable}}'' - stable version | ||
* ''{{ll|Category:Unmaintained extensions|unmaintained}}'' - unmaintained - previously claimed to be stable, now unmaintained | * ''{{ll|Category:Unmaintained extensions|unmaintained}}'' - unmaintained - previously claimed to be stable, now unmaintained | ||
* ''{{ll|Category:Extensions with unknown status|unknown}}'' - default | * ''{{ll|Category:Extensions with unknown status|unknown}}'' - default | ||
| Line 552: | Line 565: | ||
** {{ll|Category:File repository extensions|''filerepo''}} - extension that adds new file repository types as file backend | ** {{ll|Category:File repository extensions|''filerepo''}} - extension that adds new file repository types as file backend | ||
** {{ll|Category:Extension examples|''example''}} - Not a real extension, but an example of how to write one | ** {{ll|Category:Extension examples|''example''}} - Not a real extension, but an example of how to write one | ||
** {{ll|Category:Beta Feature extensions|''beta features''}} - extensions that new {{ll|Beta Features}}. | |||
** {{ll|Category:PHP extensions|''php''}} - extensions to the underlying {{ll|PHP}} programming language. | |||
** {{ll|Category:Internationalization extensions|''locale''}} - extensions associated with [[Special:MyLanguage/Manual:Localization|localization]] | |||
Any other value for 'type' is invalid, and will cause the extension to be placed in [[:Category:Extensions with invalid or missing type{{#translation:}}]]. | Any other value for 'type' is invalid, and will cause the extension to be placed in [[:Category:Extensions with invalid or missing type{{#translation:}}]]. | ||
| Line 574: | Line 589: | ||
<tr> | <tr> | ||
<td><span id="newhook">'''newhook1'''</span><br/>''newhook2''<br/>''newhook3''<br/>''newhook4''<br/>...<br/>''newhook90''</td> | <td><span id="newhook">'''newhook1'''</span><br/>''newhook2''<br/>''newhook3''<br/>''newhook4''<br/>...<br/>''newhook90''</td> | ||
<td valign="top">'''name of each hook provided by the extension''' | <td valign="top"> | ||
'''name of each hook provided by the extension''' | |||
You might also want to add the hooks to [[Extension hook registry]].</td> | You might also want to add the hooks to [[Extension hook registry]]. | ||
</td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
| Line 609: | Line 626: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>{{visible anchor|needs-updatephp}}</td><td><code>yes</code> 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. <code>no</code> should be set as a value since this assures that the extension does not need update.php to be run and thus avoids uncertainty | <td>{{visible anchor|needs-updatephp}}</td> | ||
<td> | |||
<code>yes</code> 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. <code>no</code> should be set as a value since this assures that the extension does not need update.php to be run and thus avoids uncertainty | |||
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 <syntaxhighlight lang=php inline>$IP/extensions/ExtensionName</syntaxhighlight> and inserted <syntaxhighlight lang=php inline>wfLoadExtension( "ExtensionName" );</syntaxhighlight> into "LocalSettings.php", run from the command line: | 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 <syntaxhighlight lang=php inline>$IP/extensions/ExtensionName</syntaxhighlight> and inserted <syntaxhighlight lang=php inline>wfLoadExtension( "ExtensionName" );</syntaxhighlight> into "LocalSettings.php", run from the command line: | ||
| Line 633: | Line 652: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td><span id="download">'''download'''</span></td><td>'''link to the download''' : [ | <td><span id="download">'''download'''</span></td><td>'''link to the download''' : [[phab:r/project/mediawiki/core|Git]], {{tl|WikimediaDownload{{#translation:}}}}. </td> | ||
</tr> | </tr> | ||
<td><span id="repo">repo</span></td><td>Name of the Gerrit repository the extension's code is stored in, if different from the page name. Setting this automatically sets {{para|download}}, and allows the template to automatically load data from the appropriate <code>extension.json</code> file.</td> | <td><span id="repo">repo</span></td><td>Name of the Gerrit repository the extension's code is stored in, if different from the page name. Setting this automatically sets {{para|download}}, and allows the template to automatically load data from the appropriate <code>extension.json</code> file.</td> | ||
| Line 653: | Line 672: | ||
<tr> | <tr> | ||
<td>{{visible anchor|namespace}}</td><td>[[Special:MyLanguage/Manual:Namespace|namespace]] in which this extension is used</td> | <td>{{visible anchor|namespace}}</td><td>[[Special:MyLanguage/Manual:Namespace|namespace]] in which this extension is used</td> | ||
</tr> | |||
<tr> | |||
<td>{{visible anchor|help}}</td><td>Link to user-help for the extension. If not provided, will look for <code>Help:Extension:''ExtensionName''</code>. If provided, full wikitext link should be given (because you may want to link to e.g. an external page).</td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
| Line 658: | Line 680: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>{{visible anchor|compatibility}}</td><td>Additional compatibility information, for instance compatibility charts | <td>{{visible anchor|compatibility}}</td><td>Additional compatibility information, for instance compatibility charts. It's encouraged to add any client-side compatibility information here too, especially when diverging from [[Special:MyLanguage/Compatibility#Browsers|expectations of full support for a browser]].</td> | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>{{visible anchor|translate}}</td><td>Optional parameter to link the exact page where ([[Special:MyLanguage/Help:Extension:Translate/Glossary|message group id]] with which) the extension will be translatable on [[translatewiki.net]] if enabled. If the default link is incorrect, manually set it to: | <td>{{visible anchor|translate}}</td> | ||
<td> | |||
Optional parameter to link the exact page where ([[Special:MyLanguage/Help:Extension:Translate/Glossary|message group id]] with which) the extension will be translatable on [[translatewiki.net]] if enabled. If the default link is incorrect, manually set it to: | |||
* ext-LOWERCASE(NOSPACES(Label as defined in {{git file|project=translatewiki|branch=HEAD|file=groups/MediaWiki/ExtensionsAgg.yaml|text=config}})), aka | * ext-LOWERCASE(NOSPACES(Label as defined in {{git file|project=translatewiki|branch=HEAD|file=groups/MediaWiki/ExtensionsAgg.yaml|text=config}})), aka | ||
* the parameter you get in the URL after | * the parameter you get in the URL after | ||
** typing the name of the extension in the search/filter box at [[translatewiki:Special:Translate]] or | ** typing the name of the extension in the search/filter box at [[translatewiki:Special:Translate]] or | ||
** searching for its name in [https://translatewiki.net/w/i.php?title=Special%3ALanguageStats&x=D languagestats] after clicking "expand all".</td> | ** searching for its name in [https://translatewiki.net/w/i.php?title=Special%3ALanguageStats&x=D languagestats] after clicking "expand all". | ||
</td> | |||
</tr> | </tr> | ||
<tr> | <tr> | ||
| Line 687: | Line 712: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>'''templatemode'''</td><td>'''Controls auto-categorization of host page.''' | <td>'''templatemode'''</td> | ||
<td> | |||
'''Controls auto-categorization of host page.''' | |||
Normally left blank. Alternate values are: | Normally left blank. Alternate values are: | ||
| Line 748: | Line 775: | ||
[[Special:WhatLinksHere/Template:Extension/vulnerabilities|vulnerabilities]], | [[Special:WhatLinksHere/Template:Extension/vulnerabilities|vulnerabilities]], | ||
[[Special:WhatLinksHere/Template:Extension/archived|archived]] | [[Special:WhatLinksHere/Template:Extension/archived|archived]] | ||
</noinclude> | </noinclude> | ||
Latest revision as of 03:33, 15 October 2021
<languages/> Lua error in Module:TNT at line 158: Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Documentation.tab.[[Category:Template documentation pages{{#translation:}}]] Maintenance: vulnerabilities, archived