<?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->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');
> $mform->addRule('baseurl', null, 'required', null, 'client');
$mform->setType('action', PARAM_ALPHA);
> } else {
}
> $mform->addRule('clientid', null, 'required', null, 'client');
> $mform->addRule('clientsecret', null, 'required', null, 'client');
$mform->addElement('hidden', 'enabled', $issuer->get('enabled'));
> $mform->addElement('hidden', 'servicetype');
$mform->setType('enabled', PARAM_BOOL);
> $mform->setType('servicetype', PARAM_ALPHANUM);
>
< $mform->setType('type', PARAM_ALPHA);
> $mform->setType('type', PARAM_ALPHANUM);
$mform->setType('id', PARAM_INT);
$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) {
> $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;
> }
> }