Différences

Ci-dessous, les différences entre deux révisions de la page.

--- mod:learningtimecheck:installguide [2026/01/13 08:19] – créée - modification externe 127.0.0.1
+++ mod:learningtimecheck:installguide [2026/10/19 16:24] (Version actuelle) – admin
@@ Ligne 5: / Ligne 5: @@
    * Le module LearningTimeCheck (Temps d'apprentissage) (ce module)
-   * Le rapport des "Temps d'apprentissage" (les rapports consolidés sur les cours, utilisateurs ou cohortes)
+   * Le rapport "Temps d'apprentissage" (les rapports consolidés sur les cours, utilisateurs ou cohortes), obligatoire
-   * Le bloc "Temps d'apprentissage"
+   * Le bloc "Temps d'apprentissage" (affichage de l'avancement dans les cours), facultatif
+   * Les bibliothèques communes ActiveProLearn : [[:local:aplcore|local_aplcore]] et ''local_aplpdf'' (cette dernière pour les exports PDF), obligatoires
+Pour le couplage avec les mesures d'activité réelles, il faut aussi installer le bloc [[:blocks:usestats|Mesure d'activité]] (Use Stats) et le rapport [[:report:trainingsessions|Sessions de formation]].
+Versions de Moodle supportées : 4.1 à 4.5.
 Il existe également un plugin d'export de notes dédié à ce sous-ensemble. Il est actuellement implémenté mais n'a jamais été exploité dans des conditions réelles.
-Une fois l'installation réalisée, il faut apporter un certain soin à la configuration des différents modules. Les demandes de organismes financeurs de formation sont en constante mutation et sont non homogènes en fonction du territoire ou du secteur professionnel. Les configurations proposées ont été accumulées de plusieurs cas d'usage réels pour s'adapter aux différentes situations rencontrées.
+Une fois l'installation réalisée, il faut apporter un certain soin à la configuration des différents modules. Les demandes des organismes financeurs de formation sont en constante mutation et ne sont pas homogènes selon le territoire ou le secteur professionnel. Les configurations proposées ont été accumulées à partir de plusieurs cas d'usage réels pour s'adapter aux différentes situations rencontrées.
 ===== Installation =====
-L'installation des différentes briques suit la procédure standard d'installation dans Moodle. vous trouverez les instructions correspondant à chaque élément dans leur documentation respective.
+L'installation des différentes briques suit la procédure standard d'installation dans Moodle. Vous trouverez les instructions correspondant à chaque élément dans leur documentation respective.
-   - Déployez l'archive dans le répertoire /mod de votre installation Moodle.
+   - Déployez les bibliothèques ''local_aplcore'' et ''local_aplpdf'' dans le répertoire ''/local'' de votre installation Moodle.
-   - Déployez les autres composants dans les répertoires indiqués.
+   - Déployez le rapport dans le répertoire ''/report'' (dossier ''learningtimecheck'').
+   - Déployez le module dans le répertoire ''/mod'' (dossier ''learningtimecheck'').
+   - Déployez le bloc, si vous l'utilisez, dans le répertoire ''/blocks'' (dossier ''learningtimecheck'').
    - Naviguez enfin vers les notifications d'administration pour terminer l'installation logique des composants.
 ===== Configuration =====
+Les réglages se trouvent dans l'administration du site, dans la configuration du module d'activité //Temps d'apprentissage//.
 ==== Configuration générale ====
-  * **Initialement obligatoire :** Les activités et ressources capturées pra le LearningTimeCheck peuvent faire partie d'un contrat pédagogique obligatoire ou être déclarées comme facultatives. Si cette option est activée, tous les items sont initialement marqués comme obligatoire.
+  * **Initialement obligatoire :** les activités et ressources capturées par le LearningTimeCheck peuvent faire partie d'un contrat pédagogique obligatoire ou être déclarées comme facultatives. Si cette option est activée (par défaut), tous les éléments découverts dans les cours sont initialement marqués comme obligatoires. Sinon, ils sont marqués comme facultatifs.
-  * **Temps forfaitaires activés :** Si cette option est active, alors toute nouvelle instance de LTC créée dans Moodle aura les temps forfaitaires activés.
+  * **Temps forfaitaires activés initialement :** si cette option est active (par défaut), toute nouvelle instance de LTC créée dans Moodle a les temps forfaitaires activés.
-  * **Couplage crédit/obligatoire :** si ce réglage est actif, alors toute attribution d'un crédit temps étudiant à un item rend cet item obligatoire dans le contrat pédagogique.
+  * **Couplage crédit/obligatoire :** si ce réglage est actif, tout élément auquel on affecte un crédit temps non nul devient obligatoire dans le contrat pédagogique. Désactivé par défaut.
-  * **Autocapture initiale :** Ce paramètre permet de régler le mode de capture par défaut pour tout nouveau LTC créé dans Moodle. Seuls les modes communs a tous les formats de cours peuvent être choisis ici. (Le format de cours au moment de la création de l'instance ne peut être connu ici).
+  * **Autocapture initiale :** mode de découverte automatique des éléments appliqué par défaut à toute nouvelle liste créée dans Moodle. Seuls les modes communs à tous les formats de cours sont proposés (//Non//, ou //Tout le cours//, valeur par défaut), car le format du cours n'est pas connu au moment où ce réglage est lu.
-  * **Date de dernière compilation du cron :** Ce réglage permet de redéfinir la date de référence des compilations incrémentales des marques.
+  * **Prendre en compte les notes de réussite dans les achèvements :** si actif, l'état d'achèvement tient compte de la note de passage. Désactivé par défaut.
-  *
+  * **Surcharge initiale des temps déclarés :** mode de combinaison des temps déclarés par l'apprenant et du crédit temps, appliqué à toute nouvelle instance. Quatre modes sont proposés :
+    * //Temps crédités seulement// (valeur par défaut) ;
+    * //Le déclaré si supérieur au crédit, le crédit sinon// ;
+    * //Le déclaré jusqu'à obtention du crédit// (si le crédit est défini) ;
+    * //Temps déclarés seulement//.
+  * **Date de dernière compilation du cron :** permet de redéfinir la date de référence des compilations incrémentales des marques. Changer cette date recompile les événements non pris en compte.
 {{ :mod:learningtimecheck:plugin-central1.png?nolink&800 |}}
+==== Affichage dans les vues d'ensemble des cours ====
-==== Affichage dans les vues d'ensemble des cours====
+  * **Montrer les listes d'avancement sur les pages personnalisées :** si cette option est activée (par défaut), les listes de progression et leurs barres sont visibles dans les pages personnalisées (Mon tableau de bord). Si elle est désactivée, elles sont masquées.
+  * **Montrer les listes d'avancement complétées sur les pages personnalisées :** similaire à la précédente, mais pour les instances complètes : si cette option est décochée, les listes complétées ne sont plus affichées. Activée par défaut.
+{{ :mod:learningtimecheck:plugin-central2.png?nolink&800 |}}
-  * **Montrer les listes d'avancement sur les pages personnalisées :** Si cette option est activée, alors les listes de progression et leurs barres ne seront pas visible dans les pages personnalisées (MY - Tableau de bord)
+==== CSV ====
-  * **Montrer les listes d'avancement complétées sur les pages personnalisées :**  Similaire à la précédente, mais désactive l'affichage des instances complètes si cette option est décochée.
+  * **Séparateur de champ :** séparateur de champs des générations CSV : virgule, point-virgule (par défaut), deux-points ou tabulation.
-{{ :mod:learningtimecheck:plugin-central2.png?nolink&800}}
+  * **Fin de ligne :** caractère de fin de ligne des générations CSV : LF, CR ou CRLF.
+  * **Encodage :** encodage des caractères des générations CSV : ISO-8859-1 ou UTF-8 (par défaut). Le choix //HTML// est réservé au débogage.
-===CSV===
-  * **Séparateur de champ :** Définit le séparateur de champs pour les générations CSV.
-  * **Fin de ligne :** Définit le caractère de fin de ligne pour les générations CSV.
-  * **Encodage :** Définit l'encodage des jeux de caractères pour les générations CSV.
 {{ :mod:learningtimecheck:plugin-central3.png?nolink&800 |}}
@@ Ligne 56: / Ligne 64: @@
 ====Couplage avec les rapports de session ====
+Cette partie n'apparaît que si le bloc [[:blocks:usestats|Mesure d'activité]] (UseStats) est installé.
+  * **Intégrer les mesures réelles d'activité :** ''learningtimecheck | integrateusestats''. Si ce réglage est activé, il est possible de choisir de reporter le temps "constaté par la plate-forme" pour certains éléments, plutôt que le temps forfaitaire. Le temps de mesure de session (TS) s'affiche alors dans les rapports LTC. :!: Nota (23/01/2018) : il s'agit de la fonction inverse de la suivante, non totalement implémentée.
+  * **Permettre la surcharge des Rapports de session :** ''learningtimecheck | allowoverrideusestats''. Si ce réglage est activé, il est possible de choisir de "pousser" le temps forfaitaire prévu pour une activité dans les rapports de Session de formation, au lieu du temps "constaté par la plate-forme", pour certains éléments : les temps du LTC supplantent alors les temps de session dans ces rapports. Ce réglage nécessite le bloc [[:blocks:usestats|Mesure d'activité]] et le rapport [[:report:trainingsessions|Sessions de formation]] (TrainingSessions). Une case à cocher supplémentaire, //imposer le temps forfaitaire//, devient visible dans le formulaire de configuration des marques.
+  * **Application stricte du crédit temps :** ''learningtimecheck | strictcredits''. Ce réglage détermine, lorsque le couplage de surcharge est actif, comment le temps crédité du LTC est combiné au temps mesuré par les logs (UseStats), élément par élément. Quatre valeurs sont proposées :
+    * //Ne pas appliquer les crédits temps// (par défaut) : mode non strict, voir ci-dessous ;
+    * //Appliquer si le crédit surpasse le temps réel// : le temps affiché est relevé jusqu'au crédit lorsque le temps réel est inférieur ;
+    * //Appliquer si le temps réel dépasse le crédit// : le temps affiché est plafonné au crédit lorsque le temps réel le dépasse ;
+    * //Toujours appliquer le crédit// : le temps affiché est le crédit, quel que soit le temps réel.
+Dans les trois derniers modes (stricts), l'application du crédit ne dépend **pas** de l'état de validation de l'élément : elle repose sur l'existence de traces de l'activité. Cette règle a été adoptée en janvier 2017 pour une raison d'usage simple : le temps passé par un apprenant peut être plus long que le temps forfaitaire alloué. Si l'état de validation décidait de l'application du crédit, le temps du rapport TS diminuerait brusquement au moment du marquage de complétude, ce qui ne serait pas cohérent.
-  * **Intégrer les mesures réelles d'activité :**  learningtimecheck | integrateusestats : Si ce réglage est activé, alors il est possible de choisir de reporter le temps "constaté par la plateforme" pour certain items, plutôt que le temps forfaitaire. Le temps de mesure de session (TS) s'affichera dans les rapports LTC Ce réglage nécessite l'installation du bloc [[:blocks:usestats|Mesure d'activité]] (UseStats).
+**On se retrouve avec deux familles de comportement :**
-:!: Nota 23/01/2018 : il s'agit de la fonction inverse de la suivante ci dessous, non totalement implémenté
-  * **Permettre la surcharge des Rapports de session :** learningtimecheck | allowoverrideusestats . Si ce réglage est activé, alors il est possible de choisir de "pousser" le temps forfaitaire prévu pour une activité dans les rapports de Session de formation au lieu du temps "constaté par la plate-forme" pour certain items :  les temps du LTC supplantent les temps de session dans les rapports de session. Ce réglage nécessite l'installation du bloc [[:blocks:usestats|Mesure d'activité]] et du rapport [[:report:trainingsessions|Sessions de formation]] (TrainingSessions). Dans ce cas, une case à cocher supplémentaire est visible dans le formulaire de configuration des marques : imposer le temps forfaire.
-**On se retrouve avec deux cas de figure :**
-  * **1/Strict :**  Application stricte du crédit temps learningtimecheck | strictcredits. On affichera le crédit temps affecté à l'activité dans le LTC, ou le temps réel s'il est  inférieur (temps mesuré par les logs (usestats), que l'activité soit validée ou non.
-:!:
-  * **//Attention - Dernières modifications du composants en date du 23 janvier 2017 ://**
-On ne peut plus se baser sur la marque de complétude mais sur l'existance de l'activité pour une raison d'usage simple :
-En effet si on veut garder le temps réel passé  en cas de non marquage de complétude par l'apprenant jusque là utilisée. En effet, il se peut que le temps passé sur une activité soit plus important que le temps forfaitaire alloué, et que lors du marquage de complétude, le temps forfaire LTC s'affiche dans le Rapport du TS et soit donc moins important que la valeur réelle : Il ne serait donc pas cohérent de voir subitement le temps diminuer sur le rapport TS,  lors du marquage de complétude.
-  * **2/Non strict :**
-Si l' activité n'est pas validée,  temps calculé plafonné à la valeur du crédit temps affecté à l'activité dans le LTC,
-Si l' activité est validée, On applique ad minima le crédit temps affecté à l'activité dans le LTC, ou le temps réel passé (celui des logs du use stats) s'il est supérieur (au bénéfice de l'apprenant).
-[[report:trainingsessions|Aller au rapports du composant Training Session (TS)/Rapport de session de formation]]
+  * **1/Strict :** application du crédit temps indépendamment de l'état de validation (modes //Appliquer si…// et //Toujours appliquer//). Le mode usuel est //Appliquer si le temps réel dépasse le crédit// : on affiche le temps réel s'il est inférieur au crédit temps affecté à l'activité dans le LTC, le crédit sinon. L'élément peut être validé ou non.
+  * **2/Non strict :** seuls les éléments validés (cochés) sont concernés. Pour un élément validé, on applique au minimum le crédit temps affecté à l'activité, ou le temps réel passé (celui des logs UseStats) s'il est supérieur, au bénéfice de l'apprenant. Pour un élément non validé, le temps réel est conservé tel quel. Un élément validé sans aucune trace reçoit le crédit temps.
+[[report:trainingsessions|Aller au rapport du composant Training Session (TS) / Rapport de session de formation]]
 {{ :mod:learningtimecheck:plugin-central4.png?nolink&600 |}}
@@ Ligne 96: / Ligne 89: @@
 <html><!-- nomoodle --></html>
-[[:Mod:LearningTimeCheck|Retour à l'index du composant]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]
+[[:mod:learningtimecheck|Retour à l'index du composant]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]
 <html><!-- /nomoodle --></html>