This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
blocks:usestats:userguide [2018/02/11 12:20] admin [Bloc en mode administrateur] |
blocks:usestats:userguide [2023/01/31 16:46] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ===== Use Stats Block : User guide ===== | + | <html><!-- nomoodle --></html>{{ :logo-apl.png?nolink |}} <html><!-- /nomoodle --></html> |
+ | ===== Block Use_Stats / User time stats : User guide ===== | ||
==== Adding a block instance ==== | ==== Adding a block instance ==== | ||
Line 5: | Line 6: | ||
The Use Stats block can be added in any page context in moodle, pursuant the addinstance capability is owned by the current user. | The Use Stats block can be added in any page context in moodle, pursuant the addinstance capability is owned by the current user. | ||
- | Just trun the curent page environement in edit mode, and use the 'Add block' menu. Choose the "Use Stats" entry to add an instance to the page. | + | Just turn the curent page environement in edit mode, and use the 'Add block' menu. Choose the "Use Stats" entry to add an instance to the page. |
Only one single instance can be aded. | Only one single instance can be aded. | ||
+ | |||
{{ :blocks:usestats:usestat.jpg?nolink |}} | {{ :blocks:usestats:usestat.jpg?nolink |}} | ||
+ | ==== In block accessible controls ==== | ||
+ | |||
+ | * User list (enabled people) | ||
+ | * From When (Sliding window exploration) | ||
+ | |||
+ | ==== Data access modes (exploration modes)==== | ||
+ | |||
+ | * **Student mode :** For students, or for not specially enable users, only your own statistics will be displayed. | ||
+ | * **Admin mode :** In administrator (or specially enabled mode), you will be able to check the stats of any user present in the current environement. | ||
+ | |||
+ | * **Shifting time window :** the use stats gives statistics over a gliding windows ending at 23h59 local time of the current day, and starting some day count before the current date. The larger is the window, the higher is the performance impact on the server. | ||
+ | |||
+ | |||
+ | ==== General Settings (Site wide configuration) ===== | ||
+ | |||
+ | |||
+ | ===Some information on the block settings in central administration=== | ||
+ | |||
+ | All info in the [[blocks:usestats:technique|technical documentation]] | ||
- | ==== Student mode ==== | + | ===Since block_use_stats | fromwhen=== |
- | For students, or for not specially enable users, only your own statistics will be displayed. | + | Compilation period Possible values: 5, 15, 30, 60, 90, 180, 365 Warning if value entered in free entry field not listed, this will take into account 5 days, ie the default value. |
- | ==== Admin mode ==== | + | ===Filter times below (formerly session)=== |
- | In administrator (or specially enabled mode), you will be able to check the stats of any user present in the current environement. | + | block_use_stats | filterdisplayunder Value in second of the time below which the time is taken into account but not displayed in the usestat block: If a session lasts less than one minute (60 seconds), it is considered as not significant, and it does not appear not in the block. |
- | ==== Réglages du bloc==== | + | ===Reference time to display=== |
- | **Depuis** | + | block_use_stats | displayactivitytimeonly The block displays either the time spent in activities or the time spent in the History Analyzer Settings class. |
- | block_use_stats | fromwhen | + | |
- | **Période de compilation** | + | ===Threshold=== |
- | 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)** | + | Credit time assigned by default to the work session in case of accidental termination of session. (Or without going through the menu "Disconnect") |
- | block_use_stats | filterdisplayunder | + | Example: Set to 60 min: If a learner has a period of inactivity in a session longer than 60 min, ie 1h, it is considered disconnected. |
- | 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** | + | ===Overtime credit on the last ping=== |
- | block_use_stats | displayactivitytimeonly | + | ping block_use_stats | lastpingcredit Additional credit time in minutes in case of no formal logout trace 15mn is the default |
- | 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** | ||
- | Crédit temps affecté par défaut à la session de travail en cas de rupture de session intempestive. | + | ===Show "outside course" times=== |
- | (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é. | + | {{ :blocks:usestats:technique:usestat-tps-hors-cours.jpg?nolink |}} |
- | + | ||
- | **Crédit temps supplémentaire sur le dernier ping** | + | |
- | ping block_use_stats | lastpingcredit | ||
- | Crédit-temps supplémentaire en mn en cas de non trace formelle de déconnexion | ||
- | 15mn est la valeur par défaut | ||
- | **Afficher les temps "hors cours"** | + | block_use_stats | displayothertime : Uncheck the box to hide on the interface of the block, the time spent outside the course (in the other spaces on the platform) |
- | {{ :blocks:usestats:usestat-tps-hors-cours.jpg?nolink |}} | ||
- | block_use_stats | displayothertime | + | ===Reference time to display=== |
- | 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) | + | |
- | + | block_use_stats | displayactivitytimeonly We display in the block either the time spent in the activities, or the time spent in the course (as for example on his personal file space, in forums, etc.). | |
- | **Temps de référence à afficher** | + | |
- | block_use_stats | displayactivitytimeonly | + | **One session per course** |
- | 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** | + | block_use_stats | onesessionpercourse If the check mark is enabled, then the parser will start a new session each time the trace changes course. Otherwise, a session may represent a work session that overlaps with several courses. (this setting is activated on our demo moodle platform) |
- | block_use_stats | onesessionpercourse | ||
- | 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) | ||
+ | ====Other useful elements==== | ||
- | ====Autres éléments utiles==== | + | ===To change the label "Other class time" :=== |
+ | Go to the language files / block / settings.php configdisplayother time. | ||
- | **Pour changer le libellé "Autre temps du cours"** | + | ===To hide the batch tab of the training session to teachers :=== |
- | Aller dans le fichiers de langues/block/settings.php configdisplayother time. | + | batch reports: remove the ability to the role to hide batch tab to the teacher role. |
- | **Pour masquer l' onglet batch du training session aux enseignants** | + | ===Check role permissions :=== |
- | reportsession batch : enlever la capacité au rôle pour masquer onglet batch au rôle enseignant. | + | Course Admin / users / permissions / filter on report / trainingsessions: batch |
- | **Vérifier les permissions d'un rôle :** | + | But going through platform roles at the system level is better not to generate a local override of the rights on the relevant course. |
- | Admin du cours/utilisateurs/permissions/ filtrer sur report/trainingsessions:batch | + | ===To hide "show details" from the UseStats block to a learner:=== |
- | 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 |
- | block/use_stats:seeowndetails | + | set up to "undefined" |
- | Le passer à non défini | + | |
+ | ==== Additional information ==== | ||
+ | * [[:Blocks:UseStats:Algorithm|block algorithm Use Stats]] | ||
- | ==== Informations additionnelles ==== | ||
- | * [[:Blocks:UseStats:Algorithm|Le modèle de calcul du bloc Use Stats]] | ||
- | [[:Blocks:UseStats|Revenir à l'index du bloc]] | + | --------------- |
+ | [[:start|Back to home]] - [[:plugins|Back to plugin list order by type]] - [[:Blocks:UseStats|Back to the component index]] - [[:Blocks:UseStats:UserGuide|User guide]] - [[blocks:usestats:technique|Technical index]] |