first commit

question/bank/history/classes/helper.php

@@ -0,0 +1,51 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history;
+
+/**
+ * Helper class for question history.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class helper {
+
+    /**
+     * Get the question history url.
+     *
+     * @param int $entryid id of the question entry
+     * @param string $returnrul url of the page to return to
+     * @param int $courseid id of the course
+     * @param ?string $filter filter param to pass to the History view
+     * @return \moodle_url
+     */
+    public static function question_history_url(int $entryid, string $returnrul, int $courseid, ?string $filter): \moodle_url {
+        $params = [
+            'entryid' => $entryid,
+            'returnurl' => $returnrul,
+            'courseid' => $courseid
+        ];
+        if (!is_null($filter)) {
+            $params['filter'] = $filter;
+        }
+
+        return new \moodle_url('/question/bank/history/history.php', $params);
+    }
+
+}

question/bank/history/classes/history_action.php

@@ -0,0 +1,64 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history;
+
+use core_question\local\bank\question_action_base;
+
+/**
+ * Question bank column for the history action icon.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class history_action extends question_action_base {
+
+    // Store this lang string for performance.
+    protected $strpreview;
+
+    public function init(): void {
+        parent::init();
+        $this->strpreview = get_string('history_action', 'qbank_history');
+    }
+
+    public function get_menu_position(): int {
+        return 500;
+    }
+
+    protected function get_url_icon_and_label(\stdClass $question): array {
+        if (!\question_bank::is_qtype_installed($question->qtype)) {
+            // It sometimes happens that people end up with junk questions
+            // in their question bank of a type that is no longer installed.
+            // We cannot do most actions on them, because that leads to errors.
+            return [null, null, null];
+        }
+
+        if (question_has_capability_on($question, 'use')) {
+            $url = helper::question_history_url(
+                $question->questionbankentryid,
+                $this->qbank->returnurl,
+                $this->qbank->course->id,
+                $this->qbank->base_url()->param('filter'),
+            );
+            return [$url, 't/log', $this->strpreview];
+        }
+
+        return [null, null, null];
+    }
+
+}

question/bank/history/classes/output/renderer.php

@@ -0,0 +1,39 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history\output;
+
+/**
+ * Class renderer for rendering question history.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class renderer extends \plugin_renderer_base {
+
+    /**
+     * Render the history header.
+     *
+     * @param array $historydata data to be passed in the mustache
+     * @return string
+     */
+    public function render_history_header(array $historydata): string {
+        return $this->render_from_template('qbank_history/history_header', $historydata);
+    }
+
+}

question/bank/history/classes/plugin_feature.php

@@ -0,0 +1,43 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history;
+
+use core_question\local\bank\view;
+
+/**
+ * Class plugin_feature is the entrypoint for the columns.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class plugin_feature extends \core_question\local\bank\plugin_features_base {
+
+    public function get_question_columns($qbank): array {
+        return [
+            new version_number_column($qbank),
+        ];
+    }
+
+    public function get_question_actions(view $qbank): array {
+        return [
+            new history_action($qbank),
+        ];
+    }
+
+}

question/bank/history/classes/privacy/provider.php

@@ -0,0 +1,33 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history\privacy;
+
+/**
+ * Privacy Subsystem for qbank_history implementing null_provider.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class provider implements \core_privacy\local\metadata\null_provider {
+
+    public static function get_reason(): string {
+        return 'privacy:metadata';
+    }
+
+}

question/bank/history/classes/question_history_view.php

@@ -0,0 +1,191 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history;
+
+use core_question\local\bank\question_edit_contexts;
+use core_question\local\bank\view;
+use moodle_url;
+use stdClass;
+
+/**
+ * Custom view class for the history page.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class question_history_view extends view {
+
+    /**
+     * Entry id to get the versions
+     *
+     * @var int $entryid
+     */
+    protected $entryid;
+
+    /**
+     * Base url for the return.
+     *
+     * @var \moodle_url $basereturnurl
+     */
+    protected $basereturnurl;
+
+    /**
+     * Constructor for the history.
+     * @param question_edit_contexts $contexts the contexts of api call
+     * @param moodle_url $pageurl url of the page
+     * @param stdClass $course course settings
+     * @param stdClass|null $cm (optional) activity settings.
+     * @param array $params the parameters required to initialize the api.
+     * @param array $extraparams any extra parameters need to initialized if the api is extended, it will be passed to js.
+     * @throws \moodle_exception
+     */
+    public function __construct(
+        question_edit_contexts $contexts,
+        moodle_url $pageurl,
+        stdClass $course,
+        stdClass $cm = null,
+        array $params = [],
+        array $extraparams = [],
+    ) {
+        $this->entryid = $extraparams['entryid'];
+        $this->basereturnurl = new \moodle_url($extraparams['returnurl']);
+        parent::__construct($contexts, $pageurl, $course, $cm, $params, $extraparams);
+    }
+
+    protected function init_question_actions(): void {
+        parent::init_question_actions();
+        unset($this->questionactions['qbank_history\history_action']);
+    }
+
+    protected function wanted_columns(): array {
+        $this->requiredcolumns = [];
+        $questionbankcolumns = $this->get_question_bank_plugins();
+        foreach ($questionbankcolumns as $classobject) {
+            if (empty($classobject)) {
+                continue;
+            }
+            $this->requiredcolumns[$classobject->get_column_name()] = $classobject;
+        }
+
+        return $this->requiredcolumns;
+    }
+
+    protected function display_advanced_search_form($advancedsearch): void {
+        foreach ($advancedsearch as $searchcondition) {
+            echo $searchcondition->display_options_adv();
+        }
+    }
+
+    public function allow_add_questions(): bool {
+        // As we dont want to create questions in this page.
+        return false;
+    }
+
+    /**
+     * Default sort for question data.
+     * @return array
+     */
+    protected function default_sort(): array {
+        $defaultsort = [];
+        if (class_exists('\\qbank_viewcreator\\creator_name_column')) {
+            $sort = 'qbank_viewcreator\creator_name_column-timecreated';
+        }
+        $defaultsort[$sort] = 1;
+
+        return $defaultsort;
+    }
+
+    protected function build_query(): void {
+        // Get the required tables and fields.
+        [$fields, $joins] = $this->get_component_requirements(array_merge($this->requiredcolumns, $this->questionactions));
+
+        // Build the order by clause.
+        $sorts = [];
+        foreach ($this->sort as $sortname => $sortorder) {
+            list($colname, $subsort) = $this->parse_subsort($sortname);
+            $sorts[] = $this->requiredcolumns[$colname]->sort_expression($sortorder == SORT_DESC, $subsort);
+        }
+
+        // Build the where clause.
+        $entryid = "qbe.id = $this->entryid";
+        // Changes done here to get the questions only for the passed entryid.
+        $tests = ['q.parent = 0', $entryid];
+        $this->sqlparams = [];
+        foreach ($this->searchconditions as $searchcondition) {
+            if ($searchcondition->where()) {
+                $tests[] = '((' . $searchcondition->where() .'))';
+            }
+            if ($searchcondition->params()) {
+                $this->sqlparams = array_merge($this->sqlparams, $searchcondition->params());
+            }
+        }
+        // Build the SQL.
+        $sql = ' FROM {question} q ' . implode(' ', $joins);
+        $sql .= ' WHERE ' . implode(' AND ', $tests);
+        $this->countsql = 'SELECT count(1)' . $sql;
+        $this->loadsql = 'SELECT ' . implode(', ', $fields) . $sql . ' ORDER BY ' . implode(', ', $sorts);
+    }
+
+    /**
+     * Display the header for the question bank in the history page to include question name and type.
+     */
+    public function display_question_bank_header(): void {
+        global $PAGE, $DB, $OUTPUT;
+        $sql = 'SELECT q.*
+                 FROM {question} q
+                 JOIN {question_versions} qv ON qv.questionid = q.id
+                 JOIN {question_bank_entries} qbe ON qbe.id = qv.questionbankentryid
+                WHERE qv.version  = (SELECT MAX(v.version)
+                                       FROM {question_versions} v
+                                       JOIN {question_bank_entries} be
+                                         ON be.id = v.questionbankentryid
+                                      WHERE be.id = qbe.id)
+                  AND qbe.id = ?';
+        $latestquestiondata = $DB->get_record_sql($sql, [$this->entryid]);
+        if ($latestquestiondata) {
+            $historydata = [
+                'questionname' => $latestquestiondata->name,
+                'returnurl' => $this->basereturnurl,
+                'questionicon' => print_question_icon($latestquestiondata)
+            ];
+            // Header for the page before the actual form from the api.
+            echo $PAGE->get_renderer('qbank_history')->render_history_header($historydata);
+        } else {
+            // Continue when all the question versions are deleted.
+            echo $OUTPUT->notification(get_string('allquestionversionsdeleted', 'qbank_history'), 'notifysuccess');
+            echo $OUTPUT->continue_button($this->basereturnurl);
+        }
+    }
+
+    public function is_listing_specific_versions(): bool {
+        return true;
+    }
+
+    /**
+     * Override wanted_filters so that we apply the filters provided by the URL, but don't display the filter UI.
+     *
+     * @return void
+     */
+    public function wanted_filters(): void {
+        $this->display_question_bank_header();
+        // Add search conditions.
+        $this->add_standard_search_conditions();
+    }
+
+}

question/bank/history/classes/version_number_column.php

@@ -0,0 +1,47 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history;
+
+use core_question\local\bank\column_base;
+
+/**
+ * Question bank column for the question version number.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class version_number_column extends column_base {
+
+    public function get_name(): string {
+        return 'questionversionnumber';
+    }
+
+    public function get_title(): string {
+        return get_string('questionversionnumber', 'qbank_history');
+    }
+
+    protected function display_content($question, $rowclasses): void {
+        print_string('questionversiondata', 'qbank_history', $question->version);
+    }
+
+    public function get_extra_classes(): array {
+        return ['pr-3'];
+    }
+
+}

question/bank/history/history.php

@@ -0,0 +1,58 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Question history preview.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+require_once(__DIR__ . '/../../../config.php');
+require_once($CFG->dirroot . '/question/editlib.php');
+
+require_login();
+core_question\local\bank\helper::require_plugin_enabled('qbank_history');
+
+$entryid = required_param('entryid', PARAM_INT);
+$returnurl = required_param('returnurl', PARAM_LOCALURL);
+
+list($thispageurl, $contexts, $cmid, $cm, $module, $pagevars) =
+        question_edit_setup('questions', '/question/bank/history/history.php');
+$pagevars['entryid'] = $entryid;
+$pagevars['returnurl'] = $returnurl;
+$url = new moodle_url($thispageurl, ['entryid' => $entryid, 'returnurl' => $returnurl]);
+$PAGE->set_url($url);
+
+// Additional param to differentiate with other question bank view.
+$extraparams['entryid'] = $entryid;
+$extraparams['returnurl'] = $returnurl;
+$questionbank = new \qbank_history\question_history_view($contexts, $url, $COURSE, null, $pagevars, $extraparams);
+
+$streditingquestions = get_string('history_header', 'qbank_history');
+$PAGE->set_title($streditingquestions);
+$PAGE->set_heading($streditingquestions);
+$context = $contexts->lowest();
+$PAGE->set_context($context);
+$PAGE->navbar->add(get_string('question'), new moodle_url($returnurl));
+$PAGE->navbar->add($streditingquestions, $url);
+
+echo $OUTPUT->header();
+// Print the question area.
+$questionbank->display();
+echo $OUTPUT->footer();

question/bank/history/lang/en/qbank_history.php

@@ -0,0 +1,33 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Strings for component qbank_history, language 'en'.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+$string['allquestionversionsdeleted'] = 'All versions of this question have been deleted.';
+$string['close_history'] = 'Close';
+$string['history_action'] = 'History';
+$string['history_header'] = 'Question history';
+$string['pluginname'] = 'Question history';
+$string['privacy:metadata'] = 'The Question history question bank plugin does not store any personal data.';
+$string['questionversionnumber'] = 'Version';
+$string['questionversiondata'] = 'v{$a}';

question/bank/history/templates/history_header.mustache

@@ -0,0 +1,45 @@
+{{!
+    This file is part of Moodle - http://moodle.org/
+
+    Moodle is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    Moodle is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+}}
+{{!
+    @template qbank_history/history_header
+
+    The header of the history page.
+    * returnurl - The url of the page to return to, usually the base qbank page
+    * questionincon - The icon of the question type
+    * questionname - The name of the latest question version
+
+    Example context (json):
+    {
+        "returnurl": "https://url/courseid=1",
+        "questionicon": "<i class='fa fa-address-book'></i>",
+        "questionname": "Question 1"
+    }
+}}
+
+<div class="history-header mb-3">
+    <div class="row">
+        <div class="col-8 text-left font-weight-bold">
+            <h3>
+                {{{questionicon}}}
+                {{questionname}}
+            </h3>
+        </div>
+        <div class="col-4 text-right">
+            <a class="btn btn-secondary" id="qbank-history-close" href="{{{returnurl}}}">{{#str}} close_history, qbank_history {{/str}}</a>
+        </div>
+    </div>
+</div>

question/bank/history/tests/behat/question_history_action.feature

@@ -0,0 +1,68 @@
+@qbank @qbank_history
+Feature: Use the qbank plugin manager page for question history
+  In order to check the plugin behaviour with enable and disable
+
+  Background:
+    Given the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+    And the following "activities" exist:
+      | activity   | name      | course | idnumber |
+      | quiz       | Test quiz | C1     | quiz1    |
+    And the following "question categories" exist:
+      | contextlevel | reference | name           |
+      | Course         | C1     | Test questions |
+    And the following "questions" exist:
+      | questioncategory | qtype     | name           | questiontext              |
+      | Test questions   | truefalse | First question | Answer the first question |
+
+  Scenario: Enable/disable question history column from the base view
+    Given I log in as "admin"
+    When I navigate to "Plugins > Question bank plugins > Manage question bank plugins" in site administration
+    And I should see "Question history"
+    And I click on "Disable" "link" in the "Question history" "table_row"
+    And I am on the "Test quiz" "mod_quiz > question bank" page
+    Then the "History" action should not exist for the "First question" question in the question bank
+    And I navigate to "Plugins > Question bank plugins > Manage question bank plugins" in site administration
+    And I click on "Enable" "link" in the "Question history" "table_row"
+    And I am on the "Test quiz" "mod_quiz > question bank" page
+    Then the "History" action should exist for the "First question" question in the question bank
+
+  Scenario: History page shows only the specified features and questions
+    Given I am on the "Test quiz" "mod_quiz > question bank" page logged in as "admin"
+    And I choose "History" action for "First question" in the question bank
+    And I should see "Question"
+    And I should see "Actions"
+    And I should see "Status"
+    And I should see "Version"
+    And I should see "Created by"
+    And I should see "First question"
+    And the "History" action should not exist for the "First question" question in the question bank
+
+  @javascript
+  Scenario: Viewing history for a question in a non-default category
+    Given the following "question categories" exist:
+      | contextlevel | reference | name             |
+      | Course       | C1        | Test questions 2 |
+    And the following "questions" exist:
+      | questioncategory | qtype     | name            | questiontext               |
+      | Test questions 2 | truefalse | Second question | Answer the second question |
+    And I am on the "Test quiz" "mod_quiz > question bank" page logged in as "admin"
+    And I apply question bank filter "Category" with value "Test questions 2"
+    And I choose "History" action for "Second question" in the question bank
+    Then I should see "Question history"
+    And "Filter 1" "fieldset" should not exist
+    And I should see "Second question"
+    And "Second question" "table_row" should exist
+
+  @javascript
+  Scenario: Delete question from the history using Edit question menu
+    Given I am on the "Test quiz" "mod_quiz > question bank" page logged in as "admin"
+    And I choose "History" action for "First question" in the question bank
+    When I choose "Delete" action for "First question" in the question bank
+    And I press "Delete"
+    And I should not see "First question"
+    Then I should see "All versions of this question have been deleted."
+    And I click on "Continue" "button"
+    And I should see "Question bank"
+    And I should not see "First question"

question/bank/history/tests/behat/question_version_column.feature

@@ -0,0 +1,29 @@
+@qbank @qbank_history
+Feature: Use the qbank plugin manager page for version column
+  In order to check the plugin behaviour with enable and disable
+
+  Background:
+    Given the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+    And the following "activities" exist:
+      | activity   | name      | course | idnumber |
+      | quiz       | Test quiz | C1     | quiz1    |
+    And the following "question categories" exist:
+      | contextlevel | reference | name           |
+      | Course         | C1     | Test questions |
+    And the following "questions" exist:
+      | questioncategory | qtype     | name           | questiontext              |
+      | Test questions   | truefalse | First question | Answer the first question |
+
+  Scenario: Enable/disable version column from the base view
+    Given I log in as "admin"
+    And I navigate to "Plugins > Question bank plugins > Manage question bank plugins" in site administration
+    And I should see "Question history"
+    When I click on "Disable" "link" in the "Question history" "table_row"
+    And I am on the "Test quiz" "mod_quiz > question bank" page
+    Then I should not see "Version" in the "region-main" "region"
+    And I navigate to "Plugins > Question bank plugins > Manage question bank plugins" in site administration
+    And I click on "Enable" "link" in the "Question history" "table_row"
+    And I am on the "Test quiz" "mod_quiz > question bank" page
+    And I should see "Version" in the "region-main" "region"

question/bank/history/tests/helper_test.php

@@ -0,0 +1,118 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history;
+
+use question_bank;
+
+/**
+ * Helper class test.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ * @coversDefaultClass \qbank_history\helper
+ */
+class helper_test extends \advanced_testcase {
+    /**
+     * @var bool|\context|\context_course $context
+     */
+    public $context;
+
+    /**
+     * @var object $questiondata;
+     */
+    public $questiondata;
+
+    /**
+     * @var \moodle_url $returnurl
+     */
+    public $returnurl;
+
+    /**
+     * @var int $courseid
+     */
+    public $courseid;
+
+    /**
+     * Test set up.
+     *
+     * This is executed before running any test in this file.
+     */
+    public function setUp(): void {
+        $this->setAdminUser();
+        $generator = $this->getDataGenerator();
+        $questiongenerator = $generator->get_plugin_generator('core_question');
+        // Create a course.
+        $course = $generator->create_course();
+        $this->courseid = $course->id;
+        $this->context = \context_course::instance($course->id);
+        // Create a question in the default category.
+        $contexts = new \core_question\local\bank\question_edit_contexts($this->context);
+        $cat = question_make_default_categories($contexts->all());
+        $question = $questiongenerator->create_question('numerical', null,
+            ['name' => 'Example question', 'category' => $cat->id]);
+        $this->questiondata = question_bank::load_question($question->id);
+        $this->returnurl = new \moodle_url('/question/edit.php');
+    }
+
+    /**
+     * Test the history action url from the helper class.
+     *
+     * @covers ::question_history_url
+     */
+    public function test_question_history_url(): void {
+        $this->resetAfterTest();
+        $filter = urlencode('filters[]');
+        $actionurl = helper::question_history_url(
+            $this->questiondata->questionbankentryid,
+            $this->returnurl,
+            $this->courseid,
+            $filter,
+        );
+        $params = [
+            'entryid' => $this->questiondata->questionbankentryid,
+            'returnurl' => $this->returnurl,
+            'courseid' => $this->courseid,
+            'filter' => $filter,
+        ];
+        $expectedurl = new \moodle_url('/question/bank/history/history.php', $params);
+        $this->assertEquals($expectedurl, $actionurl);
+    }
+
+    /**
+     * Test the history action url when the filter parameter is null.
+     *
+     * @covers ::question_history_url
+     */
+    public function test_question_history_url_null_filter(): void {
+        $this->resetAfterTest();
+        $actionurl = helper::question_history_url(
+            $this->questiondata->questionbankentryid,
+            $this->returnurl,
+            $this->courseid,
+            null,
+        );
+        $params = [
+            'entryid' => $this->questiondata->questionbankentryid,
+            'returnurl' => $this->returnurl,
+            'courseid' => $this->courseid,
+        ];
+        $expectedurl = new \moodle_url('/question/bank/history/history.php', $params);
+        $this->assertEquals($expectedurl, $actionurl);
+    }
+}

question/bank/history/tests/question_history_view_test.php

@@ -0,0 +1,138 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace qbank_history;
+
+defined('MOODLE_INTERNAL') || die();
+
+global $CFG;
+require_once($CFG->dirroot . '/question/editlib.php');
+
+/**
+ * Custom history view - qbank api test.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ * @coversDefaultClass \qbank_history\question_history_view
+ */
+class question_history_view_test extends \advanced_testcase {
+
+    /**
+     * Test that the history page shows all the versions of a question.
+     *
+     * @covers ::display
+     */
+    public function test_question_history_shows_all_versions(): void {
+        $this->resetAfterTest();
+        $this->setAdminUser();
+        $generator = $this->getDataGenerator();
+        $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question');
+
+        // Create a course.
+        $course = $generator->create_course();
+        $context = \context_course::instance($course->id);
+
+        // Create a question in the default category.
+        $contexts = new \core_question\local\bank\question_edit_contexts($context);
+        $cat = $questiongenerator->create_question_category();
+        $questiondata1 = $questiongenerator->create_question('numerical', null,
+            ['name' => 'Example question', 'category' => $cat->id]);
+
+        // Create a new version.
+        $questiondata2 = $questiongenerator->update_question($questiondata1, null,
+            ['name' => 'Example question second version']);
+
+        $entry = get_question_bank_entry($questiondata1->id);
+
+        $pagevars = [
+            'qpage' => 0,
+            'qperpage' => DEFAULT_QUESTIONS_PER_PAGE,
+            'cat' => $cat->id . ',' . $cat->contextid,
+            'tabname' => 'questions'
+        ];
+        // Generate the view.
+        $viewclass = \qbank_history\question_history_view::class;
+        $extraparams = [
+            'view' => $viewclass,
+            'entryid' => $entry->id,
+            'returnurl' => "/",
+        ];
+        $view = new $viewclass($contexts, new \moodle_url('/'), $course, null, $pagevars, $extraparams);
+        ob_start();
+        $view->display();
+        $html = ob_get_clean();
+
+        // Verify the output includes the first version.
+        $this->assertStringContainsString($questiondata1->name, $html);
+
+        // Verify the output includes the second version.
+        $this->assertStringContainsString($questiondata2->name, $html);
+    }
+
+    /**
+     * Test that the question bank header in the history page shows the latest question.
+     *
+     * @covers ::display_question_bank_header
+     */
+    public function test_display_question_bank_header(): void {
+        $this->resetAfterTest();
+        $this->setAdminUser();
+        $generator = $this->getDataGenerator();
+        $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question');
+
+        // Create a course.
+        $course = $generator->create_course();
+        $context = \context_course::instance($course->id);
+
+        // Create a question in the default category.
+        $contexts = new \core_question\local\bank\question_edit_contexts($context);
+        $cat = $questiongenerator->create_question_category();
+        $questiondata1 = $questiongenerator->create_question('numerical', null,
+            ['name' => 'First version', 'category' => $cat->id]);
+
+        $entry = get_question_bank_entry($questiondata1->id);
+        $pagevars = [
+            'qpage' => 0,
+            'qperpage' => DEFAULT_QUESTIONS_PER_PAGE,
+            'cat' => $cat->id . ',' . $cat->contextid,
+            'tabname' => 'questions'
+        ];
+        // Generate the view.
+        $viewclass = \qbank_history\question_history_view::class;
+        $extraparams = [
+            'view' => $viewclass,
+            'entryid' => $entry->id,
+            'returnurl' => "/",
+        ];
+        $view = new $viewclass($contexts, new \moodle_url('/'), $course,  null, $pagevars, $extraparams);
+        ob_start();
+        $view->display_question_bank_header();
+        $headerhtml = ob_get_clean();
+        // Verify the output includes the latest version.
+        $this->assertStringContainsString($questiondata1->name, $headerhtml);
+
+        $questiondata2 = $questiongenerator->update_question($questiondata1, null,
+            ['name' => 'Second version']);
+        $view = new $viewclass($contexts, new \moodle_url('/'), $course,  null, $pagevars, $extraparams);
+        ob_start();
+        $view->display_question_bank_header();
+        $headerhtml = ob_get_clean();
+
+        $this->assertStringContainsString($questiondata2->name, $headerhtml);
+    }
+}

question/bank/history/version.php

@@ -0,0 +1,31 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * Version information for qbank_history.
+ *
+ * @package    qbank_history
+ * @copyright  2022 Catalyst IT Australia Pty Ltd
+ * @author     Safat Shahin <safatshahin@catalyst-au.net>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$plugin->component = 'qbank_history';
+$plugin->version   = 2024042200;
+$plugin->requires  = 2024041600;
+$plugin->maturity  = MATURITY_STABLE;