Zobrazení zdroje stránky Fórum:UploadForm.js (dokumentace)

__NOTOC__
[[Soubor:Crystal document.png|32px|Dokumentace]] Toto je krátká dokumentace ke skriptu [[MediaWiki:UploadForm.js]] pro správce. Kompletní dokumentaci naleznete v článku [[MediaWiki:UploadForm.js/dokumentace]].

== Základní informace ==
Skript [[MediaWiki:UploadForm.js]] přepisuje formulář na stránce [[Speciální:Upload|Načíst soubor]]. Jsou přidána pole '''popis''', '''zdroj''', '''autor''', '''datum''', '''licence''' a '''kategorie'''.

Skript skrývá či maže pole '''"Popis"''' původního formuláře, tlačítko '''"Načíst soubor"''' a řádek s '''[[MediaWiki:Edittools]]''' (které jsou nyní prázdné).

Je generováno nové tlačítko '''"Načíst soubor"''', které nejdříve spustí kontrolní a zpracovávací funkce a teprve potom formulář odešle na server.

Při odesílání jsou veškeré údaje zapracovány do [[Šablona:Soubor| šablony '''Soubor''']].

== Popisky a nápovědy ==

Na začátku skriptu jsou definovány některé popisky, které může uživatel s právy správce jednoduše měnit.

'''Příklad:'''
<source lang="javascript">
// Pole "Popis"
var popisek_popis = "Popis:";
var napoveda_popis = "";
</source>

Tato část kódu například definuje popisek a nápovědu k poli '''"Popis"'''. Pro změnu je nutné nový text vepsat do uvozovek. Chceme-li třeba změnit popisek z "Popis:" na "Popis souboru:" a přidat krátkou nápovědu, která se zobrazí pod zadávacím políčkem, upravíme kód takto:

<source lang="javascript">
// Pole "Popis"
var popisek_popis = "Popis souboru:";
var napoveda_popis = "Zde stručně popište soubor.";
</source>

== Přidání licence ==

Chceme-li přidat novou licenci do menu '''"Licence"''' ve formuláři, je nutno přidat řádek do [[MediaWiki:Licenses]] v následujícím formátu:
<pre>
* Název šablony | Text zobrazený v menu
</pre>
;Název šablony : Pro každou licenci je nutno vytvořit šablonu, v níž bude text nebo odkaz na licenci. Její název zde uvedeme bez jmenného prostoru.
;Text zobrazený v menu : Text, který se zobrazí v nabídce '''"Licence"''' ve formuláři.

== Použití a poznámky k verzi ==
Tento skript lze použít pouze v [[Special:Version|MediaWiki verze 1.22.0]]. Jiné verze mohou být (a také jsou) odlišné, používají jinou tabulku a poněkud jinak stavěný formulář.

Zároveň skript pracuje pouze tehdy, existuje-li stránka [[MediaWiki:Licenses]]. Pakliže by nebyly definovány licence v [[MediaWiki:Licenses]], formulář by se nezobrazil a nepracoval správně. Licence jsou zpracovávány složitěji a je nutné vždy zkontrolovat správnou funkčnost kódu, přídává nebo ubírá-li se některá licence ze seznamu.

V případě upgradu na vyšší verzi MediaWiki je proto nutno skript přepracovat, aby byl funkční.
[[Kategorie:Dokumentace]]