Manual:Extensions/cs

Rozšíření:

Rozšíření vám umožňuje přizpůsobit vzhled a fungování MediaWiki.

  • Systémoví administrátoři mohou nainstalovat (nebo odstranit) rozšíření na jimi spravované instalaci MediaWiki.
  • Vývojáři mohou psát nová rozšíření nebo přispívat ke stávajícím rozšířením.
Zatímco některá rozšíření spravují vývojáři MediaWiki, jiná byla napsána vývojáři třetích stran a nemusí být spravována. V důsledku toho může mnoho rozšíření obsahovat chyby – v některých případech včetně bezpečnostních zranitelností. Ne všechna rozšíření fungují na všech verzích MediaWiki a není zaručeno, že budou vzájemně kompatibilní. Používání rozšíření je na vlastní nebezpečí, zejména těch, která jsou označena jako nebezpečná. Pokud rozšíření vyžaduje záplaty základního softwaru, nezapomeňte si předem zálohovat databázi, abyste minimalizovali riziko narušení fungování wiki.

Výběr rozšíření

Přibalená rozšíření

Několik rozšíření je standardně dodáváno s MediaWiki.

Tato rozšíření by obecně měla být vysoce užitečná, fungovat efektivně, být stabilní, dobře napsaná a neměla by mít žádné známé závažné bezpečnostní problémy. Měly by být také kompatibilní s nejnovějšími verzemi MediaWiki a navzájem (tj. jedno rozšíření by nemělo blokovat funkce jiného). Přibalené rozšíření může být závislé na jednom nebo více dalších rozšířeních, pokud jsou tato rozšíření také přibalena.

Administrátoři webu je získají automaticky při instalaci nebo aktualizaci MediaWiki. Při aktualizaci MediaWiki se automaticky aplikují i ​​veškeré aktualizace rozšíření. Administrátoři webu se mohou dle libosti rozhodnout kteroukoli z těchto funkcí odinstalovat.

Probíhají otevřené diskuse o tom, která rozšíření by měla být součástí této skupiny. Můžete navrhnout další rozšíření k zabalení. Rozšíření budou zahrnuta do balíčku, jakmile se na tom vývojáři shodnou.

Rozšíření může být z balíčku odstraněno, pokud je jeho funkcionalita sloučena s jádrem MediaWiki, je nahrazeno alternativou nebo v nepravděpodobném případě odhalení neřešitelných závažných bezpečnostních zranitelností.

Procházení rozšíření

Prohlédněte si celou řadu dostupných rozšíření Kategorie:Všechna rozšíření nebo Kategorie:Rozšíření podle kategorie.

Kontrola nainstalovaných rozšíření

Která rozšíření jsou aktivní na instanci MediaWiki, lze zkontrolovat na stránce Special:Version a posunutím dolů k nadpisu Nainstalovaná rozšíření (kotva #mw-version-ext). Například na této wiki je nainstalováno toto rozšíření a na anglické Wikipedii jsou aktivní tato rozšíření.

Populární rozšíření

Existuje několik způsobů, jak najít populární rozšíření.

Rozšíření, která jsou stažena z MediaWiki.org prostřednictvím mechanismu ExtensionDistributor, mají shromážděné nějaké statistiky. 15 nejstahovanějších rozšíření na Special:ExtensionDistributor a počet stažení příslušných rozšíření je uveden v informačním poli. Všimněte si, že tato čísla nezahrnují alternativní způsoby instalace rozšíření, jako je přes Git nebo Composer.

Další možností je podívat se na počet wikin na WikiApiary, na kterých jsou rozšíření nainstalována. To má tu výhodu, že představuje skutečné instalace a nejen stahování (tj. dotazuje se na API wiki), ale také to (od roku 2023) není zcela aktuální. Nepočítá také instalace na soukromých wikinách.

Instalace rozšíření

Další pokyny najdete také na stránce Příručka:Rozšíření/Instalace a aktualizace

MediaWiki je připravena přijímat rozšíření ihned po dokončení instalace. Chcete-li přidat rozšíření, postupujte takto:

  1. Než začnete
    Mnoho rozšíření obsahuje pokyny určené k instalaci pomocí příkazů Unix.Chcete-li zadat tyto příkazy uvedené na stránkách nápovědy k rozšíření, potřebujete přístup shell (SSH).
  2. Stáhněte si své rozšíření.
    Distributor rozšíření vám pomůže vybrat a stáhnout většinu oblíbených rozšíření.
    Rozšíření jsou obvykle distribuována jako modulární balíčky.Obecně se ukládají do vlastního podadresáře $IP/extensions/.Seznam rozšíření uložených v Git úložišti Wikimedie je umístěn na git:mediawiki/extensions.Některá rozšíření nepoužívají správu verzí a nejsou doporučována.
    Některá rozšíření jsou k dispozici také ve svazcích, Composer nebo v balíčcích repozitářů.
    Před instalací se doporučuje přečíst soubor README.Obvykle obsahuje důležité informace o konfiguraci.
  3. Nainstalujte rozšíření.
    Na konec souboru LocalSettings.php přidejte:
    wfLoadExtension( 'ExtensionName' );
    Tento řádek nutí interpret PHP, aby přečetl soubor rozšíření a tím jej zpřístupnil MediaWiki.
    Některá rozšíření mohou být v konfliktu s údržbovými skripty, například pokud mají přímý přístup k $_SERVER (nedoporučuje se). V tomto případě mohou být zabaleny do podmíněného stavu, takže skripty údržby mohou stále běžet.
    if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
    Skript údržby importDump.php selže u všech rozšíření, která vyžadují přizpůsobené jmenné prostory, které jsou zahrnuty do podmíněného viz výše, jako je Rozšíření:Semantic MediaWiki, Rozšíření:Page Forms.
Zajistěte, aby byla pro rozšíření nastavena požadovaná oprávnění!
I když je tento instalační postup pro většinu rozšíření dostatečný, některá vyžadují jiný instalační postup.Podrobnosti naleznete v dokumentaci k rozšíření.
Pokud chcete změnit konfigurační proměnné v LocalSettings.php, musíte to typicky provést za včetně přípony.Jinak výchozí nastavení definovaná v rozšíření přepíše vaše nastavení.

Aktualizace rozšíření

Některá rozšíření vyžadují aktualizaci vždy, když aktualizujete MediaWiki, zatímco jiná pracují s více verzemi. Postup aktualizace na novou verzi rozšíření:

  1. Stáhněte novou verzi rozšíření
  2. Nahraďte všechny soubory rozšíření v adresáři extensions/ExtensionName novými soubory.Neodstraňujte konfiguraci rozšíření přítomnou v LocalSettings.php
  3. Pokud rozšíření vyžaduje změny v databázi MediaWiki, budete muset spustit skript údržby update.php.Většina rozšíření uvede, zda je potřebné tento skript spustit nebo ne.(Před spuštěním skriptu proveďte zálohu dat).Pokud nemáte přístup z příkazového řádku, můžete použít také webový aktualizátor.
Tyto pokyny pokrývají 99% rozšíření.Pokud konkrétní rozšíření, které aktualizujete, obsahuje pokyny, které se od nich liší, pravděpodobně byste se měli řídit pokyny konkrétního rozšíření.

Odinstalace rozšíření

Odinstalujte řádek z LocalSettings.php s názvem přípony a odinstalujte jej:

wfLoadExtension( 'ExtensionName' );
  • Musíte odstranit všechny řádky týkající se konfigurace rozšíření.

Vývoj rozšíření

Jádro MediaWiki poskytuje několik způsobů, jak rozšíření změnit chování a vzhled wiki. Tyto body rozšíření poskytují rozšíření flexibilitu při přidávání vlastností a funkcí, jako je zobrazení speciální stránky nebo definování modulu API. Chcete-li začít, přečtěte si průvodce vývojem rozšíření. Než napíšete nové rozšíření, zvažte možnost přispět k existujícímu rozšíření nebo pomoci s neudržovaným rozšířením.

Uživatelé mohou také na Phabricatoru zaslat obecný požadavek a doufat, že se jejich dobrého nápadu ujme vývojář. Podívejte se na stránku https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/


Související odkazy

Category:Customization techniques/cs#Extensions/cs Category:Extension creation/cs
Category:Customization techniques/cs Category:Extension creation/cs