See Release Notes
Long Term Support Release
<?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/>. /** * This file contains the form add/update oauth2 issuer. * * @package tool_oauth2 * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace tool_oauth2\form; defined('MOODLE_INTERNAL') || die(); use stdClass; use core\form\persistent; /** * Issuer form. * * @package tool_oauth2 * @copyright 2017 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class issuer extends persistent { /** @var string $persistentclass */ protected static $persistentclass = 'core\\oauth2\\issuer'; /** @var array $fieldstoremove */ protected static $fieldstoremove = array('type', 'submitbutton', 'action'); /** @var string $type */ protected $type;< /** @var boolean $showrequireconfirm Whether to show the require confirmation email checkbox or not. */ < protected $showrequireconfirm; </** * Constructor. * * The 'persistent' has to be passed as custom data when 'editing'. * If a standard issuer is created the type can be passed as custom data, which alters the form according to the * type. * * Note that in order for your persistent to be reloaded after form submission you should * either override the URL to include the ID to your resource, or add the ID to the form * fields. * * @param mixed $action * @param mixed $customdata * @param string $method * @param string $target * @param mixed $attributes * @param bool $editable * @param array $ajaxformdata */ public function __construct($action = null, $customdata = null, $method = 'post', $target = '', $attributes = null, $editable = true, array $ajaxformdata = null) { // The type variable defines, if we are in the creation process of a standard issuer. if (array_key_exists('type', $customdata)) { $this->type = $customdata['type']; }< $this->showrequireconfirm = !empty($customdata['showrequireconfirm']);parent::__construct($action, $customdata, $method, $target, $attributes, $editable, $ajaxformdata); } /** * Define the form - called by parent constructor */ public function definition() { global $PAGE, $OUTPUT; $mform = $this->_form; $issuer = $this->get_persistent(); $docslink = optional_param('docslink', '', PARAM_ALPHAEXT); if ($docslink) { $name = s($issuer->get('name')); $mform->addElement('html', $OUTPUT->doc_link($docslink, get_string('issuersetuptype', 'tool_oauth2', $name))); } else { $mform->addElement('html', $OUTPUT->page_doc_link(get_string('issuersetup', 'tool_oauth2'))); } // Name. $mform->addElement('text', 'name', get_string('issuername', 'tool_oauth2')); $mform->addRule('name', null, 'required', null, 'client'); $mform->addRule('name', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); $mform->addHelpButton('name', 'issuername', 'tool_oauth2'); // Client ID. $mform->addElement('text', 'clientid', get_string('issuerclientid', 'tool_oauth2'));< $mform->addRule('clientid', null, 'required', null, 'client');$mform->addRule('clientid', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); $mform->addHelpButton('clientid', 'issuerclientid', 'tool_oauth2'); // Client Secret. $mform->addElement('text', 'clientsecret', get_string('issuerclientsecret', 'tool_oauth2'));< $mform->addRule('clientsecret', null, 'required', null, 'client');$mform->addRule('clientsecret', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); $mform->addHelpButton('clientsecret', 'issuerclientsecret', 'tool_oauth2'); // Use basic authentication.< $mform->addElement('checkbox', 'basicauth', get_string('usebasicauth', 'tool_oauth2'));> $mform->addElement('advcheckbox', 'basicauth', get_string('usebasicauth', 'tool_oauth2'));$mform->addHelpButton('basicauth', 'usebasicauth', 'tool_oauth2');> // Base Url. // Login scopes. > $mform->addElement('text', 'baseurl', get_string('issuerbaseurl', 'tool_oauth2')); $mform->addElement('text', 'loginscopes', get_string('issuerloginscopes', 'tool_oauth2')); > $mform->addRule('baseurl', get_string('maximumchars', '', 1024), 'maxlength', 1024, 'client'); $mform->addRule('loginscopes', null, 'required', null, 'client'); > $mform->addHelpButton('baseurl', 'issuerbaseurl', 'tool_oauth2'); $mform->addRule('loginscopes', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); > if ($this->type && $this->type == 'nextcloud') { $mform->addHelpButton('loginscopes', 'issuerloginscopes', 'tool_oauth2'); > $mform->addRule('baseurl', null, 'required', null, 'client'); > } // Login scopes offline. > $mform->addElement('text', 'loginscopesoffline', get_string('issuerloginscopesoffline', 'tool_oauth2')); > // Image. $mform->addRule('loginscopesoffline', null, 'required', null, 'client'); > $mform->addElement('text', 'image', get_string('issuerimage', 'tool_oauth2'), 'maxlength="1024"'); $mform->addRule('loginscopesoffline', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); > $mform->addRule('image', get_string('maximumchars', '', 1024), 'maxlength', 1024, 'client'); $mform->addHelpButton('loginscopesoffline', 'issuerloginscopesoffline', 'tool_oauth2'); > $mform->addHelpButton('image', 'issuername', 'tool_oauth2'); > // Login params. > // Show on login page. $mform->addElement('text', 'loginparams', get_string('issuerloginparams', 'tool_oauth2')); > $options = [ $mform->addRule('loginparams', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); > \core\oauth2\issuer::EVERYWHERE => get_string('issueruseineverywhere', 'tool_oauth2'), $mform->addHelpButton('loginparams', 'issuerloginparams', 'tool_oauth2'); > \core\oauth2\issuer::LOGINONLY => get_string('issueruseinloginonly', 'tool_oauth2'), > \core\oauth2\issuer::SERVICEONLY => get_string('issueruseininternalonly', 'tool_oauth2'), // Login params offline. > ]; $mform->addElement('text', 'loginparamsoffline', get_string('issuerloginparamsoffline', 'tool_oauth2')); > $mform->addElement('select', 'showonloginpage', get_string('issuerusein', 'tool_oauth2'), $options); $mform->addRule('loginparamsoffline', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); > $mform->addHelpButton('showonloginpage', 'issuerusein', 'tool_oauth2'); $mform->addHelpButton('loginparamsoffline', 'issuerloginparamsoffline', 'tool_oauth2'); > > // Name on login page. // Base Url. > $mform->addElement('text', 'loginpagename', get_string('issuerloginpagename', 'tool_oauth2')); $mform->addElement('text', 'baseurl', get_string('issuerbaseurl', 'tool_oauth2')); > $mform->addRule('loginpagename', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); $mform->addRule('baseurl', get_string('maximumchars', '', 1024), 'maxlength', 1024, 'client'); > $mform->addHelpButton('loginpagename', 'issuerloginpagename', 'tool_oauth2'); $mform->addHelpButton('baseurl', 'issuerbaseurl', 'tool_oauth2'); > $mform->hideIf('loginpagename', 'showonloginpage', 'eq', \core\oauth2\issuer::SERVICEONLY); if ($this->type && $this->type == 'nextcloud') { >< $mform->addRule('loginscopes', null, 'required', null, 'client');< $mform->addRule('loginscopesoffline', null, 'required', null, 'client');< // Base Url. < $mform->addElement('text', 'baseurl', get_string('issuerbaseurl', 'tool_oauth2')); < $mform->addRule('baseurl', get_string('maximumchars', '', 1024), 'maxlength', 1024, 'client'); < $mform->addHelpButton('baseurl', 'issuerbaseurl', 'tool_oauth2'); < if ($this->type && $this->type == 'nextcloud') { < $mform->addRule('baseurl', null, 'required', null, 'client'); < } <$mform->addRule('image', get_string('maximumchars', '', 1024), 'maxlength', 1024, 'client');> $mform->hideIf('alloweddomains', 'showonloginpage', 'eq', \core\oauth2\issuer::SERVICEONLY);< // Image. < $mform->addElement('text', 'image', get_string('issuerimage', 'tool_oauth2'), 'maxlength="1024"'); < $mform->addRule('image', get_string('maximumchars', '', 1024), 'maxlength', 1024, 'client'); < $mform->addHelpButton('image', 'issuername', 'tool_oauth2'); < < // Show on login page. < $mform->addElement('checkbox', 'showonloginpage', get_string('issuershowonloginpage', 'tool_oauth2')); < $mform->addHelpButton('showonloginpage', 'issuershowonloginpage', 'tool_oauth2'); < < if ($this->showrequireconfirm) {< $mform->addElement('advcheckbox', 'requireconfirmation', get_string('issuerrequireconfirmation', 'tool_oauth2'));> $mform->addElement('advcheckbox', 'requireconfirmation', > get_string('issuerrequireconfirmation', 'tool_oauth2'));> $mform->hideIf('requireconfirmation', 'showonloginpage', $mform->addElement('hidden', 'sortorder'); > 'eq', \core\oauth2\issuer::SERVICEONLY); $mform->setType('sortorder', PARAM_INT); > > $mform->addElement('checkbox', 'acceptrisk', get_string('acceptrisk', 'tool_oauth2')); if ($this->type) { > $mform->addHelpButton('acceptrisk', 'acceptrisk', 'tool_oauth2'); $mform->addElement('hidden', 'action', 'savetemplate'); > $mform->hideIf('acceptrisk', 'showonloginpage', $mform->setType('action', PARAM_ALPHA); > 'eq', \core\oauth2\issuer::SERVICEONLY); > $mform->hideIf('acceptrisk', 'requireconfirmation', 'checked'); $mform->addElement('hidden', 'type', $this->_customdata['type']); > $mform->setType('type', PARAM_ALPHA); > } else { > if ($this->type == 'imsobv2p1' || $issuer->get('servicetype') == 'imsobv2p1' $mform->addElement('hidden', 'action', 'edit'); > || $this->type == 'moodlenet' || $issuer->get('servicetype') == 'moodlenet') { $mform->setType('action', PARAM_ALPHA); > $mform->addRule('baseurl', null, 'required', null, 'client'); } > } else { > $mform->addRule('clientid', null, 'required', null, 'client'); $mform->addElement('hidden', 'enabled', $issuer->get('enabled')); > $mform->addRule('clientsecret', null, 'required', null, 'client');$mform->setType('enabled', PARAM_BOOL);> $mform->addElement('hidden', 'servicetype'); > $mform->setType('servicetype', PARAM_ALPHANUM); $mform->addElement('hidden', 'id', $issuer->get('id')); >< $mform->setType('type', PARAM_ALPHA);> $mform->setType('type', PARAM_ALPHANUM);$this->add_action_buttons(true, get_string('savechanges', 'tool_oauth2')); }> /** } > * This method implements changes to the form that need to be made once the form data is set. > */ > public function definition_after_data() { > $mform = $this->_form; > > if ($this->type) { > // Set servicetype if it's defined. > $mform->getElement('servicetype')->setValue($this->type); > }> /** > * Define extra validation mechanims. > * > * The data here: > * - does not include {@see self::$fieldstoremove}. > * - does include {@see self::$foreignfields}. > * - was converted to map persistent-like data, e.g. array $description to string $description + int $descriptionformat. > * > * You can modify the $errors parameter in order to remove some validation errors should you > * need to. However, the best practice is to return new or overriden errors. Only modify the > * errors passed by reference when you have no other option. > * > * Do not add any logic here, it is only intended to be used by child classes. > * > * @param stdClass $data Data to validate. > * @param array $files Array of files. > * @param array $errors Currently reported errors. > * @return array of additional errors, or overridden errors. > */ > protected function extra_validation($data, $files, array &$errors) { > if ($data->showonloginpage != \core\oauth2\issuer::SERVICEONLY) { > if (!strlen(trim($data->loginscopes))) { > $errors['loginscopes'] = get_string('required'); > } > if (!strlen(trim($data->loginscopesoffline))) { > $errors['loginscopesoffline'] = get_string('required'); > } > if (empty($data->requireconfirmation) && empty($data->acceptrisk)) { > $errors['acceptrisk'] = get_string('required'); > } > } > return $errors; > } > }