<?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_columnsortorder;
defined('MOODLE_INTERNAL') || die();
use advanced_testcase;
use context_course;
> use core_question\local\bank\column_base;
use core_question\local\bank\question_edit_contexts;
use core_question\local\bank\view;
use moodle_url;
< use qbank_columnsortorder\external\set_columnbank_order;
global $CFG;
require_once($CFG->dirroot . '/question/tests/fixtures/testable_core_question_column.php');
require_once($CFG->dirroot . '/question/classes/external.php');
/**
* Test class for columnsortorder feature.
*
* @package qbank_columnsortorder
* @copyright 2021 Catalyst IT Australia Pty Ltd
* @author Ghaly Marc-Alexandre <marc-alexandreghaly@catalyst-ca.net>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
< * @coversDefaultClass \qbank_columnsortorder\column_manager
> * @covers \qbank_columnsortorder\column_manager
*/
class column_manager_test extends advanced_testcase {
> /**
> * Generate a course and return a question bank view for the course context.
/** @var \stdClass course record. */
> *
protected $course;
> * @return view
> */
/** @var \core_question\local\bank\view */
> protected static function get_question_bank(): view {
protected $questionbank;
> $course = self::getDataGenerator()->create_course();
> $questionbank = new view(
/** @var array */
> new question_edit_contexts(context_course::instance($course->id)),
protected $columns;
> new moodle_url('/'),
> $course
/** @var \qbank_columnsortorder\column_manager */
> );
protected $columnmanager;
> return $questionbank;
> }
< /** @var \stdClass course record. */
< protected $course;
> /**
> * Return an array of visible columns for the question bank.
> *
> * @return array
> */
> protected static function get_columns(): array {
> $questionbank = self::get_question_bank();
> $columns = [];
> foreach ($questionbank->get_visiblecolumns() as $column) {
> $columns[] = $column->get_column_id();
> }
> return $columns;
> }
< /** @var \core_question\local\bank\view */
< protected $questionbank;
> /**
> * Provide examples for testing each column setting function, with test data and data format.
> *
> * @return array[]
> */
> public static function settings_provider(): array {
> return [
> 'Test set_column_order' => [
> 'setting' => 'enabledcol',
> 'function' => 'set_column_order',
> 'datamethod' => [__CLASS__, 'get_columns'],
> 'csv' => true,
> ],
> 'Test set_hidden_columns' => [
> 'setting' => 'hiddencols',
> 'function' => 'set_hidden_columns',
> 'datamethod' => [__CLASS__, 'get_columns'],
> 'csv' => true,
> ],
> 'Test set_column_size' => [
> 'setting' => 'colsize',
> 'function' => 'set_column_size',
> 'datamethod' => 'random_string',
> 'csv' => false,
> ],
> ];
> }
< /** @var array */
< protected $columns;
> /**
> * Retrieve data using the specified method.
> * This function is used to retrieve data from various data methods defined within this class.
> *
> * @param array|string $datamethod This can be either a function name or an array containing the class and method name.
> * @return array|string The retrieved data as an array or string, depending on the data method used.
> */
> protected function get_data_from_datamethod(array|string $datamethod): array|string {
> return call_user_func($datamethod);
> }
< /** @var \qbank_columnsortorder\column_manager */
< protected $columnmanager;
< * Setup testcase.
> * Test setting config settings
> *
> * @dataProvider settings_provider
> * @param string $setting The name of the setting being saved
> * @param string $function The name of the function being called
> * @param array|string $datamethod The property of the test class to pass to the function.
> * @param bool $csv True of the data is stored as a comma-separated list.
> * @return void
< public function setUp(): void {
> public function test_settings(
> string $setting,
> string $function,
> array|string $datamethod,
> bool $csv,
> ): void {
> $data = $this->get_data_from_datamethod($datamethod);
> $this->setAdminUser();
new moodle_url('/'),
> $this->assertFalse(get_config('qbank_columnsortorder', $setting));
$this->course
> $this->assertEmpty(get_user_preferences('qbank_columnsortorder_' . $setting));
);
> column_manager::{$function}($data, true);
> $expected = $csv ? implode(',', $data) : $data;
// Get current view columns.
> $this->assertEquals($expected, get_config('qbank_columnsortorder', $setting));
$this->columns = [];
> $this->assertEmpty(get_user_preferences('qbank_columnsortorder_' . $setting));
foreach ($this->questionbank->get_visiblecolumns() as $columnn) {
> }
$this->columns[] = get_class($columnn);
>
}
> /**
$this->columnmanager = new column_manager();
> * Test passing null clears the corresponding config setting.
}
> *
> * @dataProvider settings_provider
/**
> * @param string $setting The name of the setting being saved
* Test function get_columns in helper class, that proper data is returned.
> * @param string $function The name of the function being called
*
> * @param array|string $datamethod The property of the test class to pass to the function.
* @covers ::get_columns
> * @param bool $csv True of the data is stored as a comma-separated list.
*/
> * @return void
public function test_getcolumns_function(): void {
> */
$questionlistcolumns = $this->columnmanager->get_columns();
> public function test_reset_settings(
$this->assertIsArray($questionlistcolumns);
> string $setting,
foreach ($questionlistcolumns as $columnnobject) {
> string $function,
$this->assertObjectHasAttribute('class', $columnnobject);
> array|string $datamethod,
$this->assertObjectHasAttribute('name', $columnnobject);
> bool $csv,
$this->assertObjectHasAttribute('colname', $columnnobject);
> ): void {
}
> $data = $this->get_data_from_datamethod($datamethod);
< $this->course = $this->getDataGenerator()->create_course();
< // Creates question bank view.
< $this->questionbank = new view(
< new question_edit_contexts(context_course::instance($this->course->id)),
< new moodle_url('/'),
< $this->course
< );
> $this->resetAfterTest(true);
> $initial = $csv ? implode(',', $data) : $data;
> set_config($setting, $initial, 'qbank_columnsortorder');
> $this->assertEquals($initial, get_config('qbank_columnsortorder', $setting));
> column_manager::{$function}(null, true);
> $this->assertFalse(get_config('qbank_columnsortorder', $setting));
> }
< // Get current view columns.
< $this->columns = [];
< foreach ($this->questionbank->get_visiblecolumns() as $columnn) {
< $this->columns[] = get_class($columnn);
> /**
> * Test setting user preferences
> *
> * @dataProvider settings_provider
> * @param string $setting The name of the setting being saved
> * @param string $function The name of the function being called
> * @param array|string $datamethod The property of the test class to pass to the function.
> * @param bool $csv True of the data is stored as a comma-separated list.
> * @return void
> */
> public function test_settings_user(
> string $setting,
> string $function,
> array|string $datamethod,
> bool $csv,
> ): void {
> $this->resetAfterTest(true);
> $data = $this->get_data_from_datamethod($datamethod);
> $this->assertFalse(get_config('qbank_columnsortorder', $setting));
> $this->assertEmpty(get_user_preferences('qbank_columnsortorder_' . $setting));
> column_manager::{$function}($data);
> $expected = $csv ? implode(',', $data) : $data;
> $this->assertFalse(get_config('qbank_columnsortorder', $setting));
> $this->assertEquals($expected, get_user_preferences('qbank_columnsortorder_' . $setting));
< $this->columnmanager = new column_manager();
>
> /**
> * Test passing null clears the corresponding user preference.
> *
> * @dataProvider settings_provider
> * @param string $setting The name of the setting being saved
> * @param string $function The name of the function being called
> * @param array|string $datamethod The property of the test class to pass to the function.
> * @param bool $csv True of the data is stored as a comma-separated list.
> * @return void
> */
> public function test_reset_user_settings(
> string $setting,
> string $function,
> array|string $datamethod,
> bool $csv,
> ): void {
> $data = $this->get_data_from_datamethod($datamethod);
> $this->setAdminUser();
> $this->resetAfterTest(true);
> $initial = $csv ? implode(',', $data) : $data;
> set_user_preference('qbank_columnsortorder_' . $setting, $initial);
> $this->assertEquals($initial, get_user_preferences('qbank_columnsortorder_' . $setting));
> column_manager::{$function}(null);
> $this->assertEmpty(get_user_preferences('qbank_columnsortorder_' . $setting));
< $questionlistcolumns = $this->columnmanager->get_columns();
> $this->resetAfterTest(true);
> $this->setAdminUser();
> $columnmanager = new column_manager(true);
> $questionlistcolumns = $columnmanager->get_columns();
< * Test function sort columns method.
> * The get_sorted_columns method should return the provided columns sorted according to enabledcol setting.
< * @covers ::get_sorted_columns
> * @return void
< $neworder = $this->columnmanager->get_sorted_columns($this->columns);
> $this->resetAfterTest(true);
> $this->setAdminUser();
> $questionbank = $this->get_question_bank();
> $columns = $this->get_columns($questionbank);
> $neworder = $columns;
< set_columnbank_order::execute($neworder);
< $currentconfig = get_config('qbank_columnsortorder', 'enabledcol');
< $currentconfig = explode(',', $currentconfig);
< ksort($currentconfig);
< $this->assertSame($neworder, $currentconfig);
> set_config('enabledcol', implode(',', $neworder), 'qbank_columnsortorder');
>
> $columnmanager = new column_manager(true);
> $columnstosort = [];
> foreach ($columns as $column) {
> $columnstosort[$column] = $column;
> }
>
> $sortedcolumns = $columnmanager->get_sorted_columns($columnstosort);
>
> $expectedorder = ['core_question\local\bank\checkbox_column' . column_base::ID_SEPARATOR . 'checkbox_column' => 0];
> foreach ($neworder as $columnid) {
> $expectedorder[$columnid] = $columnid;
> }
> $this->assertSame($expectedorder, $sortedcolumns);
< * Test function enabing and disablingcolumns.
> * Test disabled columns are removed from enabledcol setting and added to disabledcol setting.
< * @covers ::enable_columns
< * @covers ::disable_columns
> * @return void
< public function test_enable_disable_columns(): void {
< $neworder = $this->columnmanager->get_sorted_columns($this->columns);
> public function test_disable_columns(): void {
> $this->resetAfterTest(true);
> $this->setAdminUser();
> $questionbank = $this->get_question_bank();
> $columns = $this->get_columns($questionbank);
> // Set up enabledcol with all plugins.
> set_config('enabledcol', implode(',', $columns), 'qbank_columnsortorder');
> $questionbank = $this->get_question_bank();
> $columns = $this->get_columns($questionbank);
> $columnmanager = new column_manager(true);
> $this->assertFalse(get_config('qbank_columnsortorder', 'disabledcol'));
>
> // Disable a random plugin.
> $plugincolumns = array_filter($columns, fn($column) => str_starts_with($column, 'qbank_'));
> $randomcolumn = $plugincolumns[array_rand($plugincolumns, 1)];
> $randomplugin = explode('\\', $randomcolumn)[0];
> $columnmanager->disable_columns($randomplugin);
>
> // The enabledcol setting should now contain all columns except the disabled plugin.
> $expectedconfig = array_filter($columns, fn($column) => !str_starts_with($column, $randomplugin));
> sort($expectedconfig);
> $newconfig = explode(',', get_config('qbank_columnsortorder', 'enabledcol'));
> sort($newconfig);
> $this->assertEquals($expectedconfig, $newconfig);
> $this->assertNotContains($randomcolumn, $newconfig);
> // The disabledcol setting should only contain columns from the disabled plugin.
> $disabledconfig = explode(',', get_config('qbank_columnsortorder', 'disabledcol'));
> array_walk($disabledconfig, fn($column) => $this->assertStringStartsWith($randomplugin, $column));
> }
>
> /**
> * Test enabling and disabling columns through event observers
> *
> * @covers \qbank_columnsortorder\event\plugin_observer
> */
> public function test_plugin_enabled_disabled_observers(): void {
> $this->resetAfterTest(true);
> $this->setAdminUser();
> $questionbank = $this->get_question_bank();
> $columns = $this->get_columns($questionbank);
> $columnmanager = new column_manager(true);
> $neworder = $columnmanager->get_sorted_columns($columns);
< set_columnbank_order::execute($neworder);
> $columnmanager::set_column_order($neworder, true);
> // Get the list of enabled columns, excluding core columns (we can't disable those).
$currentconfig = get_config('qbank_columnsortorder', 'enabledcol');
< $currentconfig = explode(',', $currentconfig);
< $class = $currentconfig[array_rand($currentconfig, 1)];
< $randomplugintodisable = explode('\\', $class)[0];
> $currentconfig = array_filter(explode(',', $currentconfig), fn($class) => !str_starts_with($class, 'core'));
> // Pick a column at random and get its plugin name.
> $randomcolumnid = $currentconfig[array_rand($currentconfig, 1)];
> [$randomcolumnclass] = explode(column_base::ID_SEPARATOR, $randomcolumnid, 2);
> [$randomplugintodisable] = explode('\\', $randomcolumnclass);
$olddisabledconfig = get_config('qbank_columnsortorder', 'disabledcol');
< $this->columnmanager->disable_columns($randomplugintodisable);
> \core\event\qbank_plugin_disabled::create_for_plugin($randomplugintodisable)->trigger();
$newdisabledconfig = get_config('qbank_columnsortorder', 'disabledcol');
$this->assertNotEquals($olddisabledconfig, $newdisabledconfig);
< $this->columnmanager->enable_columns($randomplugintodisable);
> \core\event\qbank_plugin_enabled::create_for_plugin($randomplugintodisable)->trigger();
$newdisabledconfig = get_config('qbank_columnsortorder', 'disabledcol');
$this->assertEmpty($newdisabledconfig);
$enabledconfig = get_config('qbank_columnsortorder', 'enabledcol');
$contains = strpos($enabledconfig, $randomplugintodisable);
$this->assertNotFalse($contains);
$this->assertIsInt($contains);
> }
}
>
}
> /**
> * Test enabled columns are removed from disabledcol setting and added to enabledcol setting.
> *
> * @return void
> */
> public function test_enable_columns() {
> $this->resetAfterTest(true);
> $this->setAdminUser();
> $questionbank = $this->get_question_bank();
> $columns = $this->get_columns($questionbank);
> // Set up disablecol with columns from 2 random plugins, and enabledcol with all other columns.
> $plugincolumns = array_filter($columns, fn($column) => str_starts_with($column, 'qbank_'));
> $plugins = array_unique(array_map(fn($column) => explode('\\', $column)[0], $plugincolumns));
> $randomplugins = array_rand($plugins, 2);
> $randomplugin1 = $plugins[$randomplugins[0]];
> $randomplugin2 = $plugins[$randomplugins[1]];
>
> $disabledcols = array_filter(
> $columns,
> fn($column) => str_starts_with($column, $randomplugin1) || str_starts_with($column, $randomplugin2)
> );
> $enabledcols = array_diff($columns, $disabledcols);
>
> set_config('enabledcol', implode(',', $enabledcols), 'qbank_columnsortorder');
> set_config('disabledcol', implode(',', $disabledcols), 'qbank_columnsortorder');
>
> // Enable one of the disabled plugins.
> $columnmanager = new column_manager(true);
> $columnmanager->enable_columns($randomplugin1);
> // The enabledcol setting should now contain all columns except the remaining disabled plugin.
> $expectedenabled = array_filter($columns, fn($column) => !str_starts_with($column, $randomplugin2));
> $expecteddisabled = array_filter($disabledcols, fn($column) => str_starts_with($column, $randomplugin2));
> sort($expectedenabled);
> sort($expecteddisabled);
> $newenabled = explode(',', get_config('qbank_columnsortorder', 'enabledcol'));
> sort($newenabled);
> $this->assertEquals($expectedenabled, $newenabled);
> $this->assertNotContains(reset($expecteddisabled), $newenabled);
> // The disabledcol setting should only contain columns from the remaining disabled plugin.
> $newdisabled = explode(',', get_config('qbank_columnsortorder', 'disabledcol'));
> array_walk($newdisabled, fn($column) => $this->assertStringStartsWith($randomplugin2, $column));
> }
>
> /**
> * Test that get_disabled_columns returns names of all the columns in the disabledcol setting
> *
> * @return void
> */
> public function test_get_disabled_columns(): void {
> $this->resetAfterTest(true);
> $this->setAdminUser();
> $questionbank = $this->get_question_bank();
> $columns = $this->get_columns($questionbank);
> // Set up disablecol with columns from 2 random plugins, and enabledcol with all other columns.
> $plugincolumns = array_filter($columns, fn($column) => str_starts_with($column, 'qbank_'));
> $randomcolumn = $plugincolumns[array_rand($plugincolumns, 1)];
> $randomplugin = explode('\\', $randomcolumn)[0];
>
> $disabledcols = array_filter($columns, fn($column) => str_starts_with($column, $randomplugin));
>
> set_config('disabledcol', implode(',', $disabledcols), 'qbank_columnsortorder');
>
> $columnmanager = new column_manager(true);
> $expecteddisablednames = [];
> foreach ($disabledcols as $disabledcolid) {
> [$columnclass, $columnname] = explode(column_base::ID_SEPARATOR, $disabledcolid, 2);
> $columnobject = $columnclass::from_column_name($questionbank, $columnname);
> $expecteddisablednames[$disabledcolid] = (object) [
> 'disabledname' => $columnobject->get_title(),
> ];
> }
> $disablednames = $columnmanager->get_disabled_columns();
> $this->assertEquals($expecteddisablednames, $disablednames);