Příručka:Extensions
Rozšíření umožňují upravovat vzhled i funkce systému MediaWiki.
- Uživatelé Wiki mohou procházet rozšíření.
- 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 spravovat či vylepšovat stávající.
Některá rozšíření jsou spravována samotnými vývojáři MediaWiki, jiná uživateli. Důsledkem je, že v mnoha rozšířeních se vyskytují chyby a nelze obecně garantovat kompatibilitu mezi nimi. O některá rozšíření se už nikdo nestará; ne všechna rozšíření fungují s každou verzí MediaWiki Použití jakýchkoli rozšíření, především těch otagovaných jako nebezpečná, je na vlastní riziko. Pokud používáte rozšíření, které vyžaduje záplaty k základnímu softwaru, nezapomeňte zálohovat databázi. Pomáhá to vyhnout se riziku poškození vaší wiki.
Typy rozšíření
Parserové značky
Funkce parseru
Háčky
Speciální stránky
Zobrazení
Kouzelná slova
API
Modely obsahu stránky
Přihlášení
Procházení rozšíření
Můžete procházet Kategorie:Rozšíření podle kategorie a zobrazit celou řadu již napsaných rozšíření. Informace o instalaci těchto rozšíření nebo psaní vlastních naleznete níže.
Kontrola nainstalovaných rozšíření
Rozšíření pro MediaWiki může nainstalovat pouze někdo s přístupem pro správu k souborovému systému (a často také k databázi) na serveru. Ale kdokoli může zkontrolovat, která rozšíření jsou aktivní na instanci MediaWiki přístupem na speciální stránku Special:Version. Například tato rozšíření jsou aktivní na anglické Wikipedii.
Instalace rozšíření
MediaWiki je připravena přijímat rozšíření ihned po dokončení instalace. Chcete-li přidat rozšíření, postupujte takto:
- 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 shell (SSH).
- 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 Wikimedia Git repository je umístěn na git:mediawiki/extensions. Některá rozšíření nepoužívají řízení verzí a nejsou doporučována. - Některá rozšíření jsou k dispozici také ve svazcích, composer nebo v balíčcích repozitářů.
- 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.
- Na konec souboru
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 uvnitř podmíněného výše, jako je Extension:Semantic MediaWiki , Extension:Formuláře stránky .
- 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 příponu 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í:
- Stáhněte novou verzi rozšíření
- Nahraďte všechny soubory rozšíření v adresáři
extension/ExtensionName
novými soubory. Neodstraňujte konfiguraci rozšíření přítomnou v LocalSettings.php - 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 třeba 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é web updater.
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í.
- Pokud rozšíření poskytuje nějaké změny databáze, musíte je spustit update.php , abyste je odstranili.
Související odkazy
- Kategorie:Rozšíření
- Šablona:Rozšíření
- Manual:Developing extensions
- Příručka:Rozšíření pro překlady - Informace o překladech rozšíření.