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
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
Čtvrtletní stahování	24 (Ranked 74th)
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. Choose a new code name for your question type (example: "questionTypeName") as well as a symbol (currently the symbol () is used for single response multiple choice because it looks like a radio button, and the symbol [] is used for multiple response multiple choice because it looks like a checkbox).
   
3. Add a "case" at the beginning of the parseParameters's "switch", as follows:

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

4. Add a parser function to Quiz.php
   This function must convert a question object from quiz syntax to HTML and set a state to the question (right, wrong, error, NA or unmarked), according to syntax errors and eventually posted answers. Name the function "questionTypeNameParseObject" and implement as follows :

   /**
    * Convert a basic type object from quiz syntax to HTML.
    * 
    * @param  $input				A question object in quiz syntax
    * 
    * @return $output				A question object in HTML.
    */
   function questionTypeNameParseObject($input) {
   	// your code here.
   	$this->setState(""); // Set the state if needed.
   	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.