Différences

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

--- blocks:usestats:userguide [2026/01/13 08:19] – créée - modification externe 127.0.0.1
+++ blocks:usestats:userguide [2026/10/18 00:17] (Version actuelle) – admin
@@ Ligne 1: / Ligne 1: @@
 <html><!-- nomoodle --></html>{{ :blocks:logo-apl.png?nolink |}}<html><!-- /nomoodle --></html>
-===== Bloc Use Stats : Guide d' Utilisation =====
+===== Bloc Use Stats : Guide d'utilisation =====
 ==== Ajouter un bloc ====
-Le bloc Use Stats peut être ajouté à tout endroit de Moodle, sous réserve d'avoir la capacité standard d'ajouter le bloc (> M2.4).
+Le bloc Use Stats peut être ajouté à tout endroit de Moodle (cours, page d'accueil du site, tableau de bord), sous réserve de détenir la capacité d'ajouter le bloc (''block/use_stats:addinstance'', ou ''block/use_stats:myaddinstance'' pour le tableau de bord).
-Il suffit de mettre l'environnement courant en mode édition, et d'utiliser le menu 'Ajouter un bloc'. Choisissez alors le bloc "Mesure d'activité"
+Il suffit de passer l'environnement courant en mode édition et d'utiliser le menu //Ajouter un bloc//. Choisissez alors le bloc "Mesure d'activité".
 {{ :blocks:usestats:usestat.jpg?nolink |}}
+==== Réglages de l'instance du bloc ====
-==== Bloc en mode standard ====
+Chaque instance du bloc possède deux réglages propres :
-Le bloc Use Stats, en mode standard, ne vous affichera que vos propres statistiques.
+  * **Les étudiants peuvent voir les statistiques :** par défaut, le bloc n'est pas affiché aux étudiants. Activez ce réglage pour leur montrer leurs propres statistiques.
+  * **Cacher les temps des cours :** masque la liste des temps par cours dans le bloc.
-==== Bloc en mode administrateur ====
+L'affichage du bloc est par ailleurs contrôlé par la capacité ''block/use_stats:view'' (voir [[:blocks:usestats:technique:capabilities|Capacités]]).
-En mode administrateur, vous pouvez consulter les statistiques d'autres utilisateurs.
+==== Bloc en mode standard ====
-==== Quelques infos sur les réglages du bloc en administration centrale====
+En mode standard, le bloc ne vous affiche que vos propres statistiques : le temps passé dans chaque cours sur la période de compilation et, si l'option est active, le temps passé hors des cours. Un formulaire permet de modifier la période affichée.
-[[blocks:usestats:technique:settings|Toutes les infos dans la doc technique]]
+Si le rapport [[:report:trainingsessions|Sessions de formation]] est installé, des boutons donnent accès à votre rapport de sessions et, avec la capacité d'export, à son export PDF. Dans la version PRO, le lien //Montrer les détails// ouvre la fiche de détail de vos temps.
-**Depuis**
+==== Bloc en mode consultation de tiers ====
-block_use_stats | fromwhen
-**Période de compilation**
+Les utilisateurs qui détiennent l'une des capacités ''seegroupdetails'', ''seecoursedetails'' ou ''seesitedetails'' peuvent consulter les statistiques d'autres utilisateurs, dans la limite de ce que leur capacité autorise (groupes, cours ou site).
-Valeurs possibles : 5, 15,  30, 60, 90, 180 , 365
-Attention si valeur saisie dans zone de saisie libre non listée, cela prendra en compte 5 jours , soit la valeur par défaut.
-**Filtrer les temps inférieurs à (anciennement session)**
+**Administrateurs du site et gestionnaires :** ces utilisateurs ayant en général une très forte activité, le calcul de leurs propres traces peut être long. Le bloc affiche par défaut un message d'information, avec un bouton //Outrepasser la sécurité administrateur// qui lance le calcul. La période est alors limitée à 30 jours par défaut.
-block_use_stats | filterdisplayunder
+==== Quelques infos sur les réglages du bloc en administration centrale ====
-Valeur en seconde du temps en deçà duquel le temps est pris en compte mais pas affiché dans le bloc usestat : Si une session dure moins d'une minute (60 secondes) , elle est considérée comme non significative, et  elle ne s'affiche pas dans le bloc.
-**Temps de référence à afficher**
+[[blocks:usestats:technique:settings|Toutes les infos dans la documentation technique]]
-block_use_stats | displayactivitytimeonly
+**A partir de** (''block_use_stats | fromwhen'')
-On affiche dans le bloc soit le temps passé dans les activités, soit le temps passé dans le cours
-Réglages de l'analyseur d'historiques.
-**Seuil**
+Période de compilation, en jours à partir de la date courante. Valeurs possibles : 5, 15, 30, 60 (par défaut), 90, 180, 270 et 365 jours.
-Crédit temps affecté par défaut à la session de travail en cas de rupture de session intempestive.
+**Filtrer les temps inférieurs à** (''block_use_stats | filterdisplayunder'')
-(Soit sans passer par le menu  "Se déconnecter")
-Exemple : Paramétré à 60 mn : Si un apprenant à une période d'inactivité dans une session supérieure à 60 mn, soit 1h, on le considère comme déconnecté.
+Valeur en secondes (60 par défaut) du temps de présence dans un cours en deçà duquel le cours n'est pas affiché dans le bloc. Le temps est tout de même pris en compte dans les calculs. Par exemple, un cours dans lequel l'utilisateur est resté moins d'une minute est jugé non significatif et n'apparaît pas.
-**Crédit temps supplémentaire sur le dernier ping**
-ping block_use_stats | lastpingcredit
+**Temps de référence à afficher** (''block_use_stats | displayactivitytimeonly'')
-Crédit-temps supplémentaire en mn en cas de non trace formelle de déconnexion
-mn est la valeur par défaut
-**Afficher les temps "hors cours"**
+Le bloc affiche soit le temps passé dans les activités, soit le temps passé dans le cours (qui comprend aussi les pages du cours hors activités).
+**Afficher les temps "hors cours"** (''block_use_stats | displayothertime'')
 {{ :blocks:usestats:usestat-tps-hors-cours.jpg?nolink |}}
-block_use_stats | displayothertime
+Décochez la case pour masquer, dans l'interface du bloc, les temps passés en dehors des cours (dans les autres espaces de la plate-forme, comme la page d'accueil ou l'espace de fichiers personnel).
-Décocher la case pour masquer sur l'interface du bloc, les temps passés en dehors du cours
-(dans les autres espaces sur la plateforme)
+**Seuil** (''block_use_stats | threshold'')
-**Temps de référence à afficher**
-block_use_stats | displayactivitytimeonly
+Durée d'inactivité, en minutes (60 par défaut), au-delà de laquelle l'analyseur considère que la session est interrompue, même si l'utilisateur n'est pas passé par le menu //Se déconnecter//.
-On affiche dans le bloc soit le temps passé dans les activités, soit le temps passé dans le cours (Comme par exemple sur son espace de fichiers personnel, dans les forums, etc).
-**Une session par cours**
+Exemple : paramétré à 60 minutes, un apprenant qui reste plus d'une heure sans activité est considéré comme déconnecté.
-block_use_stats | onesessionpercourse
+**Crédit exceptionnel de fin de session** (''block_use_stats | lastpingcredit'')
-Si  la coche est activée, alors l'analyseur commencera une nouvelle session chaque fois que la trace change de cours. Sinon, une session peut représenter une séance de travail qui chevauche plusieurs cours.
-(activé sur démo)
+Crédit de temps accordé, en minutes (15 par défaut), lorsqu'une rupture de session est supposée, c'est-à-dire en l'absence de trace formelle de déconnexion.
+**Une session par cours** (''block_use_stats | onesessionpercourse'')
+Si la case est cochée, l'analyseur commence une nouvelle session chaque fois que la trace change de cours. Sinon, une session peut représenter une séance de travail qui chevauche plusieurs cours.
 ====Autres éléments utiles====
+**Pour changer le libellé "Autres zones hors cours" :**
-**Pour changer le libellé "Autre temps du cours" :**
+Utilisez la personnalisation des chaînes de langue de Moodle (//Administration du site / Langue / Personnalisation de la langue//) sur le composant ''block_use_stats'', chaîne ''other''. Cela évite de modifier les fichiers du plugin.
-Aller dans le fichiers de langues/block/settings.php configdisplayother time.
+**Pour masquer l'onglet Batchs du rapport Sessions de formation aux enseignants :**
-**Pour masquer l' onglet  batch du training session aux enseignants**
+Retirez la capacité ''report/trainingsessions:batch'' au rôle concerné.
-reportsession batch : enlever la capacité au rôle pour masquer onglet batch au rôle enseignant.
 **Vérifier les permissions d'un rôle :**
-Admin du cours/utilisateurs/permissions/ filtrer sur report/trainingsessions:batch
+Dans le cours : //Participants / Permissions//, en filtrant sur ''report/trainingsessions:batch''.
-Mais passer par les rôles de plate forme au niveau système est préférable pour ne pas générer une dérogation locale aux droits sur le cours concerné.
-**Pour masquer "montrer les détails" du bloc UseStats à un apprenant :**
-block/use_stats:seeowndetails
-Le passer à non défini
+Il est cependant préférable de passer par les rôles de la plate-forme, au niveau système, pour ne pas créer de dérogation locale des droits sur le cours concerné.
+**Pour masquer "Montrer les détails" à un apprenant :**
+Passez la capacité ''block/use_stats:seeowndetails'' à //non défini// pour son rôle.
 ==== Informations additionnelles ====
-   * [[:Blocks:UseStats:Algorithm|Le modèle de calcul du bloc Use Stats]]
+   * [[:blocks:usestats:algorithm|Le modèle de calcul du bloc Use Stats]]
 ---------
 <html><!-- nomoodle --></html>
-[[:Blocks:UseStats|Revenir à l'index du bloc]] - [[:plugins|Revenir à l'index des plugins]] - [[:start|Retour au catalogue]]
+[[:blocks:usestats|Revenir à l'index du bloc]] - [[:plugins|Revenir à l'index des plugins]] - [[:start|Retour au catalogue]]
 <html><!-- /nomoodle --></html>