Les items

On appellera item un ensemble d'informations se rapportant à une interrogation. Un item contiendra plusieurs lignes dont le nombre variera en fonction du type d'interrogation. Dans la version 2.20 il existe 6 types de question :

Quel que soit le type d'interrogation, les deux premières lignes seront toujours les mêmes :

Les autres lignes dépendront du type de question. Il pourra y avoir selon les cas, une proposition par ligne ou des listes de propositions. On appellera liste de propositions une ligne sur laquelle les propositions seront écrites les unes à la suite des autres et séparées entre elles par des virgules. Chaque type d'item répertoriera les lignes qui le composent. Le séparateur des différentes propositions étant la virgule, il est fondamental que celles-ci ne contiennent pas ce caractère.

Les différents éléments d'une liste possèdent implicitement un numéro qui sera immuable : ce sera le numéro d'ordre dans la liste. Pour la liste "Balzac,Emile Zola,Jean-Jacques Rousseau,Lamartine,Montaigne,Victor Hugo", les différents éléments auront les numéros suivants :

  1. Balzac
  2. Emile Zola
  3. Jean-Jacques Rousseau
  4. Lamartine
  5. Montaigne
  6. Victor Hugo
Et s'il fallait ranger cette liste dans l'ordre alphabétique des noms de famille, la bonne réponse serait : 1,6,4,5,3,2

Les items seront séparés les uns des autres par une ligne vierge, une ligne blanche sans aucun caractère, hormis le code (invisible) produit par l'appui de la touche Entrée. Toutefois, il n'y aura pas de ligne vierge après le dernier item. En effet, la ligne vierge servant à séparer les items entre eux, le dernier item n'a pas besoin d'être séparé du suivant, inexistant. La dernière ligne du fichier qcm ne sera donc pas vierge. S'il y en avait une par erreur, cela ne provoquerait pas l'arrêt du script mais la classe d'objet compterait une question de plus qui ne serait pas affichée puisque l'item suivant n'aurait pas été rédigé mais qui pourrait fausser les résultats obtenus à cause du nombre erroné de questions. Bien que le nombre d'items ne soit pas limité, la limite sera ce qu'impose le raisonnable.

Voici à quoi pourrait ressembler un item dans le fichier questionnaire :
NB: les lignes grisées commençant par # ou ; sont des commentaires et seront ignorées

# Catégorie: Culture (1). QCMRM
; TCP/IP : Paul BARAN, Larry ROBERTS
; HTML : Tim BERNERS-LEE
; Netscape : Marc ANDRESSEN, Jim CLARK
1;1;2,5;3;
Parmi ces noms quels sont ceux qui ont participé à la création de TCP/IP
Marc ANDRESSEN
Paul BARAN
Tim BERNERS-LEE
Jim CLARK
Larry ROBERTS

et à l'affichage :

Les propriétés de l'item

Les propriétés d'un item sont indiquées dans la première ligne active de l'item (ligne non commentée) et contient 6 champs séparés entre eux par des points-virgule :

Exemple de ligne "propriétés" :     1;4;1,3,4,7;2;mm;http://www.etc...

1 Le premier champ des propriétés de l'item, indique le type d'item. Ici, type 1 soit QCMRM.
C'est ce champ qui détermine la présentation de la question et la manière de la corriger.
4 Le deuxième champ indique la catégorie de question. Si l'en-tête contenait :
  categories=Classique,Jazz,Gospel,Variétés
ce 4 désignerait ici la catégorie variétés.
Si le questionnaire ne contient pas de catégories de question, ce champ peut contenir un 0 ou être vide. Dans ce dernier cas, deux points-virgules se suivent.
1,3,4,7 Le troisième champ indique la bonne réponse. Parmi les propositions faites, il fallait cocher les propositions 1, 3, 4 et 7
Attention ! Dans le cas de réponses multiples (QCMRM, tris, appariements) il faut, pour que la question soit considérée comme bonne, que toutes les réponses y soient et, pour les tris, dans le bon ordre. Dans cet exemple si les propositions 1, 3 et 7 avaient été cochées, la réponse aurait été considérée mauvaise même si sur quatres réponses, trois avaient été bonnes : il aurait manqué le 4.
2 Le quatrième champ, ici un 2, indique le nombre de points qui seront attribués si la réponse est bonne ET si l'en-tête du questionnaire contient ponderation=1.Si la pondération n'est pas mise en oeuvre, 1 sera ajouté au nombre de bonnes réponses déjà enregistrées. Dans ce dernier cas, ce champ peut être vide puisque qu'on ne compte que le nombre de bonnes réponses et qu'on ne totalise pas les points.
mm Le cinquième champ contenant ici un 'mm' indique que l'item contient des documents multimédia (images, sons ou vidéos). Si l'item ne contient que du texte, ce champ sera vide.
http://www... Ce sixième champ contenant ici une URL indique l'adresse de la page qu'il faudra afficher si l'utilisateur clique sur le bouton "Apprendre" du questionnaire dans lequel la clef goal a été paramétrée pour l'apprentissage (goal=learn).

Autre exemple :     0;;2;;;     identique à     0;;2

Il signifie: Type 0 (QCMRU), pas de catégorie, la bonne réponse est la 2ème proposition, pas de point (on compte les bonnes réponses, donc pas de pondération), pas de multimédia.

Autre exemple :     1;;;;;http://fr.wikipedia.org/wiki/Honoré_de_Balzac

Il signifie: Type 1 (QCMRM), pas de catégorie, la bonne réponse ne sera pas prise en compte (c'est un questionnaire d'apprentissage), pas de point (on ne compte pas, donc pas de pondération), pas de multimédia, la page à afficher lors du clic sur "Apprendre" sera la page http://fr.wikipedia.org/wiki/Honoré_de_Balzac

Item type 0

Le type 0 est une Question à Choix Multiple et Réponse Unique (QCMRU)

Type 0
En-tête: categories=Histoire,Mathématiques,Français,Sciences
# QCMRU, catégorie : Mathématiques
; Euclide : géométrie, par deux points passe une droite et une seule
; Pythagore : dans un triangle rectangle, le carré de l'hypoténuse ...
; Thalès : les triangles semblables (théorème d'intersection)
0;2;3;1;
Qui a établi le théorème d'intersection ?
Euclide
Pythagore
Thalès

Les quatres premières lignes de l'item sont ici des commentaires. Ceux-ci peuvent servir au concepteur du test pour y placer ses notes, commentaires, objectif de la question, etc...

Une question de type Vrai/Faux n'est en fait qu'un QCMRU à deux propositions : Vrai et Faux

Type 0 (Vrai/Faux)
En-tête: categories=Histoire,Géographie,Français,Anglais
#QCMRU, catégorie : Géographie
; Faux
; Belgique : 30528 km2, 11.116.243 ha (2012), Bruxelles
; Suisse : 41285 km2, 8.036.917 ha (2013), Berne
0;2;2;1;
En superficie, la Belgique est plus grande que la Suisse.
Vrai
Faux

Lignes :

Item type 1

Le type 1 est une Question à Choix Multiple et Réponse Multiple (QCMRM). Plusieurs réponses peuvent donc être cochées.

Type 1
En-tête: categories=Culture,Réseau,Protocoles,Logiciels
# QCMRM, catégorie : Culture réseau 
; TCP/IP : Paul BARAN, Larry ROBERTS
; HTML : Tim BERNERS-LEE
; Netscape : Marc ANDRESSEN, Jim CLARK
1;1;2,5;2;
Parmi ces noms quels sont ceux qui ont participé à la création de TCP/IP
Marc ANDRESSEN
Paul BARAN
Tim BERNERS-LEE
Jim CLARK
Larry ROBERTS

Lignes :

Item type 2

Le type 2 est une question dans laquelle il faut trier des éléments (TRI)

Type 2
En-tête: categories=Histoire,Mathématiques,Français,Sciences
# TRI, catégorie : Histoire
; 30/05/1431 : Jeanne d'Arc brûlée vive à Rouen
; 22/09/1499 : Signature du traité de Bâle
; 14/09/1515 : Bataille de Marignan
; 13/04/1598 : Signature de l'Edit de Nantes
2;1;3,4,1,2;2;
Classez ces évènements dans l'ordre chronologique (1 = le plus ancien)
Bataille de Marignan,Edit de Nantes,Jeanne d'Arc brûlée à Rouen,Signature du traité de Bâle

Lignes :

Item type 3

Le type 3 est une question dans laquelle il faut associer des éléments (Appariement)

Type 3
En-tête: categories=Mathématiques,Littérature,Sciences,Musique
# ASSO, catégorie : Littérature
3;2;5,6,3,2;1;
Associez les titres suivants avec leurs auteurs respectifs
Les essais,Les misérables,Les rêveries du promeneur solitaire,Les Rougon-Macquart
Balzac,Emile Zola,Jean-Jacques Rousseau,Lamartine,Montaigne,Victor Hugo

Pour éviter que le hasard "fasse bien les choses", et donc pour mieux vérifier les connaissances, il est utile de placer des distracteurs. On appelle distracteurs les éléments qui ne seront pas associés aux autres. Dans l'exemple cité ci-dessus, Balzac et Lamartine seraient les distracteurs.

Lignes :

Item type 4

Le type 4 est une question dans laquelle il faut, grâce à un choix proposé, compléter une proposition (Complétion).
Par défaut, le caractère | marquera le point d'insertion de la liste d'éléments proposés. Si nécessaire, ce caractère d'insertion peut être changé dans l'en-tête grâce à la clef insertpoint

Type 4
En-tête: categories=Culture,Logiciels,Protocoles,Ports
# COMP, catégorie : Protocoles réseau
4;4;2;1;
Sélectionnez dans la liste la bonne réponse
Un serveur | attend les requêtes sur le port 3306
FTP,MySQL,POP,PostgreSQL,SMTP,Web

Lignes :

Item type 5

Le type 5 est une Question à Réponse Ouverte Courte (QROC). Elle est ouverte dans la mesure où il n'y a pas de proposition.
La zone de saisie et sa longueur seront définis par deux caractères d'insertion (ou celui défini dans l'en-tête à la clef insertpoint) entre lesquels un chiffre ou un nombre représentera la longueur de celle-là.

Type 5
En-tête: categories=Mathématiques,Littérature,Sciences,Musique
# QROC, catégorie : Littérature
5;2;laboureur;1;
Complétez ce vers de Jean de La Fontaine
Un riche |8|, sentant sa mort prochaine, ...

Il est possible de proposer un texte ou un mot dans la zone de saisie. Dans ce cas, placer ce mot ou ce texte entre les deux caractères d'insertion et après une virgule placée derrière le chiffre indiquant la longueur de la zone. Attention ! Ce mot disparaîtra automatiquement lorsqu'on placera la curseur dans cette zone.

Type 5
En-tête: categories=Grammaire,Sciences,Mathématiques,Musique
# QROC, catégorie : Grammaire
5;1;geignaient;1;
Mettre le verbe à l'imparfait de l'indicatif :
Parmi les vieux ormes de l'allée, certains |8,geindre| comme de malades (R. Escholier)

Lignes :

Les items multimédia

Un item sera dit "multimédia" s'il doit afficher une image, un son ou une vidéo dans la question ou dans les propositions qui seront faites. Si c'est le cas, le cinquième champ des propriétés de l'item contiendra l'indication "mm" pour préciser à la classe PHP qu'il y aura des documents spéciaux à afficher.

Le son à jouer peut être un fichier mp3 ; la vidéo à afficher peut-être une vidéo se trouvant sur YouTube, sur Dailymotion ou même vos propres vidéos pour peu qu'elles soient au format flv (Flash Vidéo). Si ce n'est pas le cas, vous pouvez convertir votre vidéo au format flv en utilisant l'excellent freeware FormatFactory.

Pour afficher un document multimédia il suffit d'indiquer sa référence dans une balise <# ... ... ... #> ; le code se trouvant juste après l'ouverture de la balise indiquera quel type de média afficher. Les   représentent les espaces à respecter.

On remplacera les points de suspension ci-dessus par la référence du document multimédia. La référence pourra être faite soit en indiquant son identifiant YouTube ou Dailymotion soit en indiquant le nom du fichier.

Exemple de vidéo Youtube (La partie de cartes) : http://www.youtube.com/watch?v=w8rXPeB8-DY ; l'identifiant est : w8rXPeB8-DY
Vous aurez à indiquer : <#yt w8rXPeB8-DY #>

Exemple de vidéo Dailymotion (Le Schpountz) : http://www.dailymotion.com/video/x8434s_schpountz-2-pagnol-fernandel_shortfilms ; L'identifiant est : x8434s_schpountz-2-pagnol-fernandel_shortfilms
Vous aurez à indiquer : <#dm x8434s_schpountz-2-pagnol-fernandel_shortfilms #>

Pour ce qui concerne les documents multimédia au format flv ou mp3, il suffira d'indiquer le nom du fichier (sans espace) s'il se trouve dans le même répertoire que le fichier qcm, ou son URL s'il se trouve sur une autre machine du réseau.

Enfin pour ce qui concerne l'insertion d'image, vous pouvez utiliser l'insertion simplifiée comme indiqué ci-dessus ou, pour ceux qui connaissent, la balise normale d'insertion d'image : <img src="nom-du-fichier-image.jpg">. Mais dans ce dernier cas (pour les images seulement), puisque vous prenez en charge vous-même l'écriture "normale" d'insertion des images, ce n'est pas la peine de demander à QCM Class de le faire à votre place. Vous n'avez donc pas à préciser le "mm" pour préciser à QCM Class qu'il y aura des documents multimédia, puisque vous l'avez fait à sa place.

Exemples :
<#flv idontwantalover.flv #>
<#mp3 http://www.qcmclass.fr/demos/chris-barber_hushabye.mp3 #>

Par ailleurs, si vous voulez afficher des fichiers flv, vous aurez besoin d'un player vidéo : dewtube.swf et si vous voulez jouer des fichiers audio mp3, vous aurez besoin d'un player audio : dewplayer.swf. Ils sont à placer, l'un, l'autre ou les deux selon vos besoins, sur le serveur dans le même répertoire que le fichier qcm.

Ces deux players sont disponibles en téléchargement dans le choix "Téléchargements" du menu ou sur le site original Alsacréations aux URLs suivantes : http://www.alsacreations.fr/dewtube.html et http://www.alsacreations.fr/dewplayer.html

Multimédia ou non, les items, quel qu'en soit le type, devront être rédigés selon des indications précédemment indiquées. Toutefois les documents multimédia (images, sons ou vidéos) ne pourront être placés que dans la question ou la consigne à respecter (2ème ligne) ainsi que dans les propositions fixes mais ne pourront pas être insérés dans les listes déroulantes

Exemples multimédias

Insertion de sons

Insertion sons
3;;4,3;1;mm
Associez les musiques ci-dessous avec leurs auteurs respectifs
<#mp3 k265.mp3 #>,<#mp3 tishomingo.mp3 #>
Louis Armstrong,Jean-Sebastien Bach,Chris Barber,Wolfgang Amadeus Mozart,Johan Pachelbel

06. Associez les musiques ci-dessous avec leurs auteurs respectifs
        
        

 

Insertion d'une vidéo YouTube

Insertion vidéo YouTube
1;;3,5;1;mm
Cochez les interprètes présents sur cet extrait d'Hôtel du Nord<br/><#yt JRn_EftE-r8 #>
Charles Dullin
Raimu
Louis Jouvet
Rina Ketty
Léonie Bathiat

08. Cochez les interprètes présents sur cet extrait d'Hôtel du Nord

         Charles Dullin
         Raimu
         Louis Jouvet
         Rina Ketty
         Léonie Bathiat

 

Insertion d'une vidéo flv

Un petit détail sur le player vidéo dewtube.swf : si, dans le même répertoire se trouvent un fichier vidéo flv et un fichier image de même nom (mais bien sûr avec des extensions différentes) et de mêmes dimensions, l'image sera affichée à l'emplacement de la vidéo et un clic sur cette image la fera disparaître en démarrant la vidéo. C'est le cas pour l'exemple suivant. Il y a la video idontwantalover.flv et l'image idontwantalover.jpg. Dimensions vidéo et image : 384 x 288. Comme dans l'exemple ci-dessous, l'image peut alors représenter la question elle-même.

Insertion video FLV
0;;4;1;mm
Répondez à la question ci-dessous en démarrant la vidéo puis en cochant la case appropriée<br/><#flv idontwantalover.flv #>
ABBA
ACDC
Indochine
Texas
The Corrs

02. Répondez à la question ci-dessous en démarrant la vidéo puis en cochant la case appropriée

         ABBA
         ACDC
         Indochine
         Texas
         The Corrs

 

Insertion d'images

Insertion d'image
categories=Mathématiques,Sciences,Français,Histoire
...
0;1;2;1;mm
<#img courbes.png #><br/>La fonction ayant un Δ > 0 est repésentée par la courbe
Jaune
Bleue
Magenta

Précision sur les ratios

Pour une vidéo, on appelle ratio le rapport réduit entre la largeur et la hauteur. Que les dimensions de la vidéo soient 400x300, 800x600, 40x30 le rapport entre ces deux dimensions, une fois simplifié, réduit, sera le même : 4/3. On dira que le ratio est de 4:3. Les dimensions différentes ne sont que des homothéties (agrandissements ou réductions qui conservent le même ratio).

Les vidéos placées sur Youtube ou Dailymotion sont en général au ratio 4:3. C'est la raison pour laquelle QCM Class affiche par défaut les vidéos au ratio 4:3 avec des dimensions 384x288. Si les vidéos que vous avez à utiliser sont à ce ratio là et que ces dimensions vous conviennent vous n'avez rien d'autre à préciser et l'indicateur d'un item contenant des documents multimédia sera -;-;-;-;mm

Changement de ratio

Vous pouvez utiliser vos propres vidéos flv et celles-ci peuvent avoir un ratio différent : 5:4, 4:3, 3:2 ou encore 16:9. Si dans un même questionnaire, toutes les vidéos sont au même ratio, vous pouvez, selon celles que vous utilisez, modifier les clefs youtube, dewtube ou dailymotion de l'en-tête en indiquant les valeurs des dimensions de vos vidéos :

youtube=700,420
dailymotion=500,400
dewtube=320,180

En revanche, si dans le même questionnaire vous utilisez des vidéos qui ont des ratios différents, il vous suffira de le préciser dans l'item affichant la vidéo au ratio différent, derrière l'indicateur de document multimédia. Le format est le suivant :

mm [deux points] largeur [lettre x minuscule] hauteur   Exemple : mm:700x420

Attention : Il vous revient d'indiquer les valeurs adéquates à vos vidéos. Si vous utilisez des dimensions qui ne sont pas en rapport avec le ratio de leurs vidéos, Youtube ou Dailymotion feront une homothétie et ajouteront des marges latérales plus ou moins larges pour conserver le ratio de la video qu'ils envoient.

dimensions standard (384x288) : mm

dimensions différentes : mm:384x150

En revanche, grâce au player vidéo dewtube vous pourrez afficher les vidéos avec les dimensions exactes que vous voulez. Toutefois, il n'y aura pas d'homothétie mais déformation. Choisissez-les donc avec soin.

dimensions normales 460x276) : mm:460x276

dimensions différentes : mm:460x100

Exemple d'item multimédia affichant une vidéo avec un ratio différent de 4:3

En-tête: categories=Mathématiques,Italien,Sciences,Musique
# QROC, catégorie : Italien
; Tiré du film : Dio come ti amo !
; Objectif : suivre et comprendre une conversation ou une chanson
; rondine: hirondelle ; rondini: hirondelles
5;2;rondini;1;mm:460x276
<#flv diocometiamo.flv #>
Gigliola Cinquetti evoca le |10| in questa canzone

Toutefois, les modifications de tailles n'auront aucun effet sur le player audio dewplayer ni sur les images qui resteront à leurs dimensions d'origine.

Mise à jour le 17/08/2022 à 18:59:01