Template:ExtensionInstall/cs

  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného ExtensionInstall ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionInstall
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.
Dokumentace šablony
Category:Lua-based templates

Použití

Installation instructions.

Template parameters

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

Příklady

Níže uvedené příklady demonstrují jak použít tuto šablonu:

Bez parametrů

{{ExtensionInstall}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

S předaným názvem rozšíření

{{ExtensionInstall|CategoryTree}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného CategoryTree ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/CategoryTree/CategoryTree.php";
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

S aktivním linkem na soubor ke stažení

{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
  • Download soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

LocalSettings

{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    $wgUseAjax = true;
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Před aktivací v LocalSettings

{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // musí být zahrnuto před načtením rozšíření
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    $wgUseAjax = true; // musí být zahrnuto před načtením rozšíření
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

S informací o nutné aktualizaci databáze

{{ExtensionInstall
|db-update=Yes
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Vyžaduje-li aktualizaci přes Composer

{{ExtensionInstall
|composer=Yes
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Při instalaci z Gitu spusťte Composer pro instalaci závislostí PHP zadáním composer install --no-dev v adresáři rozšíření. (Vyskytnou-li se nějaké komplikace, podívejte se na T173141.)
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Vyžaduje-li instalace další nezbytné kroky

{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Lorem ipsum dolor sit amet
  • Foo bar baz quux sandbox
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Podporuje-li rozšíření zavedení přes registraci

{{ExtensionInstall
|registration=1
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( 'MyExtension' );
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Podpora registrace s minimální verzí

{{ExtensionInstall
|registration=1
|no-registration-version=1.39
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( 'MyExtension' );
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Pro ty, kteří používají MediaWiki 1.39 a starší:

Výše uvedené instrukce se týkají instalace přes wfLoadExtension(), což je novější způsob instalace rozšíření. Pokud potřebujete toto rozšíření nainstalovat na starší verzi (MediaWiki 1.39 či starší), musíte místo wfLoadExtension( 'MyExtension' ); použít:

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

Toto funguje pouze v případě, že je zadaná verze 1.35 nebo novější, jinak šablona předpokládá, že prastaré verze nikoho nezajímají, a vrátí se k #Vyžadovat registraci.

Podporuje-li automatickou registraci

{{ExtensionInstall
|registration=required
}}
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného MyExtension ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( 'MyExtension' );
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Komplexní použití této parametrizované šablony

{{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 soubor/y a vložte je do adresáře pojmenovaného Example ve vaší složce extensions/.
  • Při instalaci z Gitu spusťte Composer pro instalaci závislostí PHP zadáním composer install --no-dev v adresáři rozšíření. (Vyskytnou-li se nějaké komplikace, podívejte se na T173141.)
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( 'Example' );
    $wgUseAjax = true;
    
  • Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
  • Lorem ipsum dolor sit amet
  • Foo bar baz quux sandbox
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Pro ty, kteří používají MediaWiki 1.39 a starší:

Výše uvedené instrukce se týkají instalace přes wfLoadExtension(), což je novější způsob instalace rozšíření. Pokud potřebujete toto rozšíření nainstalovat na starší verzi (MediaWiki 1.39 či starší), musíte místo wfLoadExtension( 'Example' ); použít:

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


Instalace Vagrant:

  • Pokud používáte Vagrant , instalujte s těmito parametry vagrant roles enable example --provision
Category:Template documentation pages/cs Category:Installation guide templates/cs
Category:Installation guide templates/cs Category:Lua-based templates Category:Pages using the JsonConfig extension Category:Template documentation pages/cs