Extension:Quiz

Manuel des extensions MediaWiki

Quiz État de la version : stable
Implémentation	Balise , Accroche
Description	Fournit un outil de quiz
Auteur(s)	Lrbabediscussion
Dernière version	1.2.0 (2015-12-08)
MediaWiki	1.25+
Accroches utilisées ParserFirstCallInit
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source
Exemple	and format documentation: v:Help:Quiz
Traduire l’extension Quiz sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension Quiz est l'outil de construction de quiz adopté sur Wikiversité. Cette extension vise à être :

• Simple dans sa syntaxe et son utilisation ; puissante dans ses possibilités.
• Ouverte aux suggestions et aux améliorations (en facilitant l'ajout de nouveaux types de questions).

Utilisation

• Projet d'apprentissage des quizz sur la Wikiversité anglophone
• Wikiversity:Help:Quiz – documentation pour l'extension quiz (complète) (sur Wikiversité).
• Wikiversity:Help:Quiz-Simple – une documentation plus simple et en couleur à destination des débutants, des utilisateurs plus jeunes et de toute autre personne qui n'a pas besoin de la version complète (sur Wikiversité).

Les autres pages d'aide sont hébergées sur les Wikiversités pour présenter les exemples opérationnels.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Quiz dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Quiz
  

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'Quiz' );
  

• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Développement

Ajouter un nouveau type de question

Quiz a été réalisé pour faciliter l'addition de nouveaux types de questions. Si les types de base (QCM avec une ou plusieurs réponses) ne vous suffisent pas, vous pouvez facilement créer et intégrer le type des questions dont vous avez besoin. Pour cela vous devez disposer de quelques connaissances en PHP.

1. La première chose à faire est de choisir la syntaxe (la plus simple possible) pour vos types de questions. Les restrictions sont :
   • La syntaxe de l'entête de la question a été corrigée. La question doit figurer entre accolades - c'est à dire { et } .
   • Par mesure de cohérence, il est recommandé d'utiliser || pour marquer le début de la section de commentaires ("correction").
2. Choisir un nouveau nom de code pour votre type de question (exemple : questionTypeName) en même temps qu'un symbole (actuellement le symbole () est utilisé pour une réponse unique de QCM car cela s'apparente à un bouton radio, et le symbole [] est utilisé pour les réponses multiples des QCM car cela s'apparente à des cases à cocher).
   
3. Ajouter un "case" au début du "switch" de parseParameters ainsi :

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

4. Ajouter une fonction d'analyse syntaxique à Quiz.php
   Cette fonction doit convertir un objet question de la syntaxe quiz vers HTML et initialiser l'état (bon, faux, erreur, non renseigné, absent) de la question (soit respectivement right, wrong, error, NA ou non marqué), en fonction des erreurs de syntaxe et éventuellement des réponses envoyées. Appelez la fonction "questionTypeNameParseObject" et codez-la ainsi :

   /**
    * Convertir un objet de type de base en syntaxe quiz vers HTML.
    * 
    * @param  $input				un objet question en syntaxe quiz
    * 
    * @return $output				un objet question en HTML.
    */
   function questionTypeNameParseObject($input) {
   	// mettre votre code ici...
   	$this->setState(""); // initialiser l'état si nécessaire
   	return $output;
   }
   

5. Écrivez ensuite vos spécifications de syntaxe, elles seront ajoutées à l'aide. Veuillez d'abord lire l'aide existante.
6. Une fois terminé, veuillez me contacter pour inclure officiellement votre type de question dans l'extension.

Voir aussi

• Extension:CIForms