Quizzes
Plate-forme de quizzes à choix multiples (QCM) avec interface d'analyse des résultats.
Technologies : Silex, Twig, Bootstrap, Composer, aucune base de données.
Sommaire
- Description
- Installation et configuration
- Captures d'écran
- Copyrights & licensing
- Change log
- Git branching model
Description
Deux zones
- L'une publique pour choisir un questionnaire, le dérouler et obtenir score et statistiques.
- L'autre avec mot de passe pour accéder aux sessions passées, à leur score et statistiques, à leur correction détaillée et au suivi temps réel des sessions en cours.
Questionnaires
La plate-forme de quizzes permet :
- d'héberger et proposer de multiples questionnaires,
- de proposer des sessions mélangeant plusieurs questionnaires,
- de réaliser des sessions ne portant que sur une partie des questions d'un ou plusieurs questionnaires, questions tirées aléatoirement,
- de désactiver voire masquer des questionnaires tout en continuant de les inclure dans d'autres questionnaires,
- une grande facilité d'ajout de questionnaires, coloration syntaxique des bouts de code pouvant émailler les questions et propositions de réponse,
- une impression du résultat des sessions.
Dans un questionnaire :
- chaque question appartient à un thème afin de faciliter l'analyse des réponses, mais cette information ne transparaît pas forcément dans l'énoncé des questions (un seul thème est retenu par question par souci de simplicité),
- thèmes, questions et propositions arrivent dans un ordre différent à chaque session,
- le temps restant est affiché constamment,
- pas moyen de revenir sur une question précédente (page précédente sans effet),
- le barème est optimal lorsque toute question admet au moins une bonne proposition et au moins une mauvaise proposition.
Barème
Le barème favorise l'absence de réponse à la mauvaise réponse. Il vaut mieux s'abstenir lorsque l'on n'est pas sûr de soi.
Ainsi de manière générale, si une question possède P
propositions de réponse, alors :
- chaque question nécessite de cocher
1
àP-1
cases et rapporte de-1
à1
point,0
si non répondue. - si une question requiert
N
cases cochées pour la bonne réponse, alors :- chaque case bien cochée rapporte
1/N
point, - chaque case mal cochée enlève
1/(P-N)
point.
- chaque case bien cochée rapporte
Il en découle que les trois stratégies suivantes aboutissent à un score nul :
- cocher toutes les cases,
- n'en cocher aucune
- et statistiquement cocher au hasard
1
àP-1
cases.
Installation et configuration
Git clone
Cloner dans le répertoire de votre choix, par ex. /var/www/quizzes
(le répertoire doit être vide) :
$ git clone git@github.com:Hi-Media/Quizzes.git /var/www/quizzes
Dépendences
Composer
La plupart des dépendences sont gérées par composer. Lancer l'une des commandes suivantes :
$ composer install
# or
$ php composer.phar install
Au besoin, pour installer composer localement, lancer l'une des commandes suivantes :
$ curl -sS https://getcomposer.org/installer | php
# or
$ wget --no-check-certificate -q -O- https://getcomposer.org/installer | php
Lire http://getcomposer.org/doc/00-intro.md#installation-nix pour plus d'informations.
Mailing
L'envoi de mail exploite mutt.
Configuration
Apache 2
Les rewrite rules sont nécessaires.
Un fichier .htaccess
se trouve dans /www
pour rediriger les URLs sur /web/index.php
.
Au besoin :
$ sudo a2enmod rewrite
Exemple de virtual host :
$ cat /etc/apache2/sites-enabled/quizzes.xyz.com
<Directory /var/www/quizzes/web>
Options -Indexes
AllowOverride FileInfo
Order allow,deny
allow from all
</Directory>
<VirtualHost *:80>
ServerName quizzes.xyz.com
ServerAlias quizzes
ServerAdmin admin@xyz.com
RewriteEngine On
DocumentRoot /var/www/quizzes/web
ErrorLog /var/log/apache2/quizzes-error.log
CustomLog /var/log/apache2/quizzes-access.log combined
LogLevel warn
</VirtualHost>
Application
Initialiser le fichier de configuration en dupliquant conf/qcm-dist.php
et en l'adaptant :
$ cp '/var/www/quizzes/conf/qcm-dist.php' '/var/www/quizzes/conf/qcm.php'
Pour mettre à jour des comptes d'administration modifier la clé 'admin_accounts'
,
tableau au format login => md5(password)
.
Mise à jour des questionnaires
Les questionnaires sont cryptés en AES-256 sur le serveur web.
Lors d'une mise à jour des questionnaires exécuter le script /src/encrypt.php
afin de régénérer
les /resources/quizzes/*.enc.php
à partir des /resources/quizzes/src/*.php
.
Le répertoire /resources/quizzes/src
n'est alors plus nécessaire, ainsi que /src/encrypt.php
.
Des exemples de questionnaires sont disponibles dans /resources/quizzes/examples
:
- 2 mini questionnaires intitulés « Additions » et « Multiplications »,
- 1 questionnaire « JavaScript » d'une seule question mais illustrant l'insertion de code avec coloration syntaxique,
- 1 questionnaire nommé « Toutes les questions ! » expliquant comment déclarer un questionnaire comme l'union d'autres questionnaires
- et 1 questionnaire intitulé « Un petit peu de tout… » piochant au hasard un nombre défini de question parmi celles des autres questionnaires.
Les copier dans /resources/quizzes/src
pour les utiliser dans l'application…
Captures d'écran
Déroulement d'une session
Choix de la session :
Un questionnaire peut être la réunion de plusieurs questionnaires ou une partie d'un autre questionnaire :
Identification du candidat :
Exemple d'affichage d'une question :
Analyse
Accueil de la section d'administration avec liste des sessions passées et en cours :
Résultat général d'une session :
Score par thème avec visualisation de la quantité de points perdus par pénalités :
Temps moyen de réponse par thème :
Catégorisation des réponses par thème :
Correction d'une question, accessible seulement à partir de la zone privée :
Configuration d'un questionnaire, dans /resources/quizzes/src
:
<?php
return array(
'meta' => array(
'title' => 'POO et design patterns',
'time_limit' => 15*20,
'max_nb_questions' => 0,
'status' => 'available' // {'available', 'deactivated', 'hidden'}
),
'questions' => array(
array(
'POO',
"Quel est le patron de conception central dans Doctrine 2 ?",
array(
"table data gateway" => false,
"active record" => false,
"data mapper" => true,
"row data gateway" => false,
)
),
…
)
);
Copyrights & licensing
Licensed under the GNU General Public License v3 (GPL-3.0+). See LICENSE file for details.
Change log
See CHANGELOG file for details.
Git branching model
The git branching model used for development is the one described and assisted
by twgit
tool: https://github.com/Twenga/twgit.