1 |
efrain |
1 |
<?php
|
|
|
2 |
// This file is part of Moodle - http://moodle.org/
|
|
|
3 |
//
|
|
|
4 |
// Moodle is free software: you can redistribute it and/or modify
|
|
|
5 |
// it under the terms of the GNU General Public License as published by
|
|
|
6 |
// the Free Software Foundation, either version 3 of the License, or
|
|
|
7 |
// (at your option) any later version.
|
|
|
8 |
//
|
|
|
9 |
// Moodle is distributed in the hope that it will be useful,
|
|
|
10 |
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
11 |
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
12 |
// GNU General Public License for more details.
|
|
|
13 |
//
|
|
|
14 |
// You should have received a copy of the GNU General Public License
|
|
|
15 |
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
16 |
|
|
|
17 |
/**
|
|
|
18 |
* A single gradable area management page
|
|
|
19 |
*
|
|
|
20 |
* This page alows the user to set the current active method in the given
|
|
|
21 |
* area, provides access to the plugin editor and allows user to save the
|
|
|
22 |
* current form as a template or re-use some existing form.
|
|
|
23 |
*
|
|
|
24 |
* @package core_grading
|
|
|
25 |
* @copyright 2011 David Mudrak <david@moodle.com>
|
|
|
26 |
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
|
27 |
*/
|
|
|
28 |
|
|
|
29 |
require(__DIR__.'/../../config.php');
|
|
|
30 |
require_once($CFG->dirroot.'/grade/grading/lib.php');
|
|
|
31 |
|
|
|
32 |
// identify gradable area by its id
|
|
|
33 |
$areaid = optional_param('areaid', null, PARAM_INT);
|
|
|
34 |
// alternatively the context, component and areaname must be provided
|
|
|
35 |
$contextid = optional_param('contextid', null, PARAM_INT);
|
|
|
36 |
$component = optional_param('component', null, PARAM_COMPONENT);
|
|
|
37 |
$area = optional_param('area', null, PARAM_AREA);
|
|
|
38 |
// keep the caller's URL so that we know where to send the user finally
|
|
|
39 |
$returnurl = optional_param('returnurl', null, PARAM_LOCALURL);
|
|
|
40 |
// active method selector
|
|
|
41 |
$setmethod = optional_param('setmethod', null, PARAM_PLUGIN);
|
|
|
42 |
// publish the given form definition as a new template in the forms bank
|
|
|
43 |
$shareform = optional_param('shareform', null, PARAM_INT);
|
|
|
44 |
// delete the given form definition
|
|
|
45 |
$deleteform = optional_param('deleteform', null, PARAM_INT);
|
|
|
46 |
// consider the required action as confirmed
|
|
|
47 |
$confirmed = optional_param('confirmed', false, PARAM_BOOL);
|
|
|
48 |
// a message to display, typically a previous action's result
|
|
|
49 |
$message = optional_param('message', null, PARAM_NOTAGS);
|
|
|
50 |
|
|
|
51 |
if (!is_null($areaid)) {
|
|
|
52 |
// get manager by id
|
|
|
53 |
$manager = get_grading_manager($areaid);
|
|
|
54 |
} else {
|
|
|
55 |
// get manager by context and component
|
|
|
56 |
if (is_null($contextid) or is_null($component) or is_null($area)) {
|
|
|
57 |
throw new coding_exception('The caller script must identify the gradable area.');
|
|
|
58 |
}
|
|
|
59 |
$context = context::instance_by_id($contextid, MUST_EXIST);
|
|
|
60 |
$manager = get_grading_manager($context, $component, $area);
|
|
|
61 |
}
|
|
|
62 |
|
|
|
63 |
if ($manager->get_context()->contextlevel < CONTEXT_COURSE) {
|
|
|
64 |
throw new coding_exception('Unsupported gradable area context level');
|
|
|
65 |
}
|
|
|
66 |
|
|
|
67 |
// get the currently active method
|
|
|
68 |
$method = $manager->get_active_method();
|
|
|
69 |
|
|
|
70 |
list($context, $course, $cm) = get_context_info_array($manager->get_context()->id);
|
|
|
71 |
|
|
|
72 |
require_login($course, true, $cm);
|
|
|
73 |
require_capability('moodle/grade:managegradingforms', $context);
|
|
|
74 |
|
|
|
75 |
if (!empty($returnurl)) {
|
|
|
76 |
$returnurl = new moodle_url($returnurl);
|
|
|
77 |
} else {
|
|
|
78 |
$returnurl = null;
|
|
|
79 |
}
|
|
|
80 |
|
|
|
81 |
$PAGE->set_url($manager->get_management_url($returnurl));
|
|
|
82 |
navigation_node::override_active_url($manager->get_management_url());
|
|
|
83 |
$PAGE->set_title(get_string('gradingmanagement', 'core_grading'));
|
|
|
84 |
$PAGE->set_heading(get_string('gradingmanagement', 'core_grading'));
|
|
|
85 |
// We don't need to show the default header on a management page.
|
|
|
86 |
$PAGE->activityheader->disable();
|
|
|
87 |
$output = $PAGE->get_renderer('core_grading');
|
|
|
88 |
|
|
|
89 |
// process the eventual change of the active grading method
|
|
|
90 |
if (!empty($setmethod)) {
|
|
|
91 |
require_sesskey();
|
|
|
92 |
if ($setmethod == 'none') {
|
|
|
93 |
// here we expect that noone would actually want to call their plugin as 'none'
|
|
|
94 |
$setmethod = null;
|
|
|
95 |
}
|
|
|
96 |
$manager->set_active_method($setmethod);
|
|
|
97 |
redirect($PAGE->url);
|
|
|
98 |
}
|
|
|
99 |
|
|
|
100 |
// publish the form as a template
|
|
|
101 |
if (!empty($shareform)) {
|
|
|
102 |
require_capability('moodle/grade:sharegradingforms', context_system::instance());
|
|
|
103 |
$controller = $manager->get_controller($method);
|
|
|
104 |
$definition = $controller->get_definition();
|
|
|
105 |
if (!$confirmed) {
|
|
|
106 |
// let the user confirm they understand what they are doing (haha ;-)
|
|
|
107 |
echo $output->header();
|
|
|
108 |
echo $output->confirm(get_string('manageactionshareconfirm', 'core_grading', s($definition->name)),
|
|
|
109 |
new moodle_url($PAGE->url, array('shareform' => $shareform, 'confirmed' => 1)),
|
|
|
110 |
$PAGE->url);
|
|
|
111 |
echo $output->footer();
|
|
|
112 |
die();
|
|
|
113 |
} else {
|
|
|
114 |
require_sesskey();
|
|
|
115 |
$newareaid = $manager->create_shared_area($method);
|
|
|
116 |
$targetarea = get_grading_manager($newareaid);
|
|
|
117 |
$targetcontroller = $targetarea->get_controller($method);
|
|
|
118 |
$targetcontroller->update_definition($controller->get_definition_copy($targetcontroller));
|
|
|
119 |
$DB->set_field('grading_definitions', 'timecopied', time(), array('id' => $definition->id));
|
|
|
120 |
redirect(new moodle_url($PAGE->url, array('message' => get_string('manageactionsharedone', 'core_grading'))));
|
|
|
121 |
}
|
|
|
122 |
}
|
|
|
123 |
|
|
|
124 |
// delete the form definition
|
|
|
125 |
if (!empty($deleteform)) {
|
|
|
126 |
$controller = $manager->get_controller($method);
|
|
|
127 |
$definition = $controller->get_definition();
|
|
|
128 |
if (!$confirmed) {
|
|
|
129 |
// let the user confirm they understand the consequences (also known as WTF-effect)
|
|
|
130 |
echo $output->header();
|
|
|
131 |
echo $output->confirm(markdown_to_html(get_string('manageactiondeleteconfirm', 'core_grading', array(
|
|
|
132 |
'formname' => s($definition->name),
|
|
|
133 |
'component' => $manager->get_component_title(),
|
|
|
134 |
'area' => $manager->get_area_title()))),
|
|
|
135 |
new moodle_url($PAGE->url, array('deleteform' => $deleteform, 'confirmed' => 1)), $PAGE->url);
|
|
|
136 |
echo $output->footer();
|
|
|
137 |
die();
|
|
|
138 |
} else {
|
|
|
139 |
require_sesskey();
|
|
|
140 |
$controller->delete_definition();
|
|
|
141 |
redirect(new moodle_url($PAGE->url, array('message' => get_string('manageactiondeletedone', 'core_grading'))));
|
|
|
142 |
}
|
|
|
143 |
}
|
|
|
144 |
|
|
|
145 |
echo $output->header();
|
|
|
146 |
|
|
|
147 |
if (!empty($message)) {
|
|
|
148 |
echo $output->management_message($message);
|
|
|
149 |
}
|
|
|
150 |
|
|
|
151 |
if ($PAGE->has_secondary_navigation()) {
|
|
|
152 |
echo $output->heading(get_string('gradingmanagement', 'core_grading'));
|
|
|
153 |
} else {
|
|
|
154 |
echo $output->heading(get_string('gradingmanagementtitle', 'core_grading', array(
|
|
|
155 |
'component' => $manager->get_component_title(), 'area' => $manager->get_area_title())));
|
|
|
156 |
}
|
|
|
157 |
|
|
|
158 |
// display the active grading method information and selector
|
|
|
159 |
echo $output->management_method_selector($manager, $PAGE->url);
|
|
|
160 |
|
|
|
161 |
// get the currently active method's controller
|
|
|
162 |
if (!empty($method)) {
|
|
|
163 |
$controller = $manager->get_controller($method);
|
|
|
164 |
// display relevant actions
|
|
|
165 |
echo $output->container_start('actions');
|
|
|
166 |
if ($controller->is_form_defined()) {
|
|
|
167 |
$definition = $controller->get_definition();
|
|
|
168 |
// icon to edit the form definition
|
|
|
169 |
echo $output->management_action_icon($controller->get_editor_url($returnurl),
|
|
|
170 |
get_string('manageactionedit', 'core_grading'), 'b/document-edit');
|
|
|
171 |
// icon to delete the current form definition
|
|
|
172 |
echo $output->management_action_icon(new moodle_url($PAGE->url, array('deleteform' => $definition->id)),
|
|
|
173 |
get_string('manageactiondelete', 'core_grading'), 'b/edit-delete');
|
|
|
174 |
// icon to save the form as a new template
|
|
|
175 |
if (has_capability('moodle/grade:sharegradingforms', context_system::instance())) {
|
|
|
176 |
if (empty($definition->copiedfromid)) {
|
|
|
177 |
$hasoriginal = false;
|
|
|
178 |
} else {
|
|
|
179 |
$hasoriginal = $DB->record_exists('grading_definitions', array('id' => $definition->copiedfromid));
|
|
|
180 |
}
|
|
|
181 |
if (!$controller->is_form_available()) {
|
|
|
182 |
// drafts can not be shared
|
|
|
183 |
$allowshare = false;
|
|
|
184 |
} else if (!$hasoriginal) {
|
|
|
185 |
// was created from scratch or is orphaned
|
|
|
186 |
if (empty($definition->timecopied)) {
|
|
|
187 |
// was never shared before
|
|
|
188 |
$allowshare = true;
|
|
|
189 |
} else if ($definition->timemodified > $definition->timecopied) {
|
|
|
190 |
// was modified since last time shared
|
|
|
191 |
$allowshare = true;
|
|
|
192 |
} else {
|
|
|
193 |
// was not modified since last time shared
|
|
|
194 |
$allowshare = false;
|
|
|
195 |
}
|
|
|
196 |
} else {
|
|
|
197 |
// was created from a template and the template still exists
|
|
|
198 |
if ($definition->timecreated == $definition->timemodified) {
|
|
|
199 |
// was not modified since created
|
|
|
200 |
$allowshare = false;
|
|
|
201 |
} else if (empty($definition->timecopied)) {
|
|
|
202 |
// was modified but was not re-shared yet
|
|
|
203 |
$allowshare = true;
|
|
|
204 |
} else if ($definition->timemodified > $definition->timecopied) {
|
|
|
205 |
// was modified since last time re-shared
|
|
|
206 |
$allowshare = true;
|
|
|
207 |
} else {
|
|
|
208 |
// was not modified since last time re-shared
|
|
|
209 |
$allowshare = false;
|
|
|
210 |
}
|
|
|
211 |
}
|
|
|
212 |
if ($allowshare) {
|
|
|
213 |
echo $output->management_action_icon(new moodle_url($PAGE->url, array('shareform' => $definition->id)),
|
|
|
214 |
get_string('manageactionshare', 'core_grading'), 'b/bookmark-new');
|
|
|
215 |
}
|
|
|
216 |
}
|
|
|
217 |
} else {
|
|
|
218 |
echo $output->management_action_icon($controller->get_editor_url($returnurl),
|
|
|
219 |
get_string('manageactionnew', 'core_grading'), 'b/document-new');
|
|
|
220 |
$pickurl = new moodle_url('/grade/grading/pick.php', array('targetid' => $controller->get_areaid()));
|
|
|
221 |
if (!is_null($returnurl)) {
|
|
|
222 |
$pickurl->param('returnurl', $returnurl->out(false));
|
|
|
223 |
}
|
|
|
224 |
echo $output->management_action_icon($pickurl,
|
|
|
225 |
get_string('manageactionclone', 'core_grading'), 'b/edit-copy');
|
|
|
226 |
}
|
|
|
227 |
echo $output->container_end();
|
|
|
228 |
|
|
|
229 |
// display the message if the form is currently not available (if applicable)
|
|
|
230 |
if ($message = $controller->form_unavailable_notification()) {
|
|
|
231 |
echo $output->notification($message);
|
|
|
232 |
}
|
|
|
233 |
// display the grading form preview
|
|
|
234 |
if ($controller->is_form_defined()) {
|
|
|
235 |
if ($definition->status == gradingform_controller::DEFINITION_STATUS_READY) {
|
|
|
236 |
$tag = html_writer::tag('span', get_string('statusready', 'core_grading'), array('class' => 'status ready'));
|
|
|
237 |
} else {
|
|
|
238 |
$tag = html_writer::tag('span', get_string('statusdraft', 'core_grading'), array('class' => 'status draft'));
|
|
|
239 |
}
|
|
|
240 |
echo $output->heading(format_string($definition->name) . ' ' . $tag, 3, 'definition-name');
|
|
|
241 |
echo $output->box($controller->render_preview($PAGE), 'definition-preview');
|
|
|
242 |
}
|
|
|
243 |
}
|
|
|
244 |
|
|
|
245 |
|
|
|
246 |
echo $output->footer();
|