Rozšíření FAQ

Stránka Special:Version na každé wiki obsahuje seznam rozšíření, která se sama zaregistrovala v softwaru MediaWiki . Všechna rozšíření lze nainstalovat bez zobrazení na Special:Version, pokud vývojář nezahrne správný kód, aby je tam uvedl.

U většiny rozšíření zkopírujte soubor (nebo adresář) rozšíření PHP do své složky extensions/ a přidejte do své složky LocalSettings.php následující příkaz, přičemž ExtensionName je název souboru vašeho rozšíření, například MyExtension.php.

require_once "extensions/ExtensionName/ExtensionName.php";

Od 1.25 (2015) existuje nový způsob instalace rozšíření, který funguje s rozšířeními podporujícími registraci rozšíření. Ekvivalent pro výše uvedené rozšíření by byl:

wfLoadExtension('ExtensionName');

Některá rozšíření však mají další kroky a/nebo jiné instalační postupy. Některá rozšíření budou obsahovat textový soubor s názvem README (někdy INSTALL), který bude obsahovat podrobnější informace o tomto rozšíření.

Podívejte se také na: Příručka:Rozšíření#Instalace rozšíření

Podívejte se na stránku Příručka:Vývoj rozšíření .

Pokud píšete např. special page:

global $wgOut;
$wgOut->enableClientCache(false);

Pro háčky značek analyzátoru:

function wfSomeHookFunction( $parser, $foo, $bar ) {
    $parser->getOutput()->updateCacheExpiry(0);
    ...
}

V případě, že výstup vašeho rozšíření závisí pouze na nějaké možnosti nebo uživatelském kontextu a ne na čase, můžete jej stále nechat uložit do mezipaměti analyzátoru, ale ujistěte se, že je označen jako jedna varianta výstupu (z mnoha možných). Použijte háček PageRenderingHash k odpovídajícímu ovlivnění mezipaměti hash.

Speciální stránky

Při vykreslování výstupu, který nebude podléhat mezipaměti analyzátoru, například na speciální stránce

global $wgOut;
$wgOut->parse( $text );

kde $text je wikitext, který má být analyzován.

Háčky analyzátoru

Podívejte se na stránku Příručka:Značky rozšíření#Jak vykreslím wikitext v mém rozšíření?

Nemůžeš. Dynamický obsah nelze zahrnout do statického indexu.

Viz Příručka:Rozšíření značek#Jak se mohu vyhnout úpravám výstupu HTML svého rozšíření?

Podívejte se na stránku Příručka:Rozšíření značek#Jak mohu do své značky rozšíření předat parametry ve stylu XML?

Podívejte se na stránku Příručka:Rozšíření značek#Rozšíření a šablony

Vaše rozšíření (nebo jiné nainstalované) možná používá funkci parse() místo recursiveTagParse(). Poté jej změňte na recursiveTagParse (pomocí analyzátoru uvedeného v parametru nebo $wgParser).

Použijte třídu Title a metodu isProtected( ), např.

function extensionFunction() {
   # Předpokládejme, že $title je objekt title
   if( $title->isProtected( 'edit' ) ) {
      # Chráněno před úpravami, dělejte jiné věci
   } else {
      # Nechráněno před úpravami
   }
}

Všechny skripty ve struktuře /wiki musí být čitelné a spustitelné uživatelem, pod kterým PHP běží. Všechny perm jsou obvykle 755 a vlastník/skupina je jiný uživatel. Soubor LocalSettings.php je vytvořen skriptem při instalaci a bude tedy příkladem nastavení zbytku.

Podívejte se na stránku Příručka:Vývoj rozšíření#Registrace funkcí s MediaWiki