Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?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);