MDL-75423 gradereport_singleview: Trigger element for the user selector

Creates a renderer method and a template for the element that would
trigger the user selector.
This commit is contained in:
Mihail Geshoski
2022-11-10 22:43:13 +08:00
parent 809781c0cc
commit b184296316
3 changed files with 140 additions and 0 deletions
+64
View File
@@ -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/>.
/**
* Renderer for the grade single view report.
*
* @package gradereport_singleview
* @copyright 2022 Mihail Geshoski <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
/**
* Custom renderer for the single view report.
*
* To get an instance of this use the following code:
* $renderer = $PAGE->get_renderer('gradereport_singleview');
*
* @copyright 2022 Mihail Geshoski <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class gradereport_singleview_renderer extends plugin_renderer_base {
/**
* Renders the user selector trigger element.
*
* @param object $course The course object.
* @param int|null $userid The user ID.
* @param int|null $groupid The group ID.
* @return string The raw HTML to render.
*/
public function users_selector(object $course, ?int $userid = null, ?int $groupid = null): string {
$data = [
'courseid' => $course->id,
'groupid' => $groupid ?? 0,
];
// If a particular user option is selected (not in zero state).
if ($userid) { // A single user selected.
$user = core_user::get_user($userid);
$data['selectedoption'] = [
'image' => $this->user_picture($user, ['size' => 40, 'link' => false]),
'text' => fullname($user),
'additionaltext' => $user->email,
];
}
$this->page->requires->js_call_amd('gradereport_singleview/user', 'init');
return $this->render_from_template('gradereport_singleview/user_selector', $data);
}
}
+5
View File
@@ -102,3 +102,8 @@
height: 150px;
overflow: auto;
}
.path-grade-report-singleview .user-selector .userinitials {
width: 40px;
height: 40px;
}
@@ -0,0 +1,71 @@
{{!
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 gradereport_singleview/user_selector
The user selector trigger element.
Context variables required for this template:
* courseid - The course ID.
* groupid - The group ID.
* selectedoption - (optional) Object containing information about the selected option.
* image - The image corresponding to the selected option.
* text - The text of the selected option.
* additionaltext - (optional) Additional text displayed below the selected option (e.g. the user email)
Example context (json):
{
"courseid": "2",
"groupid": "2",
"selectedoption": {
"image": "<img src=\"http://example.com/pluginfile.php/14/user/icon/boost/f2\" class=\"userpicture\" width=\"40\" alt=\"\">",
"text": "John Doe",
"additionaltext": "[email protected]"
}
}
}}
<div class="user-selector d-flex">
<div role="button" class="userwidget btn dropdown-toggle d-flex text-left align-items-center p-0" data-courseid="{{courseid}}" data-groupid="{{groupid}}" data-searchtype="user" tabindex="0" aria-label="{{#str}} selctauser, core {{/str}}">
<div class="align-items-center d-flex">
{{#selectedoption}}
<div class="selected-option-img d-block pr-2">
{{#image}}
{{{image}}}
{{/image}}
{{^image}}
<span class="userinitials"></span>
{{/image}}
</div>
<div class="selected-option-info d-block pr-3">
<span class="selected-option-text p-0 font-weight-bold">
{{text}}
</span>
{{#additionaltext}}
<span class="d-block small">
{{additionaltext}}
</span>
{{/additionaltext}}
</div>
{{/selectedoption}}
{{^selectedoption}}
<div class="d-block pr-2">
<span class="userinitials"></span>
</div>
<div class="user-info d-block pr-3">
{{#str}} selctauser, core {{/str}}
</div>
{{/selectedoption}}
</div>
</div>
</div>