AutorÃa | Ultima modificación | Ver Log |
<?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/>.
declare(strict_types=1);
namespace enrol_guest\form;
use core\context\course as context_course;
use core_form\dynamic_form;
use core_text;
use moodle_url;
/**
* Form for entering password for guest enrolment
*
* @package enrol_guest
* @copyright Marina Glancy
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class enrol_form extends dynamic_form {
/** @var \stdClass */
protected $instance;
/**
* Returns the instance of the enrolment method
*
* @throws \moodle_exception
* @return \stdClass
*/
protected function get_instance(): \stdClass {
global $DB, $CFG;
require_once($CFG->dirroot . '/lib/enrollib.php');
if ($this->instance === null) {
$courseid = $this->optional_param('id', 0, PARAM_INT);
$instanceid = $this->optional_param('instance', 0, PARAM_INT);
// We need enrol_get_instances() to validate that the enrolment method is enabled.
$instances = enrol_get_instances($courseid, true);
if (empty($instances[$instanceid]) || $instances[$instanceid]->enrol !== 'guest') {
throw new \moodle_exception('invalidenrolinstance', 'enrol');
}
$this->instance = $instances[$instanceid] ?? null;
}
return $this->instance;
}
#[\Override]
public function definition() {
$mform = $this->_form;
$mform->addElement('password', 'guestpassword', get_string('password', 'enrol_guest'));
$mform->addElement('hidden', 'id');
$mform->setType('id', PARAM_INT);
$mform->addElement('hidden', 'instance');
$mform->setType('instance', PARAM_INT);
}
#[\Override]
public function validation($data, $files) {
global $DB, $CFG;
$errors = parent::validation($data, $files);
$instance = $this->get_instance();
if ($instance->password !== '') {
if ($data['guestpassword'] !== $instance->password) {
$plugin = enrol_get_plugin('guest');
if ($plugin->get_config('showhint')) {
$hint = core_text::substr($instance->password, 0, 1);
$errors['guestpassword'] = get_string('passwordinvalidhint', 'enrol_guest', $hint);
} else {
$errors['guestpassword'] = get_string('passwordinvalid', 'enrol_guest');
}
}
}
return $errors;
}
#[\Override]
protected function check_access_for_dynamic_submission(): void {
global $USER, $CFG;
$courseid = $this->get_instance()->courseid;
$course = get_course($courseid);
$context = context_course::instance($this->get_instance()->courseid);
if (!\core_course_category::can_view_course_info($course) && !is_enrolled($context, $USER, '', true)) {
throw new \moodle_exception('coursehidden', '', $CFG->wwwroot . '/');
}
}
#[\Override]
protected function get_context_for_dynamic_submission(): \context {
// This form is used for users who are not yet enrolled in the course and do not have access to the course.
// For the purpose of permission checks they must be able to access the course category for this course.
return context_course::instance($this->get_instance()->courseid)->get_parent_context();
}
#[\Override]
protected function get_page_url_for_dynamic_submission(): moodle_url {
$instance = $this->get_instance();
return new moodle_url('/enrol/index.php', ['id' => $instance->courseid, 'instance' => $instance->id]);
}
/**
* Process the form submission, used if form was submitted via AJAX
*
* Enrols the user in the course and returns the URL to redirect to
*
* @return string
*/
public function process_dynamic_submission() {
global $USER, $CFG, $SESSION;
/** @var \enrol_guest_plugin $enrol */
$enrol = enrol_get_plugin('guest');
$instance = $this->get_instance();
$enrol->mark_user_as_enrolled($instance, $this->get_data()->guestpassword);
// Go to the originally requested page.
if (!empty($SESSION->wantsurl)) {
$destination = $SESSION->wantsurl;
unset($SESSION->wantsurl);
} else {
require_once($CFG->dirroot . '/course/lib.php');
$destination = course_get_url($instance->courseid);
}
return $destination;
}
#[\Override]
public function set_data_for_dynamic_submission(): void {
$instance = $this->get_instance();
$this->set_data(['id' => $instance->courseid, 'instance' => $instance->id]);
}
}