Template:Extension/cs

  {{Documentation|content= {{intricate template}} {{lua|Module:Extension|Module:ExtensionJson|Module:String}} {{Uses TemplateStyles|Template:Infobox/styles.css|Template:Extension/styles.css|Template:Extension/status.css}} Tato šablona by měla být přidána na všechny stránky rozšíření na této wiki (ale pouze na hlavní stránku). Přidá užitečný infobox (viz níže) a automaticky přidá rozšíření na {{ll|Category:All extensions}}, spolu s příslušnými kategoriemi {{ll|Category:Extensions by status|status}} a {{ll|Category:Extensions by implementation type|typ implementace}}.

{{Clear}}

Použití


Obsah parametrů
Tato část popisuje parametry, kterými se řídí obsah infoboxu. Nápovědu k templatemode a dalším kontrolním parametrům najdete v parametrech kontroly. . Jakákoli jiná hodnota pro 'type' je neplatná a způsobí umístění přípony do Category:Extensions with invalid or missing type.
 *  - vlastní parametrizované označení šablony, např.
 *  - vlastní značkování XML, např. 
 *  - vlastní neparametrizované označení šablony, např.
 *  - rozšíření, která přidávají nestandardní syntaxi wiki (tj. not značky, funkce analyzátoru nebo proměnné).
 * - všehochuť pro, tj. rozšíření, která vytvářejí, ověřují, udělují oprávnění, odvolávají oprávnění nebo sledují aktivitu uživatelů. Pokud jste napsali rozšíření o přístupu, použijte jeden z následujících konkrétnějších typů:
 * - rozšíření, která monitorují aktivitu uživatelů (přihlášení, odhlášení, vytváření nových uživatelů atd.)
 * - rozšíření, která vytvářejí a odstraňují uživatele anebo ověřují totožnost uživatele
 * - rozšíření systému správy práv, např. změny způsobu přiřazování práv, API, nástrojů údržby (nezahrnuje rozšíření, která pouze pojmenovávají práva potřebná k použití funkcí tohoto rozšíření. Pro tento účel použijte parametr oprávnění).
 * - všehochuť pro nezařazená rozšíření uživatelského rozhraní.
 *  - rozšíření, která umožňují vkládání multimediálního obsahu na wiki stránky registrací přípony souboru u.
 *  - rozšíření, která poskytují infrastrukturu, takže uživatelé si mohou přizpůsobit své zkušenosti s MediaWiki anebo pomáhat při správě této infrastruktury.
 * - rozšíření, která odesílají emaily uživatelům, vysílají zprávy a poskytují další formy oznámení komunity.
 *  - rozšíření, která vylepšují nebo upravují . To zahrnuje vše, co implementuje akci, která čte, zapisuje, vyhledává, vytváří, přejmenovává, vymaže, přesměruje nebo diskutuje o stránce. Nezahrnuje práva (použijte user rights) ani protokoly (použijte user activity).
 * - rozšíření, která prohledávají a vybírají stránky pro uživatele.
 * - rozšíření přidávající CSS nebo JavaScript nebo implementace funkcí háčků pro změnu vzhledu a pocitu MediaWiki prostřednictvím rámce zobrazení.
 * - rozšíření, která používají programovací techniky Ajax.
 * - rozšíření, která v podtřídě, používají jeden z jejích háčků nebo opravují jednu nebo více funkcí v . Další informace naleznete v příručce.
 * other
 * - rozšíření, která přidávají nový modul API nebo rozšiřují základní modul API.
 * - háčkové rozšíření - definuje new (nový) háček - viz hook1 atd. níže. Pokud chcete definovat háčky used (používané) vašim rozšířením.
 * - přidá tabulky anebo pole do databáze podporující instalaci MediaWiki.
 * - Vytahování dat.
 * - přípona, která přidá nové typy úložišť souborů jako backend (v pozadí) souboru.
 * - není to skutečné rozšíření, ale příklad toho, jak ho napsat.
 * - rozšíření nové.
 * - rozšíření základního programovacího jazyka.
 * - rozšíření spojená s místním určením
 * - rozšíření spojená s místním určením

Poznámka: Mnoho rozšíření má více než jeden typ, pokud se to týká vašeho, nahraďte  hodnotou. Pro rozšíření můžete definovat až šest typů. hook1 hook2 hook3 hook4 ... háčky používané rozšířeními Zadání hodnot do tohoto pole je dobrým způsobem, jak získat další rozšíření pro vaše rozšíření a jak pomoci ostatním vývojářům. Každý dokumentovaný háček automaticky přidá rozšíření do seznamu kategorií rozšíření, které tento háček používají. Tato kategorie je automaticky propojena do každé stránky s háčky, aby programátoři snadno našli příklady rozšíření, která používají konkrétní háček.

Pro vestavěné háčky:
 * použijte název háčku samostatně. Hodnoty najdete v příručce (ale vynechejte úvodní '/').

Pro vlastní háčky definované rozšířeními:
 * použijte extensionName/hookName. Pro seznam vlastních háčků viz Extension hook registry.

U více háčků přiřaďte první háček k hook1, druhý k hook2 atd. newhook1 newhook2 newhook3 newhook4 ... newhook90  název každého háčku poskytnutého rozšířením

Možná budete chtít přidat háčky do Extension hook registry. username  Uživatelské jméno autora na MediaWiki.org (pokud jej má). Může být vynechán, ale bude-li přítomen, bude použit k propojení s autorovou stránkou a stránkou user_talk. Měl by být poskytován bez jmenného prostoru a bez. Jméno autora rozšíření, pokud se liší od uživatelského jména MediaWiki.org. Libovolný text. Pokud je vynecháno, bude použito pole 'uživatelské jméno' (username) (pokud existuje). description  Stručný popis Snímek obrazovky nebo logo rozšíření. Měl by být poskytován bez jmenného prostoru a bez. Nepovinné, velikost obrázku bez přidání px, např. 360 (výchozí velikost je 300px) Poslední verze Datum poslední aktualizace náhledová verze datum poslední aktualizace na náhledovou verzi compatibility policy   (akceptované hodnoty: master, main, rel, ltsrel). Vyžaduje MediaWiki verze. Většina rozšíření by toto neměla používat – výchozí je hodnota vlastnosti. Viz také a. Vyžaduje PHP verze Parametr  označuje, že rozšíření vyžaduje změnu schématu databázové tabulky nebo podobnou akci, dříve než bude MediaWiki spuštěna. Jedná se o běžné úskalí: Vaše MediaWiki se zastaví, pokud jste zapomněli spustit update.php - pokud to rozšíření vyžaduje. Parametr  by měl být nastaven jako vstupní hodnota, protože tím se zajistí, že rozšíření nevyžaduje spuštění update.php. Tak se vyhýbá nejistotě.

Rozšíření, která odpovídají standardům rozšíření MediaWiki, přicházejí se záznamem změny schématu, který musíte spustit ručně před spuštěním (jednou) a přístupem k MediaWiki přes prohlížeč poté, co zkopírujete všechny přípony do  a vložíte   do "LocalSettings.php", spusťte z příkazového řádku:

composer  Název balíčku rozšíření Composer ve [standardním formátu https://getcomposer.org/doc/04-schema.md#name]. Bude automaticky zahrnut, pokud je nastaven v souboru rozšíření "composer.json" (tj. v takovém případě tento parametr není povinný). Bude propojeno se stránkou rozšíření na Packagist. table1 table2 table3 table4 ... table30  Název každé tabulky bez jádra, kterou používá rozšíření.

Odkazy na podstránku vaší stránky rozšíření. Například "table1 = cu_changes" na bude odkazovat na. Nezahrnujte základní tabulky, jako jsou nebo. Zadávejte pouze seznam tabulek, které jsou přidány pomocí rozšíření. Licence upravující použití tohoto rozšíření, jako jeden z kódů nalezených v https://spdx.org/licenses/, např. ,  nebo   atd. download  Odkaz na stažení: Git, WikimediaDownload. repo  Jméno repozitáře spravovaného přes Gerrit, ve kterém je uložen kód rozšíření, pokud se liší od jména rozšíření. Jeho nastavením se automaticky nastaví také hodnota download. Ta umožní, aby si šablona stáhla další parametry ze souboru. Externí odkaz na soubor readme, např. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README Externí odkaz na soubor se záznamy o všech výrazných změnách, např. Extension:XGlossary/Changelog Odkaz na uživatelskou nápovědu pro rozšíření. If not provided, will look for. Pokud je uveden, měl by být uveden úplný wikitextový odkaz (protože možná budete chtít odkazovat např. na externí stránku). Příklad, web nebo snímek rozšíření pracovní obrazovky Jmenný prostor, ve kterém je tato přípona použita Dostupné parametry pro LocalSettings.php Všechny značky, které vaše rozšíření používá (např. &lt;tag1&gt;, &lt;tag2&gt;). Práva přidaná rozšířením. Nesmí být zaměňována s licencí! Práva jsou například ' nebo '. Ne jako GFDL nebo LGPL nebo GPL - to jsou licence! Další informace o kompatibilitě, například grafy kompatibility. Doporučujeme sem přidat jakékoli informace o kompatibilitě na straně klienta, zejména při odklonu od očekávání plné podpory prohlížeče. Název komponenty rozšíření Bugzilla MediaWiki Název projektu Phabricator Volitelný parametr pro propojení přesné stránky, na které (skupině zpráv id) bude rozšíření přeložitelné na translatewiki.net, pokud je povoleno. Pokud je výchozí odkaz nesprávný, nastavte jej ručně na: Role
 * ext-LOWERCASE malá písmena (NOSPACES (Label definovaný v )), neboli
 * parametr, který dostanete po URL
 * zadáním názvu přípony do vyhledávacího nebo filtrovacího pole na translatewiki:Special:Translate nebo
 * hledáním názvu v languagestats po kliknutí na "rozbalit vše" (expand all).

Přepíše název stránky použitý pro odkaz na kontrolu použití.



Kontrolní parametry
, protože se nejedná o skutečnou stránku rozšíření a tuto stránku nechceme přidat do žádných kategorií.
 * nousage - potlačí odkaz 'zkontrolovat využití'. Odkaz je také potlačen, pokud je stránka podstránkou, není v Extension: namespace nebo pokud je potlačeno 'templatemode=nocats'

Pokud toto políčko ponecháte prázdné, přidá tato šablona hostitelskou stránku do Category:All extensions a do jedné nebo více dalších kategorií v závislosti na hodnotách přiřazených parametrům obsahu.



Použití infoboxu


Na existující stránce k rozšíření
Pokud chcete přidat infobox na stránku, která již existuje, zkopírujte do ní výše uvedený kód.



Založení nové stránky rozšíření
Pokud chcete přidat stránku rozšíření, které zde dosud svoji stránku nemá, napište do níže uvedeného vstupního pole formuláře jeho název a klikněte na tlačítko. Tím dojde k založení nové stránky, která již bude tuto informační šablonu obsahovat.



Doplnění šablony o další položky
Pokud byste chtěli tuto šablonu vylepšit, děkujeme! Jedná se o komplikovanou šablonu, takže zde je trochu nápovědy:



Tlačítko Create extension (vytvořit rozšíření)
Chcete-li zlepšit chování tlačítka pro vytvoření rozšíření:


 * : Rozšíření podkladu, který je předem načten do nově vytvořené stránky.
 * : Vstupní pole, které lze vložit kamkoli chcete, aby uživatelé snadno vytvářeli rozšíření. Dokumentaci o značce naleznete na adrese.



Parametry Infoboxu
Obecně:


 * Aby bylo použití této šablony snadné, je každý štítek v infoboxu spojen s dokumentací o parametrech šablony, které se zobrazí. Pokud přidáte parametr, nezapomeňte jej také přidat do dokumentace k obsahu parametrů a připojit jeho štítek k této dokumentaci.

Postup změny nebo opravy nebo přidání k parametrům typu implementace:
 * Podívejte se na diskusní stránku - v této oblasti došlo k rozsáhlým diskusím.
 * Použitelné hodnoty a to nač odkazují je definováno v Module:Extension

Chcete-li změnit chování parametrů háčku:


 * Template:Extension/HookInUse: Přidá odkazy a kategorie pro použitý háček. Používá se více háčků, které jsou implementovány voláním této šablony s Template:Foreach.
 * Template:Extension/HookInUseNoCats: Používá se místo Template:Extension/HookInUse, pokud je tato šablona použita v . Šablony používané s Template:Foreach mohou mít pouze jeden parametr, takže musíme zabalit volání do Template:Extension/HookInUse jinou šablonou, která nastavuje režim.

<span id="Test_case">

Zkušební případ
Po úpravě této šablony zkontrolujte, zda jsou následující stránky v pořádku.
 * Extension:Description2
 * Template:Extension

}} Maintenance: vulnerabilities, archived