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

/**
 * Preset Menu
 *
 * This is the page that is the menu item in the config database
 * pages.
 *
 * This file is part of the Database module for Moodle
 *
 * @copyright 2005 Martin Dougiamas  http://dougiamas.com
 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 * @package mod_data
 */

> use mod_data\local\importer\preset_importer; require_once('../../config.php'); > use mod_data\local\importer\preset_upload_importer; require_once($CFG->dirroot.'/mod/data/lib.php'); > use mod_data\manager; require_once($CFG->dirroot.'/mod/data/preset_form.php'); > use mod_data\preset; > use mod_data\output\action_bar; $id = optional_param('id', 0, PARAM_INT); // The course module id. > use mod_data\output\preset_preview; >
< $id = optional_param('id', 0, PARAM_INT); // The course module id.
> // The course module id. > $id = optional_param('id', 0, PARAM_INT);
$cm = get_coursemodule_from_id('data', $id, null, null, MUST_EXIST);
> $manager = null;
< $cm = get_coursemodule_from_id('data', $id, null, null, MUST_EXIST); < $course = $DB->get_record('course', array('id' => $cm->course), '*', MUST_EXIST); < $data = $DB->get_record('data', array('id' => $cm->instance), '*', MUST_EXIST);
> list($course, $cm) = get_course_and_cm_from_cmid($id, manager::MODULE); > $manager = manager::create_from_coursemodule($cm); > $data = $manager->get_instance();
< $d = required_param('d', PARAM_INT); // database activity id < $data = $DB->get_record('data', array('id' => $d), '*', MUST_EXIST); < $course = $DB->get_record('course', array('id' => $data->course), '*', MUST_EXIST); < $cm = get_coursemodule_from_instance('data', $data->id, $course->id, null, MUST_EXIST);
> // We must have the database activity id. > $d = required_param('d', PARAM_INT); > $data = $DB->get_record('data', ['id' => $d], '*', MUST_EXIST); > $manager = manager::create_from_instance($data); > $cm = $manager->get_coursemodule(); > $course = get_course($cm->course);
} $action = optional_param('action', 'view', PARAM_ALPHA); // The page action.
< $allowedactions = ['view', 'delete', 'confirmdelete', 'import', 'importzip', 'finishimport', < 'export'];
> $allowedactions = ['view', 'importzip', 'finishimport', > 'export', 'preview'];
if (!in_array($action, $allowedactions)) { throw new moodle_exception('invalidaccess'); }
< $context = context_module::instance($cm->id, MUST_EXIST);
> $context = $manager->get_context(); >
require_login($course, false, $cm); require_capability('mod/data:managetemplates', $context); $url = new moodle_url('/mod/data/preset.php', array('d' => $data->id));
> $PAGE->add_body_class('mediumwidth');
$PAGE->set_url($url);
< $PAGE->set_title(get_string('course') . ': ' . $course->fullname);
> $titleparts = [ > get_string('presets', 'data'), > format_string($cm->name), > format_string($course->fullname), > ]; > $PAGE->set_title(implode(moodle_page::TITLE_SEPARATOR, $titleparts));
$PAGE->set_heading($course->fullname); $PAGE->force_settings_menu(true); $PAGE->activityheader->disable();
> $PAGE->requires->js_call_amd('mod_data/deletepreset', 'init');
// fill in missing properties needed for updating of instance $data->course = $cm->course; $data->cmidnumber = $cm->idnumber; $data->instance = $cm->instance;
< $renderer = $PAGE->get_renderer('mod_data'); < $presets = data_get_available_presets($context);
> $renderer = $manager->get_renderer(); > $presets = $manager->get_available_presets();
if ($action === 'export') { if (headers_sent()) {
< print_error('headersent');
> throw new \moodle_exception('headersent');
}
< $exportfile = data_presets_export($course, $cm, $data);
> // Check if we should export a given preset or the current one. > $presetname = optional_param('presetname', $data->name, PARAM_FILE); > > $preset = preset::create_from_instance($manager, $presetname); > $exportfile = $preset->export();
$exportfilename = basename($exportfile); header("Content-Type: application/download\n"); header("Content-Disposition: attachment; filename=\"$exportfilename\""); header('Expires: 0'); header('Cache-Control: must-revalidate,post-check=0,pre-check=0'); header('Pragma: public'); // If this file was requested from a form, then mark download as complete. \core_form\util::form_download_complete(); $exportfilehandler = fopen($exportfile, 'rb'); print fread($exportfilehandler, filesize($exportfile)); fclose($exportfilehandler); unlink($exportfile); exit(0); }
< $formimportzip = new data_import_preset_zip_form(); < $formimportzip->set_data(array('d' => $data->id)); < < if ($formimportzip->is_cancelled()) { < redirect(new moodle_url('/mod/data/preset.php', ['d' => $data->id])); < }
> if ($action == 'importzip') { echo $OUTPUT->header(); > $filepath = optional_param('filepath', '', PARAM_PATH); > $importer = new preset_upload_importer($manager, $CFG->tempdir . $filepath); if ($formdata = $formimportzip->get_data()) { > if ($importer->needs_mapping()) {
< < if ($formdata = $formimportzip->get_data()) { < echo $OUTPUT->heading(get_string('importpreset', 'data'), 2, 'mb-4'); < $file = new stdClass; < $file->name = $formimportzip->get_new_filename('importfile'); < $file->path = $formimportzip->save_temp_file('importfile'); < $importer = new data_preset_upload_importer($course, $cm, $data, $file->path); < echo $renderer->import_setting_mappings($data, $importer);
> echo $OUTPUT->heading(get_string('fieldmappings', 'data'), 2, 'mb-4'); > echo $renderer->importing_preset($data, $importer);
}
> $importer->import(false); > core\notification::success(get_string('importsuccess', 'mod_data')); if (in_array($action, ['confirmdelete', 'delete', 'finishimport'])) { > redirect(new moodle_url('/mod/data/field.php', ['id' => $cm->id])); $fullname = optional_param('fullname', '' , PARAM_PATH); // The directory the preset is in. > exit(0); // Find out preset owner userid and shortname. > }
< if (in_array($action, ['confirmdelete', 'delete', 'finishimport'])) {
> // Preset preview injects CSS and JS to the page and should be done before the page header. > if ($action === 'preview') {
$userid = empty($parts[0]) ? 0 : (int)$parts[0];
> $templatename = optional_param('template', 'listtemplate', PARAM_ALPHA);
< $parts = explode('/', $fullname, 2); < $userid = empty($parts[0]) ? 0 : (int)$parts[0]; < $shortname = empty($parts[1]) ? '' : $parts[1]; < echo html_writer::start_div('overflow-hidden'); < < if ($action === 'confirmdelete') { < $path = data_preset_path($course, $userid, $shortname); < $strwarning = get_string('deletewarning', 'data').'<br />'.$shortname; < $optionsyes = [
> $preset = preset::create_from_fullname($manager, $fullname); > // Validate if the user can view this preset. > if (!$manager->can_view_preset($preset)) { > throw new \moodle_exception('cannotaccesspresentsother', manager::PLUGINNAME); > } > $preview = new preset_preview($manager, $preset, $templatename); > $preview->prepare_page($PAGE); > $url->params([
< 'action' => 'delete', < 'd' => $data->id,
> 'template' => $templatename, > ]); > $PAGE->set_url($url); > $titleparts = [ > get_string('preview', 'data', $preset->name), > format_string($cm->name), > format_string($course->fullname),
< $optionsno = ['d' => $data->id]; < echo $OUTPUT->confirm($strwarning, new moodle_url('/mod/data/preset.php', $optionsyes), < new moodle_url('/mod/data/preset.php', $optionsno));
> $PAGE->set_title(implode(moodle_page::TITLE_SEPARATOR, $titleparts)); > // Print the preview screen. > echo $OUTPUT->header(); > $actionbar = new action_bar($data->id, $url); > echo $actionbar->get_presets_preview_action_bar($manager, $fullname, $templatename); > echo $renderer->render($preview);
echo $OUTPUT->footer(); exit(0);
< } else if ($action === 'delete') { < if (!confirm_sesskey()) { < throw new moodle_exception('invalidsesskey'); < } < $selectedpreset = new stdClass(); < foreach ($presets as $preset) { < if ($preset->shortname == $shortname) { < $selectedpreset = $preset; < } < } < if (!isset($selectedpreset->shortname) || !data_user_can_delete_preset($context, $selectedpreset)) { < print_error('invalidrequest');
}
< data_delete_site_preset($shortname); < $strdeleted = get_string('deleted', 'data'); < echo $OUTPUT->notification("$shortname $strdeleted", 'notifysuccess'); < } else if ($action === 'finishimport') {
> if ($action === 'finishimport') {
if (!confirm_sesskey()) { throw new moodle_exception('invalidsesskey'); } $overwritesettings = optional_param('overwritesettings', false, PARAM_BOOL);
< if (!$fullname) { < $presetdir = $CFG->tempdir.'/forms/'.required_param('directory', PARAM_FILE); < if (!file_exists($presetdir) || !is_dir($presetdir)) { < print_error('cannotimport'); < } < $importer = new data_preset_upload_importer($course, $cm, $data, $presetdir); < } else { < $importer = new data_preset_existing_importer($course, $cm, $data, $fullname); < } < $importer->import($overwritesettings); < $strimportsuccess = get_string('importsuccess', 'data'); < $straddentries = get_string('addentries', 'data'); < $strtodatabase = get_string('todatabase', 'data'); < if (!$DB->get_records('data_records', array('dataid'=>$data->id))) { < echo $OUTPUT->notification("$strimportsuccess <a href='edit.php?d=$data->id'>$straddentries</a> $strtodatabase", 'notifysuccess'); < } else { < echo $OUTPUT->notification("$strimportsuccess", 'notifysuccess'); < } < } < echo $OUTPUT->continue_button(new moodle_url('/mod/data/preset.php', ['d' => $data->id])); < echo html_writer::end_div(); < echo $OUTPUT->footer(); < exit(0);
> $importer = preset_importer::create_from_parameters($manager); > $importer->finish_import_process($overwritesettings, $data);
}
< if ($action === 'import') { < echo $OUTPUT->heading(get_string('importpreset', 'data'), 2, 'mb-4'); < echo $formimportzip->display(); < } else {
> echo $OUTPUT->header(); >
$actionbar = new \mod_data\output\action_bar($data->id, $url); echo $actionbar->get_presets_action_bar();
< echo $OUTPUT->heading(get_string('presets', 'data'), 2, 'mb-4'); < $presets = new \mod_data\output\presets($data->id, $presets, new \moodle_url('/mod/data/field.php'), true);
> $presets = new \mod_data\output\presets($manager, $presets, new \moodle_url('/mod/data/field.php'), true);
echo $renderer->render_presets($presets);
< }
echo $OUTPUT->footer();