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

Quiz Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Značka Category:Tag extensions/cs, Háček Category:Hook extensions/cs
Popis	Poskytuje kvízový nástroj
Autoři	Lrbabediskuse
Nejnovější verze	1.2.0 (2015-12-08)
MediaWiki	1.25+Category:Extensions with manual MediaWiki version/cs
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs
Příklad	and format documentation: v:Help:Quiz
Použité háčky (hooks) ParserAfterTidy Category:ParserAfterTidy extensions/cs ParserFirstCallInit Category:ParserFirstCallInit extensions/cs
Přeložte rozšíření Quiz, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření Quiz je nástroj pro vytváření kvízů přijatý na Wikiversity. Toto rozšíření si klade za cíl:

• Jednoduchá syntaxe i použití, ale výkonná ve svých možnostech.
• Otevřený návrhům a vylepšením (umožněním přidávání nových typů otázek).

Použití

• Vzdělávací projekt o kvízech na anglické Wikiverzitě
• Wikiversity:Help:Quiz – dokumentace k rozšíření kvízů (úplná) (na Wikiversity).
• Wikiversity:Help:Quiz-Simple – jednodušší a barevnější dokumentace určená pro začátečníky, mladší uživatele a kohokoli, kdo nepotřebuje plnou verzi (na Wikiversity).

Další stránky nápovědy jsou hostovány na Wikiverzitách, aby umožňovaly zobrazení funkčních příkladů.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Quiz 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/Quiz
  

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'Quiz' );
  

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

Vývoj

Přidání nového typu otázky

Kvíz byl navržen tak, aby usnadnilo přidávání nových typů otázek. Pokud vám základní typy (s výběrem z více možností s jednou/více odpověďmi) nestačí, máte možnost snadno si vytvořit a integrovat typ otázek, který potřebujete. K tomu musíte mít nějaké znalosti PHP.

1. První věc, kterou musíte udělat, je zvolit syntaxi (co nejjednodušší) pro váš typ otázky. Omezení jsou:
   • Syntaxe záhlaví otázky je pevně daná. Otázka musí být umístěna mezi složenými závorkami – tj. { a } .
   • Pro konzistenci se doporučuje použít || k označení začátku sekce zpětné vazby ("opravy").
2. Zvolte nový kódový název pro typ otázky (příklad: "questionTypeName") a také symbol (v současné době se pro s výběrem jedné odpovědi používá symbol (), protože vypadá jako přepínač, a pro s výběrem více odpovědí symbol [], protože vypadá jako zaškrtávací políčko).
   
3. Přidejte "case" na začátek "switch" (přepínač) proměnné parseParameters takto:

   case 'symbol':
   	$this->mType = "questionTypeName";
   	break;
   

4. Přidejte funkci parseru do Quiz.php
   Tato funkce musí převést objekt otázky ze syntaxe kvízu do HTML a nastavit otázce stav (správně, špatně, chyba, NENÍ k dispozici nebo neoznačeno) na základě syntaktických chyb a nakonec zveřejněných odpovědí. Pojmenujte funkci "questionTypeNameParseObject" a implementujte ji takto:

   /**
    * Převeďte základní objekt typu ze syntaxe kvízu do HTML.
    * 
    * @param  $input				Objekt otázky v syntaxi kvízu
    * 
    * @return $output				Objekt otázky v HTML.
    */
   function questionTypeNameParseObject($input) {
   	// váš kód zde.
   	$this->setState(""); // V případě potřeby nastavte stav.
   	return $output;
   }
   

5. Zapište si syntaktické specifikace, které budou přidány do nápovědy. Nejprve si prosím přečtěte existující nápovědu.
6. Jakmile tohle vše uděláte, kontaktujte mě, abych oficiálně zahrnul typ vaší otázky do rozšíření.

Související odkazy

• Extension:CIForms

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: Miraheze Category:Extensions included in Miraheze/cs MyWikisCategory:Extensions included in MyWikis/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.