Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.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/>.

/**
 * Form for scheduled tasks admin pages.
 *
 * @package    tool_task
 * @copyright  2013 Damyon Wiese <damyon@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

require_once($CFG->libdir.'/formslib.php');

/**
 * Edit scheduled task form.
 *
 * @copyright  2013 Damyon Wiese <damyon@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class tool_task_edit_scheduled_task_form extends moodleform {
    public function definition() {
        global $PAGE;

        $mform = $this->_form;
        /** @var \core\task\scheduled_task $task */
        $task = $this->_customdata;
        $defaulttask = \core\task\manager::get_default_scheduled_task(get_class($task), false);
        $renderer = $PAGE->get_renderer('tool_task');

        $mform->addElement('static', 'lastrun', get_string('lastruntime', 'tool_task'),
                $renderer->last_run_time($task));

        $mform->addElement('static', 'nextrun', get_string('nextruntime', 'tool_task'),
                $renderer->next_run_time($task));

        $mform->addGroup([
                $mform->createElement('text', 'minute'),
                $mform->createElement('static', 'minutedefault', '',
                        get_string('defaultx', 'tool_task', $defaulttask->get_minute())),
            ], 'minutegroup', get_string('taskscheduleminute', 'tool_task'), null, false);
        $mform->setType('minute', PARAM_RAW);
        $mform->addHelpButton('minutegroup', 'taskscheduleminute', 'tool_task');

        $mform->addGroup([
                $mform->createElement('text', 'hour'),
                $mform->createElement('static', 'hourdefault', '',
                        get_string('defaultx', 'tool_task', $defaulttask->get_hour())),
        ], 'hourgroup', get_string('taskschedulehour', 'tool_task'), null, false);
        $mform->setType('hour', PARAM_RAW);
        $mform->addHelpButton('hourgroup', 'taskschedulehour', 'tool_task');

        $mform->addGroup([
                $mform->createElement('text', 'day'),
                $mform->createElement('static', 'daydefault', '',
                        get_string('defaultx', 'tool_task', $defaulttask->get_day())),
        ], 'daygroup', get_string('taskscheduleday', 'tool_task'), null, false);
        $mform->setType('day', PARAM_RAW);
        $mform->addHelpButton('daygroup', 'taskscheduleday', 'tool_task');

        $mform->addGroup([
                $mform->createElement('text', 'month'),
                $mform->createElement('static', 'monthdefault', '',
                        get_string('defaultx', 'tool_task', $defaulttask->get_month())),
        ], 'monthgroup', get_string('taskschedulemonth', 'tool_task'), null, false);
        $mform->setType('month', PARAM_RAW);
        $mform->addHelpButton('monthgroup', 'taskschedulemonth', 'tool_task');

        $mform->addGroup([
                $mform->createElement('text', 'dayofweek'),
                $mform->createElement('static', 'dayofweekdefault', '',
                        get_string('defaultx', 'tool_task', $defaulttask->get_day_of_week())),
        ], 'dayofweekgroup', get_string('taskscheduledayofweek', 'tool_task'), null, false);
        $mform->setType('dayofweek', PARAM_RAW);
        $mform->addHelpButton('dayofweekgroup', 'taskscheduledayofweek', 'tool_task');

        $mform->addElement('advcheckbox', 'disabled', get_string('disabled', 'tool_task'));
        $mform->addHelpButton('disabled', 'disabled', 'tool_task');

        $mform->addElement('advcheckbox', 'resettodefaults', get_string('resettasktodefaults', 'tool_task'));
        $mform->addHelpButton('resettodefaults', 'resettasktodefaults', 'tool_task');

        $mform->disabledIf('minute', 'resettodefaults', 'checked');
        $mform->disabledIf('hour', 'resettodefaults', 'checked');
        $mform->disabledIf('day', 'resettodefaults', 'checked');
        $mform->disabledIf('dayofweek', 'resettodefaults', 'checked');
        $mform->disabledIf('month', 'resettodefaults', 'checked');
        $mform->disabledIf('disabled', 'resettodefaults', 'checked');

        $mform->addElement('hidden', 'task', get_class($task));
        $mform->setType('task', PARAM_RAW);
        $mform->addElement('hidden', 'action', 'edit');
        $mform->setType('action', PARAM_ALPHANUMEXT);
        $this->add_action_buttons(true, get_string('savechanges'));

        // Do not use defaults for existing values, the set_data() is the correct way.
        $this->set_data(\core\task\manager::record_from_scheduled_task($task));
    }

    /**
     * Custom validations.
     *
     * @param array $data
     * @param array $files
     *
     * @return array
     */
    public function validation($data, $files) {
        $error = parent::validation($data, $files);
< $fields = array('minute', 'hour', 'day', 'month', 'dayofweek'); < foreach ($fields as $field) { < if (!self::validate_fields($field, $data[$field])) { < $error[$field . 'group'] = get_string('invaliddata', 'core_error');
> // Use a checker class. > $checker = new \tool_task\scheduled_checker_task(); > $checker->set_minute($data['minute']); > $checker->set_hour($data['hour']); > $checker->set_month($data['month']); > $checker->set_day_of_week($data['dayofweek']); > $checker->set_day($data['day']); > $checker->set_disabled(false); > $checker->set_customised(false); > > if (!$checker->is_valid($checker::FIELD_MINUTE)) { > $error['minutegroup'] = get_string('invaliddata', 'core_error');
}
> if (!$checker->is_valid($checker::FIELD_HOUR)) { } > $error['hourgroup'] = get_string('invaliddata', 'core_error');
< return $error;
> if (!$checker->is_valid($checker::FIELD_DAY)) { > $error['daygroup'] = get_string('invaliddata', 'core_error');
}
< < /** < * Helper function that validates the submitted data. < * < * Explanation of the regex:- < * < * \A\*\z - matches * < * \A[0-5]?[0-9]\z - matches entries like 23 < * \A\*\/[0-5]?[0-9]\z - matches entries like * / 5 < * \A[0-5]?[0-9](,[0-5]?[0-9])*\z - matches entries like 1,2,3 < * \A[0-5]?[0-9]-[0-5]?[0-9]\z - matches entries like 2-10 < * < * @param string $field field to validate < * @param string $value value < * < * @return bool true if validation passes, false other wise. < */ < public static function validate_fields($field, $value) { < switch ($field) { < case 'minute' : < case 'hour' : < $regex = "/\A\*\z|\A[0-5]?[0-9]\z|\A\*\/[0-5]?[0-9]\z|\A[0-5]?[0-9](,[0-5]?[0-9])*\z|\A[0-5]?[0-9]-[0-5]?[0-9]\z/"; < break; < case 'day': < $regex = "/\A\*\z|\A([1-2]?[0-9]|3[0-1])\z|\A\*\/([1-2]?[0-9]|3[0-1])\z|"; < $regex .= "\A([1-2]?[0-9]|3[0-1])(,([1-2]?[0-9]|3[0-1]))*\z|\A([1-2]?[0-9]|3[0-1])-([1-2]?[0-9]|3[0-1])\z/"; < break; < case 'month': < $regex = "/\A\*\z|\A([0-9]|1[0-2])\z|\A\*\/([0-9]|1[0-2])\z|\A([0-9]|1[0-2])(,([0-9]|1[0-2]))*\z|"; < $regex .= "\A([0-9]|1[0-2])-([0-9]|1[0-2])\z/"; < break; < case 'dayofweek': < $regex = "/\A\*\z|\A[0-6]\z|\A\*\/[0-6]\z|\A[0-6](,[0-6])*\z|\A[0-6]-[0-6]\z/"; < break; < default: < return false;
> if (!$checker->is_valid($checker::FIELD_MONTH)) { > $error['monthgroup'] = get_string('invaliddata', 'core_error');
}
< return (bool)preg_match($regex, $value);
> if (!$checker->is_valid($checker::FIELD_DAYOFWEEK)) { > $error['dayofweekgroup'] = get_string('invaliddata', 'core_error'); > } > > return $error;
} }