Merge branch 'MDL-58177-master' of https://github.com/sammarshallou/moodle
[moodle.git] / admin / tool / task / schedule_task.php
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/>.
17 /**
18  * Web cron single task
19  *
20  * This script runs a single scheduled task from the web UI.
21  *
22  * @package tool_task
23  * @copyright 2016 The Open University
24  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25  */
27 define('NO_OUTPUT_BUFFERING', true);
29 require('../../../config.php');
31 require_once($CFG->libdir.'/cronlib.php');
33 /**
34  * Function used to handle mtrace by outputting the text to normal browser window.
35  *
36  * @param string $message Message to output
37  * @param string $eol End of line character
38  */
39 function tool_task_mtrace_wrapper($message, $eol) {
40     echo s($message . $eol);
41 }
43 // Allow execution of single task. This requires login and has different rules.
44 $taskname = required_param('task', PARAM_RAW_TRIMMED);
46 // Basic security checks.
47 require_login();
48 $context = context_system::instance();
49 require_capability('moodle/site:config', $context);
51 if (!get_config('tool_task', 'enablerunnow')) {
52     print_error('nopermissions', 'error', '', get_string('runnow', 'tool_task'));
53 }
55 // Check input parameter against all existing tasks (this ensures it isn't possible to
56 // create some kind of security problem by specifying a class that isn't a task or whatever).
57 $task = \core\task\manager::get_scheduled_task($taskname);
58 if (!$task) {
59     print_error('cannotfindinfo', 'error', $taskname);
60 }
62 // Start output.
63 $PAGE->set_url(new moodle_url('/admin/tool/task/schedule_task.php'));
64 $PAGE->set_context($context);
65 $PAGE->navbar->add(get_string('scheduledtasks', 'tool_task'), new moodle_url('/admin/tool/task/scheduledtasks.php'));
66 $PAGE->navbar->add(s($task->get_name()));
67 echo $OUTPUT->header();
68 echo $OUTPUT->heading($task->get_name());
70 // The initial request just shows the confirmation page; we don't do anything further unless
71 // they confirm.
72 if (!optional_param('confirm', 0, PARAM_INT)) {
73     echo $OUTPUT->confirm(get_string('runnow_confirm', 'tool_task', $task->get_name()),
74             new single_button(new moodle_url('/admin/tool/task/schedule_task.php',
75             array('task' => $taskname, 'confirm' => 1, 'sesskey' => sesskey())),
76             get_string('runnow', 'tool_task')),
77             new single_button(new moodle_url('/admin/tool/task/scheduledtasks.php'),
78             get_string('cancel'), false));
79     echo $OUTPUT->footer();
80     exit;
81 }
83 // Action requires session key.
84 require_sesskey();
86 // Prepare to handle output via mtrace.
87 echo html_writer::start_tag('pre');
88 $CFG->mtrace_wrapper = 'tool_task_mtrace_wrapper';
90 // Run the specified task (this will output an error if it doesn't exist).
91 cron_run_single_task($task);
92 echo html_writer::end_tag('pre');
94 $output = $PAGE->get_renderer('tool_task');
95 echo $output->link_back();
97 echo $OUTPUT->footer();