Différences

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

--- blocks:auditquizresults:userguide [2026/02/22 14:11] – [AuditQuiz Results: User guide] admin
+++ blocks:auditquizresults:userguide [2026/02/23 08:02] (Version actuelle) – [Other block settings] admin
@@ Ligne 13: / Ligne 13: @@
 ====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:
+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 the course itself.
+   * The quiz instance context
-Questions from a course category to which this course belongs.
+   * The course sharing context
-Questions from the website.
+   * Any of the category branch context that contains the course.
+   * The site context (although sharing in site context should be done with precaution)
 ====Rule 2 : ====
-The questions must be grouped into a second-level question category. This is because the block 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:
+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:
   * All be located at the same subcategory level,
   * Be located in at least one subcategory of one or more main themes.
 Example of organization:
    * Sharing category: Course questions
@@ Ligne 40: / Ligne 39: @@
            * Q5
            * Q6
-       * Subject category: Hitory
+       * Subject category: History
          *  Subcategory: Contemporary History
            * Q7
@@ Ligne 50: / Ligne 49: @@
            * Q12
-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 discriminating to measure a level of knowledge).
+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").
-==== Building and Selecting Tests Associated with Pre-Placement ====
+==== Building and Selecting Tests Associated with AuditQuiz ====
-The module allows you to freely organize the tests into one or more units. If you are concerned that the tests will be too long to complete at once, split them into several individual tests to be completed in multiple sessions. The pre-placement module will sum all the scores produced by the tests you have associated with it.
+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.
-You can insert questions from the same category into several different tests if you wish. The calculation system performs a general consolidation that does not take into account the test in which the question is located, but rather the category it belongs to.====
-The plugin allows you to freely organize the tests into one or more units. If you are concerned that the tests will be too long to complete at once, split them into several individual tests to be completed in multiple sessions. The pre-placement module will sum all the scores produced by the tests you have associated with it.
-You can insert questions from the same category into several different tests if you wish. The calculation system performs a general consolidation that does not take into account the test in which the question is located, but rather the category it belongs to.
+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 ====
@@ Ligne 69: / Ligne 63: @@
 {{ :blocks:auditquizresults:bloc-audit-quiz.png?nolink |}}
-==== Linking Remediation Courses ====
+==== Linking Rehab Courses (Pro only) ====
-In the block interface (footer), authorized users can find a link to access the interfaces for managing associations between question categories and remediation courses
+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, course categories are presented first by category (1) and then by subcategory (2). For each subcategory, a list of associated remedial courses is provided (3). Courses shown in a dimmed display are courses that students will not be able to access if the self-enrollment method is not enabled for the relevant courses.
+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).
@@ Ligne 96: / Ligne 88: @@
 **Students can see their results:** If this option is disabled, the block is hidden from students, and they cannot view their placement results.
-**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.
+**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.
-**Test Type:** If other test modules that use the retries engine are installed, this setting allows you to choose the type of test to search for and associate with the placement block.
+**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.
-**Enable Course recommendations:** This setting enables or disables the remedial course recommendation mechanism.
+**Enable Course recommendations:** Enables or disables the remedial course recommendation mechanism.
-**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 enroll in remedial courses if they exist, are accessible, and the offer option is enabled.
+**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.
-**Passing Threshold 2:** If the second passing threshold is used, then the question categories are divided into 3 groups:
+**Passing Threshold 2:** When activating the second threshold, question categories will be spread into 3 groups:
    * Those that are known
    * Those whose score could be improved
-   * Those that need work from student
+   * Those that need rehab work from student
 The last two categories lead to enrollment recommendations if they are defined.
-**Inscription proposals even if the category is passed:** Normally, no remediation is offered for categories that have reached the highest score threshold. With this option, enrollments are offered regardless of the result.
+**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.
 ----