blocks:usestats:userguide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
blocks:usestats:userguide [2018/02/11 13:02]
admin [Other usefull hints]
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]]
 +
 +===Since block_use_stats | fromwhen===
 +
 +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.
 +
 +===Filter times below (formerly session)===
 +
 +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.
 +
 +===Reference time to display===
 +
 +block_use_stats | displayactivitytimeonly The block displays either the time spent in activities or the time spent in the History Analyzer Settings class.
  
-==== Student mode ====+===Threshold===
  
-For students, or for not specially enable users, only your own statistics will be displayed+Credit time assigned by default to the work session in case of accidental termination of session(Or without going through the menu "​Disconnect"​)
  
-==== Admin mode ====+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.
  
-In administrator (or specially enabled mode), you will be able to check the stats of any user present in the current environement.+===Overtime credit on the last ping===
  
-==== Réglages du bloc====+ping block_use_stats | lastpingcredit Additional credit time in minutes in case of no formal logout trace 15mn is the default
  
-**Depuis** ​ 
-block_use_stats | fromwhen 
  
-**Période de compilation** +===Show "​outside course"​ times===
-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)**+{{ :​blocks:​usestats:​technique:​usestat-tps-hors-cours.jpg?​nolink |}}
  
-block_use_stats | filterdisplayunder ​ 
-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** ​+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)
  
-block_use_stats | displayactivitytimeonly ​ 
-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** ​+===Reference time to display===
  
-Crédit temps affecté par défaut à la session de travail en cas de rupture de session intempestive. +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.).
-(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é. +**One session per course**
-  +
-**Crédit temps supplémentaire sur le dernier ping**+
  
-ping block_use_stats | lastpingcredit  +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)
-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"​** 
  
-{{ :​blocks:​usestats:​usestat-tps-hors-cours.jpg?​nolink |}}+====Other useful elements====
  
-block_use_stats | displayothertime +===To change the label "Other class time" :===
-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) ​+
  
-  +Go to the language files / block / settings.php configdisplayother time.
-**Temps de référence à afficher** ​+
  
-block_use_stats | displayactivitytimeonly  +===To hide the batch tab of the training session to teachers :===
-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**+batch reports: remove the ability to the role to hide batch tab to the teacher role.
  
-block_use_stats | onesessionpercourse +===Check role permissions :===
-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)+
  
 +Course Admin / users / permissions / filter on report / trainingsessions:​ batch 
  
-====Other usefull hints====+But going through platform roles at the system level is better not to generate a local override of the rights on the relevant course.
  
-**Remove access ​to detail sheet**+===To hide "show details"​ from the UseStats block to a learner:===
  
-Remove the capability //block/​use_stats:​seeowndetails// from the student role.+block / use_stats: seeowndetails ​
  
 +set up to "​undefined"​
  
  
  
 +==== 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]]
blocks/usestats/userguide.1518350525.txt.gz · Last modified: 2024/04/04 15:50 (external edit)