Extension:Quiz

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

Quiz Stav rozšíření: stabilní
Implementace	Značka , Háček
Popis	Poskytuje kvízový nástroj
Autoři	Lrbabediskuse
Nejnovější verze	1.2.0 (2015-12-08)
MediaWiki	1.25+
Použité háčky (hooks) ParserFirstCallInit
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
Příklad	and format documentation: v:Help:Quiz
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