From 697815159f4ecbc5b04303b0fa5747dc9eb72f89 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Luca=20B=C3=B6sch?= <luca.boesch@bfh.ch>
Date: Wed, 8 May 2024 12:26:54 +0200
Subject: [PATCH] MDL-81713 mod_quiz: Add random question 'Parent category'
 help icon.

---
 mod/quiz/lib.php                                 |  3 +++
 .../templates/add_random_question_form.mustache  | 16 ++++++++++++++++
 mod/quiz/tests/behat/editing_add_random.feature  |  1 +
 3 files changed, 20 insertions(+)

diff --git a/mod/quiz/lib.php b/mod/quiz/lib.php
index db6b8294e5d..98ac5626f20 100644
--- a/mod/quiz/lib.php
+++ b/mod/quiz/lib.php
@@ -2405,6 +2405,9 @@ function mod_quiz_output_fragment_add_random_question_form($args) {
         'questioncategoryoptions' => $catoptions,
     ];
 
+    $helpicon = new \help_icon('parentcategory', 'question');
+    $data['questioncategoryhelp'] = $helpicon->export_for_template($renderer);
+
     $result = $OUTPUT->render_from_template('mod_quiz/add_random_question_form', $data);
 
     return $result;
diff --git a/mod/quiz/templates/add_random_question_form.mustache b/mod/quiz/templates/add_random_question_form.mustache
index 6a95c3c3f97..db175ae146f 100644
--- a/mod/quiz/templates/add_random_question_form.mustache
+++ b/mod/quiz/templates/add_random_question_form.mustache
@@ -33,6 +33,19 @@
                 {"name": "Category 3", "value": "2"}
             ]
         },
+        "questioncategoryhelp": {
+            "title": "Help with something",
+            "text": "Help with something",
+            "url": "http://example.org/help",
+            "linktext": "",
+            "icon": {
+                "extraclasses": "iconhelp",
+                "attributes": [
+                    {"name": "src", "value": "../../../pix/help.svg"},
+                    {"name": "alt", "value": "Help icon"}
+                ]
+            }
+        },
         "questionbank": "<pre>Question bank HTML goes here</pre>"
     }
 }}
@@ -70,6 +83,9 @@
 
             <!-- Select number of random question -->
             <label class="mr-md-2 mb-md-0" for="parentcategory">{{#str}} parentcategory, question {{/str}} </label>
+                {{#questioncategoryhelp}}
+                    {{>core/help_icon}}
+                {{/questioncategoryhelp}}
             <select id="parentcategory" name="parentcategory" class="form-control">
                 {{#questioncategoryoptions}}
                     <optgroup label="{{label}}">
diff --git a/mod/quiz/tests/behat/editing_add_random.feature b/mod/quiz/tests/behat/editing_add_random.feature
index 76232c4090b..7c66c53a5a7 100644
--- a/mod/quiz/tests/behat/editing_add_random.feature
+++ b/mod/quiz/tests/behat/editing_add_random.feature
@@ -98,6 +98,7 @@ Feature: Adding random questions to a quiz based on category and tags
     When I open the "last" add to quiz menu
     And I follow "a random question"
     And I follow "New category"
+    And "Help with Parent category" "icon" should exist in the "id_newcategoryheader" "fieldset"
     And I set the following fields to these values:
       | Name            | New Random category |
       | Parent category |  Default for Quiz 1 |