Skip to content

Commit

Permalink
MDL-71613 qbank_viewcreator: Add View creator to core
Browse files Browse the repository at this point in the history
This implementation will introduce a qbank plugin "viewcreator"
which will view the question creator/modifier column in
the question bank view by replacing the core classes. Having
this plugin will give users the flexibility of enabling
or disabling the question creator and modifier column
in the question bank view.

Co-Authored-By: Marc-Alexandre Ghaly <[email protected]>
  • Loading branch information
marcghaly authored and safatshahin committed Aug 31, 2021
1 parent 206023c commit b006784
Show file tree
Hide file tree
Showing 13 changed files with 428 additions and 5 deletions.
1 change: 1 addition & 0 deletions lib/classes/plugin_manager.php
Original file line number Diff line number Diff line change
Expand Up @@ -1943,6 +1943,7 @@ public static function standard_plugins_list($type) {
'editquestion',
'exportquestions',
'importquestions',
'viewcreator',
],

'qbehaviour' => array(
Expand Down
74 changes: 74 additions & 0 deletions question/bank/viewcreator/classes/creator_name_column.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
<?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_viewcreator;

use core_question\local\bank\column_base;

/**
* A column type for the name of the question creator.
*
* @package qbank_viewcreator
* @copyright 2009 Tim Hunt
* @author 2021 Ghaly Marc-Alexandre <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class creator_name_column extends column_base {

public function get_name(): string {
return 'creatorname';
}

protected function get_title(): string {
return get_string('createdby', 'question');
}

protected function display_content($question, $rowclasses): void {
global $PAGE;
$displaydata = [];

if (!empty($question->creatorfirstname) && !empty($question->creatorlastname)) {
$u = new \stdClass();
$u = username_load_fields_from_object($u, $question, 'creator');
$displaydata['date'] = userdate($question->timecreated, get_string('strftimedatetime', 'langconfig'));
$displaydata['creator'] = fullname($u);
echo $PAGE->get_renderer('qbank_viewcreator')->render_creator_name($displaydata);
}
}

public function get_extra_joins(): array {
return ['uc' => 'LEFT JOIN {user} uc ON uc.id = q.createdby'];
}

public function get_required_fields(): array {
$allnames = \core_user\fields::get_name_fields();
$requiredfields = [];
foreach ($allnames as $allname) {
$requiredfields[] = 'uc.' . $allname . ' AS creator' . $allname;
}
$requiredfields[] = 'q.timecreated';
return $requiredfields;
}

public function is_sortable(): array {
return [
'firstname' => ['field' => 'uc.firstname', 'title' => get_string('firstname')],
'lastname' => ['field' => 'uc.lastname', 'title' => get_string('lastname')],
'timecreated' => ['field' => 'q.timecreated', 'title' => get_string('date')]
];
}

}
74 changes: 74 additions & 0 deletions question/bank/viewcreator/classes/modifier_name_column.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
<?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_viewcreator;

use core_question\local\bank\column_base;

/**
* A column type for the name of the question last modifier.
*
* @package qbank_viewcreator
* @copyright 2009 Tim Hunt
* @author 2021 Ghaly Marc-Alexandre <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class modifier_name_column extends column_base {

public function get_name(): string {
return 'modifiername';
}

protected function get_title(): string {
return get_string('lastmodifiedby', 'question');
}

protected function display_content($question, $rowclasses): void {
global $PAGE;
$displaydata = [];

if (!empty($question->modifierfirstname) && !empty($question->modifierlastname)) {
$u = new \stdClass();
$u = username_load_fields_from_object($u, $question, 'modifier');
$displaydata['date'] = userdate($question->timemodified, get_string('strftimedatetime', 'langconfig'));
$displaydata['modifier'] = fullname($u);
echo $PAGE->get_renderer('qbank_viewcreator')->render_modifier_name($displaydata);
}
}

public function get_extra_joins(): array {
return ['um' => 'LEFT JOIN {user} um ON um.id = q.modifiedby'];
}

public function get_required_fields(): array {
$allnames = \core_user\fields::get_name_fields();
$requiredfields = [];
foreach ($allnames as $allname) {
$requiredfields[] = 'um.' . $allname . ' AS modifier' . $allname;
}
$requiredfields[] = 'q.timemodified';
return $requiredfields;
}

public function is_sortable(): array {
return [
'firstname' => ['field' => 'um.firstname', 'title' => get_string('firstname')],
'lastname' => ['field' => 'um.lastname', 'title' => get_string('lastname')],
'timemodified' => ['field' => 'q.timemodified', 'title' => get_string('date')]
];
}

}
48 changes: 48 additions & 0 deletions question/bank/viewcreator/classes/output/renderer.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
<?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_viewcreator\output;

/**
* Class renderer.
* @package qbank_viewcreator
* @copyright 2021 Catalyst IT Australia Pty Ltd
* @author Ghaly Marc-Alexandre <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class renderer extends \plugin_renderer_base {

/**
* Render question creator.
*
* @param array $displaydata
* @return string
*/
public function render_creator_name($displaydata) {
return $this->render_from_template('qbank_viewcreator/creator_display', $displaydata);
}

/**
* Render question modifier.
*
* @param array $displaydata
* @return string
*/
public function render_modifier_name($displaydata) {
return $this->render_from_template('qbank_viewcreator/modifier_display', $displaydata);
}

}
37 changes: 37 additions & 0 deletions question/bank/viewcreator/classes/plugin_feature.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
<?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_viewcreator;

use core_question\local\bank\plugin_features_base;

/**
* Class plugin_feature is the entrypoint for the columns.
*
* @package qbank_viewcreator
* @copyright 2021 Catalyst IT Australia Pty Ltd
* @author Ghaly Marc-Alexandre <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class plugin_feature extends plugin_features_base {

public function get_question_columns($qbank): array {
return [
new creator_name_column($qbank),
new modifier_name_column($qbank)
];
}
}
32 changes: 32 additions & 0 deletions question/bank/viewcreator/classes/privacy/provider.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
<?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_viewcreator\privacy;

/**
* Privacy Subsystem for qbank_viewcreator implementing null_provider.
*
* @package qbank_viewcreator
* @copyright 2021 Catalyst IT Australia Pty Ltd
* @author Ghaly Marc-Alexandre <[email protected]>
* @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';
}
}
27 changes: 27 additions & 0 deletions question/bank/viewcreator/lang/en/qbank_viewcreator.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
<?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_viewcreator, language 'en'
*
* @package qbank_viewcreator
* @copyright 2021 Catalyst IT Australia Pty Ltd
* @author Ghaly Marc-Alexandre <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/

$string['pluginname'] = 'View creator';
$string['privacy:metadata'] = 'View creator question bank plugin does not store any user data.';
33 changes: 33 additions & 0 deletions question/bank/viewcreator/templates/creator_display.mustache
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
{{!
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_viewcreator/creator_display
Example context (json):
{
"displaydata": [
{
"creator": "Marc Ghaly",
"date": "2 June 2021, 5:32 PM",
}
]
}
}}

<span class="qbank-creator-name">
{{creator}}
</span>
<br>
<span class="date">
{{date}}
</span>
33 changes: 33 additions & 0 deletions question/bank/viewcreator/templates/modifier_display.mustache
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
{{!
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_viewcreator/modifier_display
Example context (json):
{
"displaydata": [
{
"modifier": "Marc Ghaly",
"date": "2 June 2021, 5:32 PM",
}
]
}
}}

<span class="qbank-creator-name">
{{modifier}}
</span>
<br>
<span class="date">
{{date}}
</span>
Loading

0 comments on commit b006784

Please sign in to comment.