Documentation Moodle ActiveProLearn

• Moodle 4.1 ou supérieur (version 4.5 supportée)
• Le plugin local_aplcore (bibliothèque commune ActiveProLearn), à installer avant le bloc

Le bloc Use Stats est le moteur de calcul des temps utilisé par le rapport Sessions de formation.

Ce bloc s'installe selon la procédure standard d'installation de bloc :

1. Décompactez l'archive dans le répertoire /blocks de votre installation Moodle, de façon que le dossier s'appelle use_stats
2. Allez dans les notifications d'administration pour installer logiquement le bloc

À l'installation, le bloc crée ses tables de compilation des sessions (timegaps) et déclare ses tâches planifiées. Il n'est pas nécessaire d'ajouter le bloc dans un cours ou sur le tableau de bord pour que le calcul des temps fonctionne : le bloc ne sert qu'à l'affichage. Les rapports qui s'appuient sur Use Stats (Sessions de formation) fonctionnent sans qu'aucune instance du bloc ne soit posée.

Trois tâches sont déclarées. Le cron de Moodle doit s'exécuter régulièrement (toutes les minutes recommandé) :

• Compilation (toutes les minutes) : calcule les sessions et les temps à partir de la trace des événements. Sur une plate-forme qui contient déjà beaucoup de traces, la première compilation peut prendre plusieurs passes.
• Nettoyage (chaque nuit à 3h00) : purge des données de compilation obsolètes.
• Cache (toutes les 10 minutes) : expiration du cache d'agrégats.

La date de dernière compilation est réglable (voir ci-dessous) : la modifier provoque le recalcul de toutes les valeurs à partir de cette date.

Le bloc Use Stats doit être configuré pour adapter sa capacité d'analyse des temps à l'usage effectif (ou majoritaire) de la plate-forme. Les réglages se trouvent dans l'administration du site, sous Plugins / Blocs / Mesure d'activité.

Réglages d'affichage du bloc

• A partir de : durée de compilation, en jours depuis aujourd'hui (60 par défaut).
• Mode de rétrospective et Source de la rétrospective : période glissante ou date fixe ; période choisie par l'étudiant ou imposée.
• Filtrer les temps inférieurs à : si non nul, seuls les cours dont le temps de présence dépasse cette valeur sont affichés dans le bloc.
• Afficher le temps “Hors cours” : affiche une ligne pour les temps hors contexte de cours (oui par défaut).
• Temps de référence à afficher : temps total du cours, ou temps des activités seulement.
• Style du calendrier : thème du sélecteur de date.

Paramètres d'analyse des traces (ces réglages conditionnent la valeur de tous les temps calculés, y compris dans les rapports Sessions de formation)

• Seuil (60 minutes par défaut) : au-delà de ce délai entre deux traces successives, l'analyseur conclut à une déconnexion de l'utilisateur et attribue le crédit forfaitaire.
• Crédit exceptionnel de fin de session (15 minutes par défaut) : temps ajouté chaque fois qu'une fin ou une discontinuité de session est supposée.
• Une session par cours (non par défaut) : si activé, une nouvelle session commence chaque fois que la trace change de cours. Sinon, une session peut chevaucher plusieurs cours.
• Filtre sur les inscriptions (oui par défaut) : les traces ne sont compilées qu'à partir de la date d'inscription active la plus ancienne, et au plus tôt à la date de démarrage du cours.
• Date de dernière compilation : la modifier déclenche le recalcul à partir de cette date.
• Compilation restreinte au cours (oui par défaut) : lors d'un rapport sur un cours, seuls les logs de ce cours (et ceux de niveau site) sont chargés. Les résultats du cours sont identiques, mais les temps des autres cours ne sont pas calculés dans ce contexte.
• Nombre maximum d'entrées de log pour l'affichage du bloc (50000 par défaut) : au-delà, un avertissement est affiché au lieu du calcul, pour éviter les erreurs de mémoire pour les utilisateurs très actifs.
• Modules ignorés : les temps de ces modules ne sont pas comptabilisés dans les sommes (liste de noms techniques de modules).
• Modules capturés (learningtimecheck par défaut) : le temps de ces modules est comptabilisé, mais ils ne sont pas mentionnés dans les rapports.

Ces notions sont détaillées dans le guide technique.

Réglages de la version PRO

• Compilation du cube statistique et requêtes de dimensions (customtag1 à customtag6) : requêtes SQL qui alimentent les dimensions supplémentaires de qualification des temps. Elles peuvent utiliser les marqueurs <LOGID>, <USERID>, <COURSEID> et <CMID>. Chaque requête ne doit retourner qu'une seule colonne.
• Maintien de session (keepalive) : émission régulière d'un événement tant qu'une page Moodle est affichée à l'écran. Réglages : activation, période d'émission (en secondes), règle d'émission (selon une capacité ou un champ de profil ; les administrateurs sont exclus par défaut). Cette fonction doit être utilisée avec précaution : elle peut mesurer des comportements locaux non pertinents (page laissée ouverte).

Le maintien de session (PRO) doit être appelé depuis toutes les pages. L'appel n'est pas automatique : il doit être ajouté dans le thème, par exemple dans la fin de page du moteur de rendu du thème :

if (file_exists($CFG->dirroot.'/blocks/use_stats/lib.php')) {
    include_once($CFG->dirroot.'/blocks/use_stats/lib.php');
    $str .= block_use_stats_setup_theme_notification();
}

Les droits d'accès aux données de temps sont portés par les capacités du bloc : block/use_stats:view, seeowndetails, seecoursedetails, seegroupdetails, seesitedetails et export. Voir le guide d'utilisation.

Revenir à l'index du bloc - Revenir à l'index des plugins - Revenir au catalogue