Sjabloon:ExtensionInstall
- Download en plaats de bestanden in de map
ExtensionInstall
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionInstall - Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";
- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Uses Lua: |
Gebruik
Installation instructions.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Extension name | 1 | Set the extension name manually.
| String | optional |
Git submodule | git-submodule | Add --recurse-submodules to the git clone command | Boolean | optional |
Vagrant role name | vagrant | If given, shows how to install extension with the Vagrant's enable-role command | String | optional |
Download link | download-link | Overwrite the download link.
| URL | optional |
LocalSettings early | localsettingsearly | Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded.
| Unknown | optional |
LocalSettings | localsettings | Pass custom PHP code that the user should include in [[LocalSettings.php]].
| Unknown | optional |
Database update | db-update | If the extension has one or more database tables that need to be created through [[update.php]], set this parameter to any value.
| Boolean | optional |
Composer | composer | If the extension uses [[Composer]] to manage dependencies, set this parameter to any value.
| Boolean | optional |
Custom steps 0 | custom-steps0 | Additional steps before download, e.g. other required extensions (as an unordered "* list") | Content | optional |
Custom steps | custom-steps | Additional steps (as an unordered "* list") | Content | optional |
Supports registration | registration | Changes the template to use <code>wfLoadExtension()</code> if it supports registration. Set to any value if the extension supports registration, or to <code>required</code> if it <em>only</em> supports registration and doesn't support the old-style of loading. | String | optional |
No registration version | no-registration-version | The MediaWiki version for which extension registration should not be used
| Unknown | optional |
Voorbeelden
Hieronder staan een paar voorbeelden over het gebruik van dit sjabloon:
Eenvoudig
{{ExtensionInstall}}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/MyExtension/MyExtension.php";- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Naam
{{ExtensionInstall|CategoryTree}}
- Download en plaats de bestanden in de map
CategoryTree
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/CategoryTree/CategoryTree.php";- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Download link
{{ExtensionInstall |download-link=[http://bits.wikimedia.org/example.zip Download] }}
- Download en plaats de bestanden in een map
MyExtension
in de mapextensions/
.- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/MyExtension/MyExtension.php";- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
LocalSettings
{{ExtensionInstall |localsettings= $wgUseAjax = true; }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/MyExtension/MyExtension.php"; $wgUseAjax = true;- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
LocalSettings vroeg
{{ExtensionInstall |localsettingsearly= $wgUseAjax = true; // Dit moet worden 'included' voordat de extensie wordt geladen }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
$wgUseAjax = true; // Dit moet worden included voordat de extensie wordt geladen. require_once "$IP/extensions/MyExtension/MyExtension.php";- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
DB Update
{{ExtensionInstall |db-update=Yes }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/MyExtension/MyExtension.php";- Voer het update script uit, dat automatisch de vereiste database-tabellen creëert die nodig zijn voor de extensie.
- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Composer.
{{ExtensionInstall |composer=Yes }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Alleen bij installeren vanuit Git, run Composer om PHP afhankelijkheden te installeren, door het publiceren van
composer install --no-dev
in de extensie-map. (Zie taak T173141 voor potentiële problemen.)- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/MyExtension/MyExtension.php";- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Aangepaste stappen
{{ExtensionInstall |custom-steps= * Lorem ipsum dolor sit amet * Foo bar baz quux [[sandbox]] }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
require_once "$IP/extensions/MyExtension/MyExtension.php";- Lorem ipsum dolor sit amet
- Foo bar baz quux sandbox
- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Ondersteuningsregistratie
{{ExtensionInstall |registration=1 }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
wfLoadExtension( 'MyExtension' );- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Ondersteuning registratie met minimale versie
{{ExtensionInstall |registration=1 |no-registration-version=1.39 }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
wfLoadExtension( 'MyExtension' );- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Voor gebruikers van MediaWiki 1.39 of ouder:
De instructies hierboven beschrijven de nieuwe manier van het installeren van extensies, door middel van
wfLoadExtension()
. Indien deze extensie wordt geïnstalleerd op een eerdere versie (MediaWiki 1.39 en ouder), gebruik in plaats vanwfLoadExtension( 'MyExtension' );
:require_once "$IP/extensions/MyExtension/MyExtension.php";
Dit werkt alleen als de opgegeven versie 1.35 of hoger is, anders gaat het sjabloon ervan uit dat niemand zich bekommert om oude versies en valt het terug op verplichte registratie.
Verplichte registratie
{{ExtensionInstall |registration=required }}
- Download en plaats de bestanden in de map
MyExtension
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
wfLoadExtension( 'MyExtension' );- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Alles
{{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 }}
- Download en plaats de bestanden in een map
Example
in de mapextensions/
.- Alleen bij installeren vanuit Git, run Composer om PHP afhankelijkheden te installeren, door het publiceren van
composer install --no-dev
in de extensie-map. (Zie taak T173141 voor potentiële problemen.)- Voeg de volgende code onderaan het bestand LocalSettings.php toe:
wfLoadExtension( 'Example' ); $wgUseAjax = true;- Voer het update script uit, dat automatisch de vereiste database-tabellen creëert die nodig zijn voor de extensie.
- Lorem ipsum dolor sit amet
- Foo bar baz quux sandbox
- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Voor gebruikers van MediaWiki 1.39 of ouder:
De instructies hierboven beschrijven de nieuwe manier van het installeren van extensies, door middel van
wfLoadExtension()
. Indien deze extensie wordt geïnstalleerd op een eerdere versie (MediaWiki 1.39 en ouder), gebruik in plaats vanwfLoadExtension( 'Example' );
:require_once "$IP/extensions/Example/Example.php";
Vagrant installatie:
- Wanneer Vagrant gebruikt wordt, installeer door middel van
vagrant roles enable example --provision