Příručka:Extensions

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Extensions and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Esperanto • ‎Tiếng Việt • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎čeština • ‎Ελληνικά • ‎български • ‎мокшень • ‎русский • ‎العربية • ‎سنڌي • ‎پښتو • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

Rozšíření umožňují upravovat vzhled i funkce systému MediaWiki.

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í

OOjs UI icon markup.svg Parserové značky

Parserové tagy (značky) rozšiřují vestavěné značení wiki o další možnosti, ať už jde o jednoduché zpracování řetězců nebo o úplné vyhledání informací.


Další informace o parser tags (značkách analyzátoru)

OOjs UI icon code.svg Funkce parseru

Funkce syntaktického analyzátoru jsou speciální syntaxe značek wiki, která může 'interagovat' s ostatními prvky wiki na stránce a poskytovat konkrétní výstup.


Další informace o parser functions (funkcích analyzátoru)

Plug-in Noun project 4032.svg Háčky

Háčky umožňují provádění vlastního kódu, když dojde k nějaké definované události (například uložení stránky nebo přihlášení uživatele).


Další informace o hooks (háčcích)

OOjs UI icon pageSettings.svg Speciální stránky

Speciální stránky jsou stránky, které jsou vytvořeny softwarem na vyžádání k provedení určité funkce.


Další informace o special pages (speciálních stránkách)

OOjs UI icon browser-ltr.svg Zobrazení

Vzhledy umožňují uživatelům přizpůsobit vzhled a dojem MediaWiki.


Další informace o skins (háčcích)

OOjs UI icon quotes-ltr.svg Kouzelná slova

Magická slova (Magic words) jsou technika pro mapování různých textových řetězců wiki na jediné ID, které je spojeno s funkcí.


Další informace o magic words (magických slovech)

API - The Noun Project.svg API

MediaWiki poskytuje akční API, webovou službu, která umožňuje přístup k některým funkcím wiki, jako je ověřování, operace se stránkami a vyhledávání.


Další informace o MediaWiki API

OOjs UI icon article-ltr.svg Modely obsahu stránky

ContentHandler představený v MediaWiki 1.21 umožňuje, aby wiki stránky byly složeny z dat jiných než wikitext, jako je JSON nebo Markdown.


Další informace o content models (modelech obsahu)

OOjs UI icon lock.svg Přihlášení

MediaWiki poskytuje SessionManager a AuthManager, dva rámce související s ověřováním, které zvyšují zabezpečení pomocí vlastních mechanismů ověřování.


Další informace o authentication (ověřování)

Procházení rozšíření

Můžete procházet Category:Extensions by category 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:

  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 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 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ářů.
  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 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í:

  1. Stáhněte novou verzi rozšíření
  2. 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
  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 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.
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í.
  • Pokud rozšíření poskytuje nějaké změny databáze, musíte je spustit update.php , abyste je odstranili.

Související odkazy