Příručka k rozšířením MediaWiki

InputBox Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Značka Category:Tag extensions/cs, Akce stránky Category:Page action extensions/cs, HledáníCategory:Search extensions/cs
Popis	Umožňuje uživatelům přidat předdefinované HTML formuláře do wiki stránek
Autoři	Erik Möller Leonardo Pimenta Rob Church Trevor Parscal Daniel Schuba
Nejnovější verze	Continuous updates
MediaWiki	>= 1.44
Změny v databázi	Ne
Licence	Licence MIT
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs
Značky <inputbox>
Použité háčky (hooks) MediaWikiPerformAction Category:MediaWikiPerformAction extensions/cs ParserFirstCallInit Category:ParserFirstCallInit extensions/cs SpecialPageBeforeExecute Category:SpecialPageBeforeExecute extensions/cs
Čtvrtletní stahování	157 (Ranked 29th)
Veřejné wiki používající rozšíření	10,897 (Ranked 10th)
Přeložte rozšíření InputBox, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření InputBox přidává již vytvořené formuláře HTML do wiki stránek. Uživatelé mohou "doplnit" formulář (vkládání textu, vybírání položek z menu atd.) vložením textu do políčka.

InputBox byl původně vytvořen uživatelem Erik Möller z důvodu přidání pole Vytvořit článek do Wikinews.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného InputBox ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/InputBox
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'InputBox' );
  

• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Příklad

Formulář pro založení nového článku.

<inputbox>
type=create
width=30
break=no
</inputbox>

Obecná skladba

Input boxy jsou konstruovány třeba takto:

<inputbox>
type=
bgcolor=
width=
page=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
fulltextbutton=
labeltext=
break=
namespaces=
prefix=
placeholder=
minor=
nosummary=
summary=
id=
inline=
dir=
preloadparams[]=
searchfilter=
useve=
usedt=
arialabel=
</inputbox>

Parametr type je povinný. Všechny ostatní parametry jsou nepovinné. preloadparams[] se mohou objevit více než jednou.

Typy boxů

Výchozí umístění tlačítek "Odeslat" je pod vstupním polem.

Tlačítko "Odeslat" lze přesunout doprava pomocí parametru zalomení řádku, čímž se odstraní zalomení řádku mezi rámečkem a tlačítkem: break=no.

Tlačítko "Odeslat" vpravo je užitečné pro vyhledávací pole, kdy by návrhy vyhledávání jinak zakryly tlačítko vyhledávání pod vyhledávacím polem.

Pro type=search2 je výchozí umístění tlačítka vyhledávání vložené vpravo. V současné době se nezdá, že by bylo možné do tohoto typu vstupního pole přidat další parametry. Toto vyhledávací pole prohledává celou wiki, na které je umístěno.

Parametry

<inputbox>
type=search
arialabel=Search the Wiki
</inputbox>

<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>

<inputbox>
type=create
width=24
</inputbox>

<inputbox>
type=comment
default=User talk:Eloquence
</inputbox>

<inputbox>
type=create
preload=Log
</inputbox>

<inputbox>
type=comment
editintro=MediaWiki:Missingcommenttext
</inputbox>

<inputbox>
type=comment
buttonlabel=Přidání nového zdroje
</inputbox>

<inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:InputBox
buttonlabel=Napište komentář na diskusní stránce
</inputbox>

<inputbox>
type=search
searchbuttonlabel=Hledej hlouběji
</inputbox>

<inputbox>
type=search2
searchbuttonlabel=Hledej hlouběji
fulltextbutton=true
</inputbox>

<inputbox>
type=search2
searchbuttonlabel=Hledej hlouběji
labeltext=Hledat: 
</inputbox>

<inputbox>
type=create
width=24
break=no
</inputbox>

<inputbox>
type=search
namespaces=Main**,Help
</inputbox>

<inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox>

<inputbox>
type=search
placeholder=Prohledejte tuto wiki
</inputbox>

<inputbox>
type=comment
page=Project:Sandbox
</inputbox>

<inputbox>
type=comment
page=Project:Sandbox
minor=true
</inputbox>

<inputbox>
type=commenttitle
page=Special:Mypage/inputbox test
nosummary=true
</inputbox>

<inputbox>
type=create
default=Special:Mypage/inputbox test
summary=Foo
</inputbox>

<inputbox>
type=comment
page=Project:Sandbox
summary=Foo
id=bar
</inputbox>

Zde je text: <inputbox>
type=search2
inline=true
width=10
</inputbox>

<inputbox>
dir=rtl
type=comment
page=Project:Sandbox
summary=Foo
</inputbox>

<inputbox>
type=create
preload=Log
preloadparams[]=param1
preloadparams[]=param2
</inputbox>

<inputbox>
type=search
searchfilter=insource:foo
</inputbox>

<inputbox>
type=create
break=no
useve=true
</inputbox>

<inputbox>
type=commenttitle
page=Project:Sandbox
usedt=true
</inputbox>

Použití create na existující stránku jednoduše poskytne editační stránku. V takovém případě je preload ignorován. Použití comment pro novou stránku funguje.

Texty převzaté z jmenného prostoru MediaWiki: jsou samozřejmě pouze příklady, pro editintro nebo preload lze použít jakoukoli existující stránku. Bohužel preload zatím nefunguje pro souhrn Upload.

Zarovnání

Pokud chcete vytvořit vstupní pole na pravé straně stránky, udělejte něco jako:

<div style="float:right; width:42em">
<inputbox>
type=create
</inputbox>
</div>

Dává:

Funkce parseru

Použití InputBox v šabloně

Aby bylo možné vytvořit mnoho podobných vstupních polí, lze InputBox použít v šabloně. Předávání parametrů šablony parametrům InputBox však funguje pouze v případě, že je značka ‎<inputbox>...‎</inputbox> zapsána jako {{#tag:inputbox | ...}} uvnitř šablony.

Následující příklad je šablona pro vytvoření nové stránky wiki z pojmenované šablony:

{{#tag:inputbox |
type=create
buttonlabel=Vytvořit nový {{{1|článek}}}
preload={{{2|Template:Article}}} }}

Při vytváření instance šablony první parametr udává položku, která je vytvořena (výchozí: article), jak je uvedeno v tlačítku, druhý parametr udává název šablony použité k vytvoření položky (výchozí: Template:Article).

Například kód pro vstupní pole pro vytvoření nového projektu ze šablony projektu může vypadat takto:

{{Template:CreateNew|project|Template:Project}}

Související odkazy

• Extension:Create Page

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: BlueSpice Category:Extensions included in BlueSpice/cs Canasta Category:Extensions included in Canasta/cs Debian Category:Extensions available as Debian packages/cs Fandom Category:Extensions included in Fandom/cs Miraheze Category:Extensions included in Miraheze/cs MyWikisCategory:Extensions included in MyWikis/cs ProWikiCategory:Extensions included in ProWiki/cs semantic::coreCategory:Extensions included in semantic::core/cs ShoutWiki Category:Extensions included in ShoutWiki/cs TelepediaCategory:Extensions included in Telepedia/cs wiki.gg Category:Extensions included in wiki.gg/cs WikiForgeCategory:Extensions included in WikiForge/cs Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.