Différences

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

--- blocks:auditquizresults:userguide [2026/02/13 15:53] – admin
+++ blocks:auditquizresults:userguide [2026/02/23 08:02] (Version actuelle) – [Other block settings] admin
@@ Ligne 2: / Ligne 2: @@
-===== AuditQuiz Results =====
+===== User guide =====
+===== AuditQuiz Results block=====
-====User guide====
-==== Prerequisites: Properly prepare your question bank
+Prerequisites: Properly prepare your question bank to get significant results !
-===Rule 1 : ===
-The questions must be accessible within the quizzes used for pre-placement. Therefore, they must be located in a hierarchy accessible to tests added to the current course. This could include:
+====Rule 1 : ====
-Questions from the course itself.
+The questions must be accessible from the quizzes used for the audit. Therefore, they must be located in a adequate shared context, that goes from:
-Questions from a course category to which this course belongs.
-Questions from the website.
-===Rule 2 : ===
+   * The quiz instance context
+   * The course sharing context
+   * Any of the category branch context that contains the course.
+   * The site context (although sharing in site context should be done with precaution)
-Les questions doivent être rangées dans une catégorie de question de deuxième niveau. En effet, le grapheur du bloc et son module de calcul utilisent deux niveauw successifs de rangement pour aggréger les scores et les présenter à l'écran. Les questions doivent respecter cette structure et :
+====Rule 2 : ====
-   * Se trouver toutes à un même niveau de sous-catégories
+Questions must be forged into a dual question category organisation. This is because the grapher and its calculation module use two successive levels of organization to aggregate the scores and display them on the screen. The questions must adhere to this structure and:
-   * Se trouver au moins dans une sous-catégorie d'une ou plusieurs thématiques principales.
-Exemple de rangement :
+  * All be located at the same subcategory level,
+  * Be located in at least one subcategory of one or more main themes.
-   * Catégorie de partage : Questions du cours
+Example of organization:
-      * Catégorie (matière) : Francais
-         * Sous-catégorie : Orthographe
+   * Sharing category: Course questions
+      * Subject category: French
+         * Subcategory: Spelling
            * Q1
            * Q2
            * Q3
-         * Sous-catégorie : Grammaire
+         * Subcategory: Grammar
            * Q4
            * Q5
            * Q6
-       * Catégorie (matière) : Histoire
+       * Subject category: History
-         * Sous-catégorie : Histoire contemporaine
+         *  Subcategory: Contemporary History
            * Q7
            * Q8
            * Q9
-         * Sous-catégorie : Histoire antique
+         * Subcategory : Middle age
            * Q10
            * Q11
            * Q12
-Comme chaque sous-catégorie est scorée individuellement, il conviendra de créer suffisamment de questions dans chacun des sous-catégories pour que le test puisse donner des résultats discriminants et analysables (Une seule question dans une sous-catégorie conduit à proposer une alternative de 0 ou 100 dans cette sous-catégorie, ce qui n'est pas très discriminant pour mesurer un niveau de connaissances).
+Each subcategory is scored individually, it will be necessary to create enough questions in each of the subcategories so that the test can give discriminating and analyzable results (A single question in a subcategory leads to proposing an alternative of 0 or 100 in that subcategory, which is not very significant for measure knowledge "level").
-==== Construire et sélectionner les tests associés au pré-positionnement ====
+==== Building and Selecting Tests Associated with AuditQuiz ====
-Le module vous permet d'organiser librement les tests en une ou plusieurs unités. Si vous craignez que les tests soient trop longs à faire en une fois, scindez-les en plusieurs tests individuels à faire en plusieurs fois. Le module de prépositionnement sommera tous les scores qui seront produits par les tests que vous lui aurez associés.
+An Auditquiz instance can use one or more quizzes. If you think the question set as a whole might lead to too long attempt time, split it into several individual quizzes to be completed in multiple sessions. The AuditQuiz block will sum all the scores produced by the tests you have linked to it.
-Vous pouvez insérer des questions provenant d'une même catégorie dans plusieurs tests différents si vous le souhaitez. Le système de calcul effectue une consolidation générale qui ne tient pas compte du test dans lequel se trouve la question, mais bien dans quelle catégorie elle se trouve.
+You can insert questions from the same category into different quizzes if you wish. The calculation system performs a general consolidation that does not take into account the quiz instance in which the question is located or played, but rather the category it belongs to.
+==== Add  audit quiz result block ====
-==== Ajouter un bloc de prépositionnement ====
+Once your tests are ready, add the audit quiz result block to the course  and select the quizzes to associate with it,  in its settings.
-Une fois que vos tests sont prêts, ajoutez le bloc de prépositionnement dans le cours (Ajouter un bloc) et sélectionnez les tests à associer dans ses réglages.
 {{ :blocks:auditquizresults:bloc-audit-quiz.png?nolink |}}
-==== Associer des cours de remédiation ====
+==== Linking Rehab Courses (Pro only) ====
-Dans l'interface du bloc (pied) pour les utilisateurs autorisés se trouve un lien permettant d'accéder aux interfaces de gestion des associations entre catégories de questions et des cours de remédiation.
+In the block's footer, a link let authorized users access the administrétion of mapping between question categories and rehab courses.
+{{ :blocks:auditquizresults:blocks:auditquizresults:course_assign_fr.jpg |}}
+In the association screen, question categories are presented first by category (1) and then by subcategory (2). A list of associated remedial courses is provided (3) per category. Students will not be able to access if the self-enrollment method is not enabled for the relevant courses. Those courses are shown dimmed.
+You can quickly navigate to the enrollment method management screen (4) or remove this association (5).
+Finally, you can select courses to associate (6) with this category using the course selector. And go back to course (7).
+Note that remedial courses are simply "offered" to learners below their pre-placement report. Learners are not required to enroll in these courses, but they can do so voluntarily by clicking on the link for the suggested course. Therefore, it is the teacher's responsibility to verify that the enrollment method is present and active for the target course.
-{{ :blocks:auditquizresults:blocks:auditquizresults:course_assign_fr.jpg |}}
-Dans l'écran d'association, les catégories de cours vous sont présentées par catégorie (1) puis par sous-catégorie (2). Pour chaque sous-catégorie est donnée la liste des cours de remédiation associés (3). les cours en affichage atténué sont des cours que les étudiants ne pourront pas atteindre, si la méthode d'autoinscription n'est pas activée sur les cours concernés.
-Vous pouvez naviguer rapidement vers la gestion des méthodes d'inscription (4) ou supprimer cette association (5).
-Vous pouvez enfin aller choisir des cours à associer (6) à cette catégorie via le sélecteur de cours.
-Notez que les cours de remédiation sont simplement "proposés" aux apprenants en dessous de leur rapport de prépositionnement. Les apprenants n'y sont pas obligatoirement inscrits, mais ils peuvent le faire volontairement en cliquant sur le lien du cours proposé. Il s'agit donc pour l'enseignant de vérifier que la méthode d'inscription soit présente et active dans le cours cible.
-==== Autres réglages du bloc ====
+==== Other block settings====
 {{:blocks:auditquizresults:blocks:auditquizresults:block_settings_fr.jpg|}}
-**les étudiants peuvent voir leurs résultats: ** Si cette option est désactivée, le bloc est masqué pour les étudiants et ceux-ci ne peuvent pas consulter leurs résultats de positionnement.
+**Students can see their results:** If this option is disabled, the block is hidden from students, and they cannot view their placement results.
-**Publication** : Détermine comment est publié le graphe, dans le bloc ou dans une page séparée. Choisissez dans une page séparéesi vous voulez le rendu des détails sur les seuils de passage.
+**Publication:** Determines how the graph is published, either within the block or on a separate page. Choose "On a separate page" if you want the details of the passing thresholds displayed. Publishing "within the block" can be usefull for some [[:format:page|course formats allowing placing blocks freely]] in the course layout.
-**Type de test** : Au cas où d'autres modules de test qui utilisent le moteur de tentatives sont installés, ce réglage permet de choisir le type de test à rechercher pour être associés au bloc de prépositionnement.
+**Test Type:** If other quiz modules using the question engine are installed, will allow you to choose the type of course module to search for and associate with the AuditQuiz Results block.
+**Graph Dimensions:** Allows you to adjust the physical dimensions of the graph relative to the layout.
-**Dimensions du graphe : **  Permet d'ajuster les dimensions physiques du graphe par rapport à la mise en page.
+**Enable Course recommendations:** Enables or disables the remedial course recommendation mechanism.
-**Activer la proposition de cours** Ce réglage permet d'activer ou de désactiver le mécanisme de recommandation de cours de remédiation.
-**Seuil de passage 1 :  ** Ce seuil (de 0 à 100) permet de définir les catégories réussies. Les catégories qui n'ont pas atteint ce score proposeront de s'inscrire aux cours de remédiation s'ils existent, sont accessibles et que l'option de proposition est activée.
+**Passing Threshold 1:** This threshold (from 0 to 100) defines the successful categories. Categories that did not reach this score will offer the option to enrol in rehab courses if some are assigned, are visible, and a self-enrol method is enabled.
-**Seuil de passage 2 :**Si le deuxième seuil de passage est utilisé, alors les catégories de question sont divisées en trois groupes :
+**Passing Threshold 2:** When activating the second threshold, question categories will be spread into 3 groups:
-   * Celles qui sont connues
+   * Those that are known
-   * Celles dont le score pourrait être amélioré
+   * Those whose score could be improved
-   * Celles qui doivent être travaillées
+   * Those that need rehab work from student
-Les deux dernières catégories conduisent à des recommandations d'inscription si elles sont définies.
+The last two categories lead to enrollment recommendations if they are defined.
-**Publier les propositions même si la catégorie est réussie : ** Dans le cas normal, on ne propose pas de remédiation pour les catégories qui ont atteint le plus haut seuil de score. Avec cette option, les inscriptions sont proposées quel que soit le résultat.
+**Enrol even is passed:** Usually, no rehab proposal is proposed for categories that have overpassed the highest score threshold. Enabling this option, enrolments are proposed regardless the result.
 ----