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/>.

/**
 * Cohort related management functions, this file needs to be included manually.
 *
 * @package    core_cohort
 * @copyright  2010 Petr Skoda  {@link http://skodak.org}
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

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

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

class cohort_edit_form extends moodleform {

    /**
     * Define the cohort edit form
     */
    public function definition() {
        global $CFG;

        $mform = $this->_form;
        $editoroptions = $this->_customdata['editoroptions'];
        $cohort = $this->_customdata['data'];

        $mform->addElement('text', 'name', get_string('name', 'cohort'), 'maxlength="254" size="50"');
        $mform->addRule('name', get_string('required'), 'required', null, 'client');
        $mform->setType('name', PARAM_TEXT);

        $options = $this->get_category_options($cohort->contextid);
        $mform->addElement('autocomplete', 'contextid', get_string('context', 'role'), $options);
        $mform->addRule('contextid', null, 'required', null, 'client');

        $mform->addElement('text', 'idnumber', get_string('idnumber', 'cohort'), 'maxlength="254" size="50"');
        $mform->setType('idnumber', PARAM_RAW); // Idnumbers are plain text, must not be changed.

        $mform->addElement('advcheckbox', 'visible', get_string('visible', 'cohort'));
        $mform->setDefault('visible', 1);
        $mform->addHelpButton('visible', 'visible', 'cohort');

        $mform->addElement('editor', 'description_editor', get_string('description', 'cohort'), null, $editoroptions);
        $mform->setType('description_editor', PARAM_RAW);

        if (!empty($CFG->allowcohortthemes)) {
            $themes = array_merge(array('' => get_string('forceno')), cohort_get_list_of_themes());
            $mform->addElement('select', 'theme', get_string('forcetheme'), $themes);
        }

        $mform->addElement('hidden', 'id');
        $mform->setType('id', PARAM_INT);

        if (isset($this->_customdata['returnurl'])) {
            $mform->addElement('hidden', 'returnurl', $this->_customdata['returnurl']->out_as_local_url());
            $mform->setType('returnurl', PARAM_LOCALURL);
        }

> $handler = core_cohort\customfield\cohort_handler::create(); $this->add_action_buttons(); > $handler->instance_form_definition($mform, empty($cohort->id) ? 0 : $cohort->id); >
$this->set_data($cohort);
> $handler->instance_form_before_set_data($cohort);
} public function validation($data, $files) { global $DB; $errors = parent::validation($data, $files); $idnumber = trim($data['idnumber']); if ($idnumber === '') { // Fine, empty is ok. } else if ($data['id']) { $current = $DB->get_record('cohort', array('id'=>$data['id']), '*', MUST_EXIST); if ($current->idnumber !== $idnumber) { if ($DB->record_exists('cohort', array('idnumber'=>$idnumber))) { $errors['idnumber'] = get_string('duplicateidnumber', 'cohort'); } } } else { if ($DB->record_exists('cohort', array('idnumber'=>$idnumber))) { $errors['idnumber'] = get_string('duplicateidnumber', 'cohort'); } }
> $handler = core_cohort\customfield\cohort_handler::create(); return $errors; > $errors = array_merge($errors, $handler->instance_form_validation($data, $files)); } >
protected function get_category_options($currentcontextid) { $displaylist = core_course_category::make_categories_list('moodle/cohort:manage'); $options = array(); $syscontext = context_system::instance(); if (has_capability('moodle/cohort:manage', $syscontext)) { $options[$syscontext->id] = $syscontext->get_context_name(); } foreach ($displaylist as $cid=>$name) { $context = context_coursecat::instance($cid); $options[$context->id] = $name; } // Always add current - this is not likely, but if the logic gets changed it might be a problem. if (!isset($options[$currentcontextid])) { $context = context::instance_by_id($currentcontextid, MUST_EXIST); $options[$context->id] = $syscontext->get_context_name(); } return $options;
> } } > } > /** > * Apply a logic after data is set. > */ > public function definition_after_data() { > $cohortid = $this->_form->getElementValue('id'); > $handler = core_cohort\customfield\cohort_handler::create(); > $handler->instance_form_definition_after_data($this->_form, empty($cohortid) ? 0 : $cohortid);