Fórum:UploadForm.js (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 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 š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:

// Pole "Popis"
var popisek_popis = "Popis:";
var napoveda_popis = "";

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:

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

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:

* Název šablony | Text zobrazený v menu

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 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í.