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

/**
 * This is the main endpoint which MoodleNet instances POST to.
 *
 * MoodleNet instances send the user agent to this endpoint via a form POST.
 * Then:
 * 1. The POSTed resource information is put in a session store for cross-request access.
 * 2. This page makes a GET request for admin/tool/moodlenet/index.php (the import confirmation page).
 * 3. Then, depending on whether the user is authenticated, the user will either:
 * - If not authenticated, they will be asked to login, after which they will see the confirmation page (leveraging $wantsurl).
 * - If authenticated, they will see the confirmation page immediately.
 *
 * @package     tool_moodlenet
 * @copyright   2020 Jake Dallimore <jrhdallimore@gmail.com>
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

use tool_moodlenet\local\import_info;
use tool_moodlenet\local\remote_resource;
use tool_moodlenet\local\url;

require_once(__DIR__ . '/../../../config.php');

// The integration must be enabled for this import endpoint to be active.
if (!get_config('tool_moodlenet', 'enablemoodlenet')) {
< print_error('moodlenetnotenabled', 'tool_moodlenet');
> throw new \moodle_exception('moodlenetnotenabled', 'tool_moodlenet');
} $resourceurl = required_param('resourceurl', PARAM_URL); $resourceinfo = required_param('resource_info', PARAM_RAW); $resourceinfo = json_decode($resourceinfo); $type = optional_param('type', 'link', PARAM_TEXT); $course = optional_param('course', 0, PARAM_INT); $section = optional_param('section', 0, PARAM_INT); // If course isn't provided, course and section are null. if (empty($course)) { $course = null; $section = null; } $name = validate_param($resourceinfo->name, PARAM_TEXT); $description = validate_param($resourceinfo->summary, PARAM_TEXT); // Only accept POSTs. if (!empty($_POST)) { // Store information about the import of the resource for the current user. $importconfig = (object) [ 'course' => $course, 'section' => $section, 'type' => $type, ]; $metadata = (object) [ 'name' => $name, 'description' => $description ?? '' ]; require_once($CFG->libdir . '/filelib.php'); $importinfo = new import_info( $USER->id, new remote_resource(new \curl(), new url($resourceurl), $metadata), $importconfig ); $importinfo->save(); // Redirect to the import confirmation page, detouring via the log in page if required. redirect(new moodle_url('/admin/tool/moodlenet/index.php', ['id' => $importinfo->get_id()])); } // Invalid or missing POST data. Show an error to the user.
< print_error('missinginvalidpostdata', 'tool_moodlenet');
> throw new \moodle_exception('missinginvalidpostdata', 'tool_moodlenet');