Brontekst bekijken van Sjabloon:ExtensionInstall

<noinclude>
<languages/>
</noinclude>{{#switch:<translate></translate>
| =
{{#if: {{{vagrant|}}} |
* <translate><!--T:1--> If using <tvar|vagrant>{{ll|MediaWiki-Vagrant|Vagrant}}</>, install with <tvar|code><code>vagrant roles enable {{{vagrant}}} --provision</code></></translate>
<translate><!--T:2--> ; Manual installation </translate>
}}<!-- whitespace fix
-->{{trim| {{{custom-steps0|}}} }}
* <translate><!--T:3--> {{{<tvar|1>download-link</>|[[<tvar|2>Special:ExtensionDistributor/{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}</>|Download]]}}} and place the file(s) in a directory called <tvar|name><code>{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}</code></> in your <tvar|ext><code>extensions/</code></> folder.</translate>
{{#if: {{{composer|}}} |
* <translate><!--T:25--> Only when installing from git run <tvar|composer>[[Special:MyLanguage/Composer|Composer]]</> to install PHP dependencies, by issuing <tvar|code><code>composer install --no-dev</code></> in the extension directory.</translate> <small><translate><!--T:26--> (See <tvar|phab>[[phab:T173141|T173141]]</> for potential complications.)</translate></small>{{#ifeq: {{NAMESPACENUMBER}} |102 |{{#ifeq: {{SUBPAGENAME}} |en | |{{#ifeq: {{PAGELANGUAGE}} |en |[[Category:Extensions requiring Composer with git]] }} }} }}
}}
* <translate><!--T:4--> Add the following code at the bottom of your <tvar|LocalSettings>{{manual|LocalSettings.php}}</>:</translate> {{#tag:syntaxhighlight|
{{{localsettingsearly|}}}
{{#if: {{{source|}}} | {{{source|}}} | {{#if: {{{registration|}}} | {{#if: {{{customizereg|}}} | {{{customizereg|}}} |wfLoadExtension( '{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}' );}} | {{#if: {{{oldreg|}}} | {{{oldreg|}}} | require_once "$IP/{{{basedir|extensions}}}/{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}/{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}.php";}}}} }}
{{{localsettings|}}}
|lang="php"
}}<!-- whitespace fix
-->{{#if: {{{db-update|}}} |
* <translate><!--T:7--> Run the '''[[<tvar|update>Special:MyLanguage/Manual:Update.php</>|update script]]''' which will automatically create the necessary database tables that this extension needs.</translate>}}<!-- whitespace fix
-->{{trim| {{{custom-steps|}}} }}
* {{ {{TNTN|Done}} }} – <translate><!--T:8--> Navigate to <tvar|special>[[Special:Version]]</> on your wiki to verify that the extension is successfully installed.</translate><!-- whitespace fix
-->{{#if: {{{registration|}}}|{{#ifeq:{{{registration|}}}|required||<nowiki/>

<translate>
<!--T:9-->
To users running MediaWiki <tvar|1>{{{no-registration-version|1.24}}}</> or earlier:

<!--T:10-->
The instructions above describe the new way of installing this extension using <tvar|LoadExtension><code>wfLoadExtension()</code></>.</translate> <translate><!--T:11-->
If you need to install this extension on these earlier versions (MediaWiki <tvar|1>{{{no-registration-version|1.24}}}</> and earlier), instead of <tvar|code>{{#tag:syntaxhighlight|wfLoadExtension( '{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}' );|lang=php|inline=true}}</>, you need to use:
</translate>
{{#tag:syntaxhighlight|
require_once "$IP/{{{basedir|extensions}}}/{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}/{{trim| {{#if:{{{1|}}}|{{{1}}}|{{ROOTPAGENAME}}}} }}.php";
|lang="php"
}}}}}}
| #default=
  {{#invoke:Template translation|renderTranslatedTemplate|template=Template:ExtensionInstall|noshift=1}}
}}<noinclude>
{{ {{TNTN|documentation}} |content=
<translate>
== Usage == <!--T:13-->
</translate>

{{ExtensionInstall/TemplateData}}

<translate>
== Examples == <!--T:14-->

<!--T:15-->
Below a few examples of how to use this template:

=== Simple === <!--T:16-->
</translate>
<pre>
{{ExtensionInstall}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension}}
</blockquote>

<translate>
=== Name === <!--T:17-->
</translate>
<pre>
{{ExtensionInstall|CategoryTree}}
</pre>
<blockquote>
{{ExtensionInstall|CategoryTree}}
</blockquote>

<translate>
=== Download link === <!--T:18-->
</translate>
<pre>
{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
</blockquote>

=== LocalSettings ===

<pre>
{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|localsettings=
$wgUseAjax = true;
}}
</blockquote>

==== LocalSettings early ====

<pre>
{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // this must be included before the extension is loaded
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|localsettingsearly=
$wgUseAjax = true; // this must be included before the extension is loaded
}}
</blockquote>

<translate>
=== DB Update === <!--T:19-->
</translate>
<pre>
{{ExtensionInstall
|db-update=Yes
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|db-update=Yes
}}
</blockquote>

<translate>
=== Composer === <!--T:27-->
</translate>
<pre>
{{ExtensionInstall
|composer=Yes
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|composer=Yes
}}
</blockquote>

<translate>
=== Custom steps === <!--T:20-->
</translate>
<pre>
{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}
</blockquote>

<translate>
=== Support registration === <!--T:21-->
</translate>
<pre>
{{ExtensionInstall
|registration=1
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|registration=1
}}
</blockquote>

<translate>
=== Set recommended registration MediaWiki version === <!--T:24-->
</translate>
<pre>
{{ExtensionInstall
|registration=1
|no-registration-version=1.25
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|registration=1
|no-registration-version=1.25
}}
</blockquote>

<translate>
=== Require registration === <!--T:22-->
</translate>
<pre>
{{ExtensionInstall
|registration=required
}}
</pre>
<blockquote>
{{ExtensionInstall|MyExtension
|registration=required
}}
</blockquote>

<translate>
=== Everything === <!--T:23-->
</translate>
<pre>
{{ExtensionInstall|Example
|download-link=[http://bits.wikimedia.org/example.zip Download]
|vagrant=example
|localsettings=
$wgUseAjax = true;

|db-update=Yes
|composer=Yes
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
|registration=yes
}}
</pre>
<blockquote>
{{ExtensionInstall|Example
|download-link=[http://bits.wikimedia.org/example.zip Download]
|vagrant=example
|localsettings=
$wgUseAjax = true;

|db-update=Yes
|composer=Yes
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
|registration=yes
}}
</blockquote>
}}
[[Category:Installation guide templates{{#translation:}}]]
</noinclude>