Une architecture complète pour proposer des QCMs

All contributions published for previous SPIP versions

Architecture pour QCMs, réponses commentées et conservation des résultats sur la fiche auteur.

Le besoin a été exprimé sur la liste de façon récurrente. Des contributions ont déjà été proposées 1, 2. Celles-ci présentent deux types de limitations :
-  La seule interaction possible consiste à identifier la bonne réponse. Du coup il n’y a pas de possibilité de fournir des explications complémentaires, voire des liens vers des lectures évoluées ;
-  Le résultat ne peut être conservé dans la base de données pour fournir des indications sur la performance dans une matière.

Attention, la contribution a été modifiée pour être compatible avec la version 1.8.1. À cause de l’utilisation de la balise #ENV elle n’est plus utilisable avec la version 1.7.2 de SPIP.

Architecture

Pour permettre un maximum de possibilités, chaque exercice sera une sous-rubrique d’une rubrique dédiée. Ces sous-rubriques sont sélectionnées par le mot-clé “lesqcms”. L’énoncée constitue le descriptif de la sous-rubrique. Cette dernière contient deux types d’articles, différenciés par des mots-clés :
-  Les informations complémentaires (optionnelles) qui peuvent compléter l’énoncé, fournir des indices, etc, portent le mot-clé “complements” ;
-  Les questions à proprement parler, peu importe le nombre, dont la sélection se fait en ajoutant {doublons} par rapport aux compléments.

Le squelette d’affichage, le Questions_CM.html de la contrib, se présente en deux parties avec l’énoncée et informations complémentaires sur la gauche et les questions sur la droite. Les boucles sont dupliquées pour permettre éventuellement de regrouper les questions en catégorie (un seul niveau de profondeur est admis).

Les interactions

Le système est basé sur un seul formulaire en deux parties :
-  Un groupe de boutons radio pour choisir la réponse oui ou non (ou autre) à chaque question à l’intérieur d’une boucle articles {id_rubrique};
-  Une partie validation, avec un bouton submit et un reset.
Le champs action du formulaire mène au squelette d’affichage des résultats. Celui-ci ressemble au précédent mais contient les solutions et les messages concernant l’évaluation des réponses de l’utilisateur.

Le contrôle des résultats

Pour le bon fonctionnement du système il faut encore une fois respecter l’écriture des articles. Trois champs sont utilisés :
-  Le titre est la formulation de la question ;
-  Le texte fourni la solution ;
-  Le chapo, dont le contenu est optionnel, peut fournir des informations de contexte à afficher avant la question

Enfin, les valeurs vrai ou faux sont indiquées dans un champs-extra de type select, que l’on appellera choix.
Le script php qui contrôle les saisies utilisateurs (bouton radio sélectionné) et les compare avec la valeur du champs extra est simple. Il se trouve intégralement sur le fichier appelé par le formulaire, soit Questions_CM_vue.html. en voici un aperçu :

<? 
echo "Vous avez répondu : "; //Test sur les réponse entre la valeur du champs cache choix et la case a cocher
if ($_POST['l_#ID_ARTICLE'][0]==oui) {
echo "<span class=\"yourespond\">oui </span>";
}
else  {
echo "<span class=\"yourespond\">non </span>";
}
if ($_POST['l_#ID_ARTICLE'][0]==non && [(#EXTRA|extra{choix})]=='faux') {
echo "<span class=\"toutbon\">La réponse était bien non ! </span>";
$props++;
}
else if ($_POST['l_#ID_ARTICLE'][0]==oui && [(#EXTRA|extra{choix})]=='vrai') {
echo "<span class=\"toutbon\"> Bravo </span>";
$props++;
}
else if ($_POST['l_#ID_ARTICLE'][0]==non && [(#EXTRA|extra{choix})]=='vrai') {
echo "<span class=\"toutmauvais\"> Il fallait cocher </span>";
$erreurs++;
$props++;
}
else if ($_POST['l_#ID_ARTICLE'][0]==oui && [(#EXTRA|extra{choix})]=='faux') {
echo "<span class=\"toutmauvais\"> Mauvaise réponse </span>";
$erreurs++; //decompte des erreurs
$props++; //decompte des propositions
}
echo '<br>';
?>

Le passage de l’un à l’autre ne se fait pas par l’action du formulaire qui est laissée vide. Un champ spécifique du formulaire contient un paramètre important, “mode_affiche”, dont la valeur permet de changer de squelette (Questions_CM ou Questions_CM_vue).html, par le biais de la variable $fond du fichier .php3 (également inclus dans la distribution).

Conservation des résultats dans la base de données

Le fichier Questions_CM_vue.html contient également le fichier AddtoMycontrols.php3 (présent dans le .zip), dont la fonction est de conserver dans un champs extra de la fiche auteurs les identifiants (id_rubrique) des QCMs, séparés par une #. Le même fichier permet de stocker le % de réussite dans un autre champs de la table spip_auteurs. Le script est lancé à la validation du formulaire “Vous avez fini avec ce cas” sur la page des réponses. Pour l’utiliser il faut décommenter la ligne correspondante du squelette (ligne 234).

Un dernier préalable pour le bon fonctionnement : l’authentification de l’utilisateur

Celle-ci se fait grâce à un fichier.php, inclus dans les deux squelettes. Il ne sert qu’a tester si l’utilisateur est authentifié et affiche le nom de l’utilisateur dans un bandeau. Je vous laisse le choix de la limitation des droits aux rédacteurs ou aux visiteurs en remplaçant par exemple l’#URL_SITE_SPIP par #LOGIN_PUBLIC dans le fichier control_membre.php3.

Note de la fin : Un mini fichier .css fait partie de la distribution. Il n’est peut-être pas complet. Enfin l’adresse de retour une fois les réponses affichées (action du formulaire sur la page Questions_CM_vue.html) est mon_espace.php3, vous la remplacerez par celle qui correspond à votre site.

Vous devez créer les 3 champs-extras nécessaires : 2 sur la fiche auteur (les id_rubriques des QCMs et les % de réussite) et un sur article (pour le choix vrai ou faux).

Discussion

2 discussions

  • azerty


    [titre]
    l’énergie solaire photovoltaique

    [qcm]
    Q Les premiers panneaux photovoltaiques ont été utilisés dans l’industrie?
    P1 du batiment
    P2 aéronautique
    P3 spatiale
    P4 automobile
    R3

    [qcm]
    Q quand les premiers panneaux photovoltaiques sont-ils apparus?
    P1 1959
    P2 1973
    P3 1980
    P4 1990
    R2

    [qcm]
    Q les panneaux solaires photovoltaiques permettent de transformer la lumière du soleil en énergie?
    P1 mécacnique
    P2 électrique
    P3 thermique
    P4 hydraulique
    R2

    [qcm]
    Q les cellules photovoltaiques des panneaux solaires les plus répandus aujourd’hui sont composées d’un matériau semi-conducteur qui est?
    P1 l’uranium
    P2 le silicium
    P3 l’aluminium
    P4 le plastique
    R2

    [qcm]
    Q quel est le nom des particules de lumière qui heurtent la surface de la cellule photosensible?
    P1 les protons
    P2 les électrons
    P3 les photons
    P4 les neutrons
    R3

    [qcm]
    Q Pour un meilleur rendement du panneau photovoltaique, il faut?
    P1 de la luminosité
    P2 de la chaleur
    P3 du froid
    P4 de l’humidité
    R1

    [qrm]
    Q Quels sont les pays précurseurs dans la production d’énergie photovoltaique?
    P1 la France
    P2 l’Allemagne
    P3 le Japon
    P4 la Chine
    R2 R3

    Reply to this message

  • 2

    Tout d’abord merci beaucoup pour cette excellente contribution.
    Ayant eu quelques difficultés pour l’installer, je me propose d’ajouter quelques explications pour les débutants (sans parler de l’authentification et de la conservation des résultats que je n’utilise pas).

    En premier lieu, vous devez créer un groupe de mots-clés QCM (sur les rubriques et les articles) avec les deux mots clés “complements” et “lesqcms”.

    Puis créez un secteur (cad une rubrique à la racine) intitulé, par exemple, QCMS (pour la suite, je lui donne le numero 25) qui contiendra tous les questionnaires sous forme de sous-rubriques.

    Dans le fichier /ecrire/mes_options.php(3) (créez le fichier si nécessaire) ajoutez le code suivant :

     <?php
    $GLOBALS['champs_extra'] = Array (
    'articles'=>Array(
           "choix" => "select|propre|Réponse|vrai,faux"
            )
    );
    
    $GLOBALS['champs_extra_proposes'] = Array (
    'articles'=>Array(
            '25'=>'choix'    
     )
    );        
    ?>

    Créez à partir de votre squelette les fichiers rubrique-25.html et article-25.html pour l’affichage des questionnaires en ajoutant :

    <div id="mainqcm">
    <INCLURE(Questions_CM.php){id_rubrique}>        
    </div>        

    Vous pouvez enfin créer les sous-rubriques (vos questionnaires) en y associant le mot-clé “lesqcms” et contenant un article (facultatif) correspondant à l’énoncé avec le mot-clé “complements” et les articles sans mot-clé correspondants aux propositions pour lesquelles vous preciserez si elles sont “vrai” ou “faux”.

    J’ai aussi ajouté un tri {par date} pour les boucles artrac permettant ainsi d’ordonner les propositions.

    • bonjour, je suis débutant sous SPIP (moins de 1 mois). Mon site est hebergé chez free. j’ai installé spip v1.8.2.e avec le squelette sarka_spip-1.1.1 (spip/squelette-sarka-spip).
      Puis je utiliser cette contribution ?
      Ou copier les fichiers de la contrib : spip/squelette-sarka-spip ?
      habillage.css squelette-sarka-spip/styles.
      merci d’avance
      christian

    • Je ne sais trop quoi répondre, je ne connais pas sarka. Cependant, la contrib est basée sur des squelettes distincts, donc a priori pas de problème. Les .css permettent de gérer l’affichage ou non de certains champs. Par défaut il doivent être placés dans le même répertoire que les squelettes (html).

    Reply to this message

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite / PostgreSQL
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparait.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom