Proyectos de Subversion Moodle

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

namespace tool_mfa\local\form;

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

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

/**

 * MFA login form

 *

 * @package     tool_mfa

 * @author      Mikhail Golenkov <golenkovm@gmail.com>

 * @copyright   Catalyst IT

 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

class login_form extends \moodleform {

    /** @var \tool_mfa\local\form\global_form_manager */

    public $globalmanager;

    /**

     * Create an instance of this class.

     *

     * @param mixed $action the action attribute for the form. If empty defaults to auto detect the

     *              current url. If a moodle_url object then outputs params as hidden variables.

     * @param mixed $customdata if your form defintion method needs access to data such as $course

     *              $cm, etc. to construct the form definition then pass it in this array. You can

     *              use globals for somethings.

     * @param string $method if you set this to anything other than 'post' then _GET and _POST will

     *               be merged and used as incoming data to the form.

     * @param string $target target frame for form submission. You will rarely use this. Don't use

     *               it if you don't need to as the target attribute is deprecated in xhtml strict.

     * @param mixed $attributes you can pass a string of html attributes here or an array.

     *               Special attribute 'data-random-ids' will randomise generated elements ids. This

     *               is necessary when there are several forms on the same page.

     *               Special attribute 'data-double-submit-protection' set to 'off' will turn off

     *               double-submit protection JavaScript - this may be necessary if your form sends

     *               downloadable files in response to a submit button, and can't call

     *               \core_form\util::form_download_complete();

     * @param bool $editable

     * @param array $ajaxformdata Forms submitted via ajax, must pass their data here, instead of relying on _GET and _POST.

     */

    public function __construct($action = null, $customdata = null, $method = 'post', $target = '',

            $attributes = null, $editable = true, $ajaxformdata = null) {

        $this->globalmanager = new \tool_mfa\local\form\global_form_manager();

        parent::__construct($action, $customdata, $method, $target, $attributes, $editable, $ajaxformdata);

    }

    /**

     * {@inheritDoc}

     * @see moodleform::definition()

     */

    public function definition(): void {

        $mform = $this->_form;

        $factor = $this->_customdata['factor'];

        $mform = $factor->login_form_definition($mform);

        // Add a hidden field with the factor name so it is always available.

        $factorname = $mform->addElement('hidden', 'factor', $factor->name);

        $factorname->setType(PARAM_ALPHAEXT);

        $this->globalmanager->definition($mform);

    }

    /**

     * Invokes factor login_form_definition_after_data() method after form data has been set.

     *

     * @return void

     */

    public function definition_after_data(): void {

        $mform = $this->_form;

        $factor = $this->_customdata['factor'];

        $factor->login_form_definition_after_data($mform);

        $this->globalmanager->definition_after_data($mform);

        $buttonarray = [];

        $buttonarray[] = &$mform->createElement('submit', 'submitbutton', get_string('loginsubmit', 'factor_' . $factor->name));

        $mform->addGroup($buttonarray, 'buttonar', '', [' '], false);

        $mform->closeHeaderBefore('buttonar');

    }

    /**

     * Validates the login form with given factor validation method.

     *

     * @param array $data

     * @param array $files

     * @return array

     */

    public function validation($data, $files) {

        $errors = parent::validation($data, $files);

        $factor = $this->_customdata['factor'];

        $errors += $factor->login_form_validation($data);

        $errors += $this->globalmanager->validation($data, $files);

        // Execute sleep time bruteforce mitigation.

        \tool_mfa\manager::sleep_timer();

        return $errors;

    }

    /**

     * Returns error corresponding to validated element.

     *

     * @param string $elementname Name of form element to check.

     * @return string|null Error message corresponding to the validated element.

     */

    public function get_element_error(string $elementname): ?string {

        return $this->_form->getElementError($elementname);

    }

    /**

     * Set an error message for a form element.

     *

     * @param string $elementname Name of form element to set error for.

     * @param string $error Error message, if empty then removes the current error message.

     * @return void

     */

    public function set_element_error(string $elementname, string $error): void {

        $this->_form->setElementError($elementname, $error);

    }

    /**

     * Freeze a form element.

     *

     * @param string $elementname Name of form element to freeze.

     * @return void

     */

    public function freeze(string $elementname): void {

        $this->_form->freeze($elementname);

    }

    /**

     * Returns true if the form element exists.

     *

     * @param string $elementname Name of form element to check.

     * @return bool

     */

    public function element_exists(string $elementname): bool {

        return $this->_form->elementExists($elementname);

    }

}