Sjabloon:ExtensionInstall

This page is a translated version of the page Template:ExtensionInstall and the translation is 100% complete.
  • Download en plaats de bestanden in de map ExtensionInstall in de map extensions/.
    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";
    
  • Yes Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Template documentation

Gebruik

Installation instructions.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Extension name1

Set the extension name manually.

Default
The current page name without namespace prefix.
Auto value
{{ROOTPAGENAME}}
Stringoptional
Git submodulegit-submodule

Add --recurse-submodules to the git clone command

Booleanoptional
Vagrant role namevagrant

If given, shows how to install extension with the Vagrant's enable-role command

Stringoptional
Download linkdownload-link

Overwrite the download link.

Default
Link to Special:ExtensionDistributor with the extension name.
URLoptional
LocalSettings earlylocalsettingsearly

Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded.

Example
$wgUseAjax = true; // Must be included before the extension is loaded
Unknownoptional
LocalSettingslocalsettings

Pass custom PHP code that the user should include in [[LocalSettings.php]].

Example
$wgUseAjax = true;
Unknownoptional
Database updatedb-update

If the extension has one or more database tables that need to be created through [[update.php]], set this parameter to any value.

Default
false
Booleanoptional
Composercomposer

If the extension uses [[Composer]] to manage dependencies, set this parameter to any value.

Default
false
Booleanoptional
Custom steps 0custom-steps0

Additional steps before download, e.g. other required extensions (as an unordered "* list")

Contentoptional
Custom stepscustom-steps

Additional steps (as an unordered "* list")

Contentoptional
Supports registrationregistration

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.

Stringoptional
No registration versionno-registration-version

The MediaWiki version for which extension registration should not be used

Default
1.24
Unknownoptional

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 map extensions/.
    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";
    
  • Yes 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 map extensions/.
    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";
    
  • Yes Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
  • Download en plaats de bestanden in een map MyExtension in de map extensions/.
  • Voeg de volgende code onderaan het bestand LocalSettings.php toe:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes 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 map extensions/.
    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;
    
  • Yes 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 map extensions/.
    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";
    
  • Yes 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 map extensions/.
    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.
  • Yes 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 map extensions/.
    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";
    
  • Yes 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 map extensions/.
    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
  • Yes 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 map extensions/.
    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' );
    
  • Yes 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 map extensions/.
    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' );
    
  • Yes 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 van wfLoadExtension( '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 map extensions/.
    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' );
    
  • Yes 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 map extensions/.
  • 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
  • Yes 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 van wfLoadExtension( 'Example' );:

require_once "$IP/extensions/Example/Example.php";


Vagrant installatie:

  • Wanneer Vagrant gebruikt wordt, installeer door middel van vagrant roles enable example --provision