Šablona:Rozšíření
![]() | This template employs intricate features of template syntax.
You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the general sandbox or your user space before changing anything here. |
![]() | Uses Lua: |
![]() | This template uses TemplateStyles: |
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 Kategorie:Všechna rozšíření , spolu s příslušnými kategoriemi status a typ implementace .
Použití
Zkopíruj a vlož: {{Extension |templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |needs-updatephp = |composer = |table1 = |table2 = |license = |download = |readme = |changelog = |example = |namespace = |parameters = |tags = |rights = |compatibility = |bugzilla = |phabricator = |vagrant-role = }}Jaký má být obsah parametrů, viz níže |
|
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 Kontrolní parametry.
Parametr | Popis |
---|---|
name | název rozšíření |
status |
aktuální stav vydání Jeden z:
Pokud je stav jiný než výše uvedený, bude ignorován a v šabloně bude místo toho zobrazena výchozí hodnota 'Neznámý' (Unknown). V případech, kdy je hodnota vynechána, bude kategorizována jako neznámý. V případech, kdy je hodnota neplatná, bude umístěna do speciální kategorie, aby mohla být chyba zachycena a opravena. |
type1 type2 type3 type4 type5 type6 | typ uskutečnění
Implementační strategie použité při budování tohoto rozšíření. Tento parametr se používá k vytváření kategorií, které pomáhají programátorům najít příklady různých implementačních strategií nebo vzorců MediaWiki. Ačkoli se hodnoty tohoto parametru někdy shodují s případem použití nebo účelem rozšíření, není to důvod tohoto parametru. Pokud hodnoty, které jste pro tento parametr vybrali, dostatečně neidentifikují požadavky nebo účel nebo možné použití, doporučujeme přidat další odkazy na kategorii podle potřeby. Povolené hodnoty pro parametry type1, type2, ... jsou:
Jakákoli jiná hodnota pro 'type' je neplatná a způsobí umístění přípony do Category:Extensions with invalid or missing type/cs. Poznámka: Mnoho rozšíření má více než jeden typ, pokud se to týká vašeho, nahraďte|type= hodnotou |type1=|type2=|type3=... . Pro rozšíření můžete definovat až šest typů. |
hook1 hook2 hook3 hook4 ... |
použité háčky
Zadání hodnot do tohoto pole je dobrým způsobem, jak získat rozšíření pro vaše rozšíření a pomoci ostatním vývojářům. Každý dokumentovaný háček automaticky přidá rozšíření k rozšíření o seznam kategorií, která tento háček používají. Tato kategorie je automaticky propojena do každého článku 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:
Pro vlastní háčky definované rozšířeními:
|
newhook1 newhook2 newhook3 newhook4 ... newhook90 |
použité háčky Možná budete chtít přidat háčky k Extension hook registry. |
username | Uživatelské jméno autora na MediaWiki.org (pokud je 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 |
image | snímek obrazovky, nebo logo rozšíření Měl by být poskytován bez jmenného prostoru a bez [[]]. |
imagesize | fakultativní, velikost obrázku (výchozí velikost je 220px) |
version | poslední verze |
update | datum poslední aktualizace |
compatibility policy | zásady kompatibility (akceptované hodnoty jsou master, rel a ltsrel). (nedodělávky ) |
mediawiki | vyžaduje MediaWiki verze |
php | vyžaduje PHP verze |
needs-updatephp | yes označuje, že rozšíření vyžaduje změnu schématu databázové tabulky nebo podobnou akci 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. no by měla být nastavena jako hodnota, protože to zajišťuje, že rozšíření nevyžaduje spuštění update.php, a tím se vyhne nejistotě
Rozšíření, která odpovídají standardům rozšíření MediaWiki, přicházejí se skriptem 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 cd path/to/wiki_install_directory cd maintenance php update.php $IP stands for the Installation Path (or "directory") of your MediaWiki installation, the same directory that holds LocalSettings.php , index.php etc.. |
composer | Pokud je to možné, je třeba zadat jméno "dodavatele" (vendor) a "balíček" (package) ve formátu vendor/package , např. mediawiki/semantic-media-wiki pro přímé nasměrování lidí na packagist.org, který slouží jako archiv balíčku. |
table1 table2 table3 table4 ... table30 | název každé tabulky bez jádra, kterou používá přípona Odkazy na podstránku vaší stránky rozšíření. Například "table1 = cu_changes" na Extension:CheckUser bude odkazovat na Extension:CheckUser/cu_changes table . Nezahrnujte základní tabulky, jako je page nebo revision ; pouze seznam tabulek, které jsou přidány pomocí rozšíření. |
license | licence upravující použití tohoto rozšíření, jako jeden z kódů nalezených v https://spdx.org/licenses/, např. GPL-2.0-or-later , GPL-2.0-only nebo GPL-3.0-or-later atd. |
download | odkaz na stažení : Git, {{WikimediaDownload/cs}}. |
repo | Name of the Gerrit repository the extension's code is stored in, if different from the page name. Setting this automatically sets |download= , and allows the template to automatically load data from the appropriate extension.json file. |
readme | externí odkaz na soubor readme, např. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | externí odkaz na soubor changelog, např. Extension:LDAP Authentication/Changelog |
parameters | dostupné parametry pro LocalSettings.php |
všechny značky, které vaše rozšíření používá (např. <tag1>, <tag2>). | |
rights | práva přidaná rozšířením. Nesmí být zaměňována s licencí! Práva jsou například makebot nebo desysop . Ne jako GFDL nebo LGPL nebo GPL - to jsou licence! |
namespace | jmenný prostor, ve kterém je tato přípona použita |
example | příklad, web nebo snímek rozšíření pracovní obrazovky |
compatibility | Další informace o kompatibilitě, například grafy kompatibility (dříve pomocí Template:Extension Testing). 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. |
translate | Volitelný parametr pro propojení přesné stránky, na které (skupina zpráv id, se kterou) bude rozšíření přeložitelné na translatewiki.net, pokud je povoleno. Pokud je výchozí odkaz nesprávný, nastavte jej ručně na:
|
bugzilla | Název komponenty Bugzilla MediaWiki |
phabricator | Název projektu výrobce |
CheckUsageNameOverride | přepíše název stránky použitý pro odkaz použití kontroly. |
Kontrolní parametry
Parametr | Popis |
---|---|
templatemode | Řídí automatickou kategorizaci hostitelské stránky.
Normálně ponecháno prázdné. Alternativní hodnoty jsou:
|
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 k rozšíření
Pokud chcete přidat stránku k 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.
A developer sharing their code in the MediaWiki code repository should expect:
- Feedback / Criticism / Code reviews
- Review and comments by other developers on things like framework use, security, efficiency and usability.
- Developer tweaking
- Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
- Improved access for wiki sysadmins
- If you do decide to put your code on the wiki, another developer may decide to move it to the MediaWiki code repository for easier maintenance. You may then create a Vývojářský účet to continue maintaining it.
- Future versions by other developers
- New branches of your code being created automatically as new versions of MediaWiki are released. You should backport to these branches if you want to support older versions.
- Incorporation of your code into other extensions with duplicate or similar purposes — incorporating the best features from each extension.
- Credit
- Credit for your work being preserved in future versions — including any merged extensions.
- Similarly, you should credit the developers of any extensions whose code you borrow from — especially when performing a merger.
Any developer who is uncomfortable with any of these actions occurring should not host in the code repository. You are still encouraged to create a summary page for your extension on the wiki to let people know about the extension, and where to download it.
Doplnění této š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 Vytvořit rozšíření
Chcete-li zlepšit chování tlačítka vytvořit rozšíření:
- Template:Extension/Sample : Rozšíření obalové desky, které je předem načteno na nově vytvořené stránky.
- Template:Extension/CreateExtensionInputBox : Vstupní pole, které lze vložit kamkoli chcete, aby uživatelé snadno vytvářeli rozšíření. Dokumentaci o značce
<inputbox>
naleznete na adrese Extension:InputBox .
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 parametrům obsahu a připojit jeho štítek k této dokumentaci.
Postup změny / opravy / 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.
- The valid types and what they link to are defined at 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, když je tato šablona použita v
templatemode=nocats
. Š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.
Zkušební případ
Po úpravě této šablony zkontrolujte, zda jsou následující stránky v pořádku.
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived