<translate> [[<tvar|1>Special:MyLanguage/Phabricator</>|Issue tracker]]:</translate> [[phab:tag/{{{phabricator}}}/|#{{{phabricator}}}]]

Difference between revisions of "Template:Extension/en"

From WPRDC Wiki
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|}}}}}}}} }}
<templatestyles src="Extension/styles.css" />
<table class="infobox infobox-{{dir|{{pagelang}}}} ext-infobox ext-status-{{#switch: {{lc: {{{status|unknown}}} }}
<table class="infobox tpl-infobox ext-infobox ext-status-{{#switch: {{lc: {{{status|unknown}}} }}
|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="tpl-infobox-header ext-infobox-header">
<tr class="infobox-header ext-infobox-header">
<th colspan="2" style="padding-top: 0.5em;">[[File:{{#ifeq: {{lc: {{{status|}}} }} |unstable|OOjs_UI_icon_alert-invert.svg|<!--else-->OOjs UI icon advanced.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 />
<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.png
|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:Archived extensions|archive}}'' - archived - deprecated or merged with another extension
* ''{{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''' : [https://phabricator.wikimedia.org/r/project/mediawiki/core Git], {{tl|WikimediaDownload{{#translation:}}}}. </td>
<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 (formerly using [[Template:Extension Testing]]). 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>
<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]]
[[Category:Info templates{{#translation:}}|{{PAGENAME}}]]
[[Category:Extension creation{{#translation:}}]]
[[Category:Categorizing templates{{#translation:}}|{{PAGENAME}}]]
[[Category:Extension templates{{#translation:}}]]
</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