Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are 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/>.

/**
 * Data generator class for mod_data.
 *
 * @package    mod_data
 * @category   test
 * @copyright  2012 Petr Skoda {@link http://skodak.org}
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

> use mod_data\manager; defined('MOODLE_INTERNAL') || die(); > use mod_data\preset; >
/** * Data generator class for mod_data. * * @package mod_data * @category test * @copyright 2012 Petr Skoda {@link http://skodak.org} * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class mod_data_generator extends testing_module_generator { /** * @var int keep track of how many database fields have been created. */ protected $databasefieldcount = 0; /** * @var int keep track of how many database records have been created. */ protected $databaserecordcount = 0; /** * To be called from data reset code only, * do not use in tests. * @return void */ public function reset() { $this->databasefieldcount = 0; $this->databaserecordcount = 0; parent::reset(); } /** * Creates a mod_data instance * * @param array $record * @param array $options * @return StdClass */ public function create_instance($record = null, array $options = null) { // Note, the parent class does not type $record to cast to array and then to object. $record = (object) (array) $record; if (!isset($record->assessed)) { $record->assessed = 0; } if (!isset($record->scale)) { $record->scale = 0; } return parent::create_instance((array) $record, $options); } /** * Creates a field for a mod_data instance. * * @param StdClass $record * @param mod_data $data * @return data_field_{type} */ public function create_field(stdClass $record = null, $data = null) { $record = (array) $record; $this->databasefieldcount++; if (!isset($data->course)) { throw new coding_exception('course must be present in phpunit_util::create_field() $data'); } if (!isset($data->id)) { throw new coding_exception('dataid must be present in phpunit_util::create_field() $data'); } else { $record['dataid'] = $data->id; } if (!isset($record['type'])) { throw new coding_exception('type must be present in phpunit_util::create_field() $record'); } if (!isset($record['required'])) { $record['required'] = 0; } if (!isset($record['name'])) { $record['name'] = "testField - " . $this->databasefieldcount; } if (!isset($record['description'])) { $record['description'] = " This is testField - " . $this->databasefieldcount; }
> if (isset($record['param1']) && !empty($record['param1'])) { if (!isset($record['param1'])) { > // Some fields have multiline entries. if ($record['type'] == 'checkbox') { > $record['param1'] = str_replace('\n', "\n", $record['param1']); $record['param1'] = implode("\n", array('opt1', 'opt2', 'opt3', 'opt4')); > } } else if ($record['type'] == 'radiobutton') { >
$record['param1'] = implode("\n", array('radioopt1', 'radioopt2', 'radioopt3', 'radioopt4')); } else if ($record['type'] == 'menu') { $record['param1'] = implode("\n", array('menu1', 'menu2', 'menu3', 'menu4')); } else if ($record['type'] == 'multimenu') { $record['param1'] = implode("\n", array('multimenu1', 'multimenu2', 'multimenu3', 'multimenu4')); } else if (($record['type'] === 'text') || ($record['type'] === 'url')) { $record['param1'] = 1; } else if ($record['type'] == 'latlong') { $record['param1'] = 'Google Maps'; } else { $record['param1'] = ''; } } if (!isset($record['param2'])) { if ($record['type'] === 'textarea') { $record['param2'] = 60; } else if ($record['type'] == 'latlong') { $record['param2'] = -1; } else { $record['param2'] = ''; } } if (!isset($record['param3'])) { if (($record['type'] === 'textarea')) { $record['param3'] = 35; } else if ($record['type'] == 'picture' || $record['type'] == 'file') { $record['param3'] = 0; } else { $record['param3'] = ''; } } if (!isset($record['param4'])) { if (($record['type'] === 'textarea')) { $record['param4'] = 1; } } if (!isset($record['param5'])) { if (($record['type'] === 'textarea')) { $record['param5'] = 0; } } $record = (object) $record; $field = data_get_field($record, $data); $field->insert_field();
< data_generate_default_template($data, 'addtemplate', 0, false, true); <
return $field; } /** * Creates a field for a mod_data instance. * Keep in mind the default data field params created in create_field() function! * ...if you haven't provided your own custom data field parameters there. * The developers using the generator must adhere to the following format : * * Syntax : $contents[ fieldid ] = fieldvalue * $contents['checkbox'] = array('val1', 'val2', 'val3' .....) * $contents['data'] = 'dd-mm-yyyy' * $contents['menu'] = 'value'; * $contents['multimenu'] = array('val1', 'val2', 'val3' .....) * $contents['number'] = 'numeric value' * $contents['radiobuton'] = 'value' * $contents['text'] = 'text' * $contents['textarea'] = 'text' * $contents['url'] = 'example.url' or array('example.url', 'urlname') * $contents['latlong'] = array('value for lattitude', 'value for longitude') * $contents['file'] = 'filename or draftitemid' * $contents['picture'] = array('filename or draftitemid', 'alternative text') * * @param stdClass $data record from table {data} * @param array $contents * @param int $groupid * @param array $tags * @param array $options
> * @param int $userid if defined, it will be the author of the entry
* @return int id of the generated record in table {data_records} */
< public function create_entry($data, array $contents, $groupid = 0, $tags = [], array $options = null) {
> public function create_entry($data, array $contents, $groupid = 0, $tags = [], array $options = null, int $userid = 0) {
global $DB, $USER, $CFG;
> // Set current user if defined. $this->databaserecordcount++; > if (!empty($userid)) { > $currentuser = $USER; $recordid = data_add_record($data, $groupid); > $user = \core_user::get_user($userid); > $this->set_user($user); if (isset($options['approved'])) { > } data_approve_entry($recordid, !empty($options['approved'])); >
} else { $approved = null; } $fields = $DB->get_records('data_fields', array('dataid' => $data->id)); // Validating whether required field are filled. foreach ($fields as $field) { $fieldhascontent = true; $field = data_get_field($field, $data); $fieldid = $field->field->id; if ($field->type === 'date') { $values = array(); $temp = explode('-', $contents[$fieldid], 3); $values['field_' . $fieldid . '_day'] = (int)trim($temp[0]); $values['field_' . $fieldid . '_month'] = (int)trim($temp[1]); $values['field_' . $fieldid . '_year'] = (int)trim($temp[2]); // Year should be less than 2038, so it can be handled by 32 bit windows. if ($values['field_' . $fieldid . '_year'] > 2038) { throw new coding_exception('DateTime::getTimestamp resturns false on 32 bit win for year beyond ' . '2038. Please use year less than 2038.'); } $contents[$fieldid] = $values; foreach ($values as $fieldname => $value) { if (!$field->notemptyfield($value, $fieldname)) { $fieldhascontent = false; } } } else if ($field->type === 'textarea') { $values = array(); $values['field_' . $fieldid] = $contents[$fieldid]; $values['field_' . $fieldid . '_content1'] = 1; $contents[$fieldid] = $values; $fieldname = 'field_' . $fieldid; if (!$field->notemptyfield($values[$fieldname], $fieldname)) { $fieldhascontent = false; } } else if ($field->type === 'url') { $values = array(); if (is_array($contents[$fieldid])) { foreach ($contents[$fieldid] as $key => $value) { $values['field_' . $fieldid . '_' . $key] = $value; } } else { $values['field_' . $fieldid . '_0'] = $contents[$fieldid]; } $contents[$fieldid] = $values; $fieldname = 'field_' . $fieldid . '_0'; if (!$field->notemptyfield($values[$fieldname], $fieldname)) { $fieldhascontent = false; } } else if ($field->type === 'latlong') { $values = array(); foreach ($contents[$fieldid] as $key => $value) { $values['field_' . $fieldid . '_' . $key] = $value; } $contents[$fieldid] = $values; $fieldname = 'field_' . $fieldid . '_0'; if (!$field->notemptyfield($values[$fieldname], $fieldname)) { $fieldhascontent = false; } } else if ($field->type === 'file' || $field->type === 'picture') { if (is_array($contents[$fieldid])) { list($itemid, $alttext) = $contents[$fieldid]; } else { $itemid = $contents[$fieldid]; $alttext = ''; } if (strlen($itemid) && !is_numeric($itemid)) { // We expect draftarea item id here but it can also be a filename, in this case provider will generate file. $filename = $itemid; $usercontext = context_user::instance($USER->id); $itemid = file_get_unused_draft_itemid(); get_file_storage()->create_file_from_string(['component' => 'user', 'filearea' => 'draft', 'contextid' => $usercontext->id, 'itemid' => $itemid, 'filepath' => '/', 'filename' => $filename],
< file_get_contents($CFG->dirroot.'/mod/data/pix/icon.png'));
> file_get_contents($CFG->dirroot.'/mod/data/pix/monologo.png'));
} $fieldname = 'field_' . $fieldid . '_file'; if ($field->type === 'file') { $contents[$fieldid] = $itemid; } else { $contents[$fieldid] = [ $fieldname => $itemid, 'field_' . $fieldid . '_alttext' => $alttext ]; } if (!$field->notemptyfield($itemid, $fieldname)) { $fieldhascontent = false; } } else { if ($field->notemptyfield($contents[$fieldid], 'field_' . $fieldid . '_0')) { continue; } } if ($field->field->required && !$fieldhascontent) { return false; } } foreach ($contents as $fieldid => $content) { $field = data_get_field_from_id($fieldid, $data); if (is_array($content) and in_array($field->type, array('date', 'textarea', 'url', 'picture', 'latlong'))) { foreach ($content as $fieldname => $value) { $field->update_content($recordid, $value, $fieldname); } } else { $field->update_content($recordid, $content); } } if (!empty($tags)) { $cm = get_coursemodule_from_instance('data', $data->id); core_tag_tag::set_item_tags('mod_data', 'data_records', $recordid, context_module::instance($cm->id), $tags); }
> if (isset($currentuser)) { return $recordid; > $this->set_user($currentuser); } > } } >
> } > > /** > * Creates a preset from a mod_data instance. > * > * @param stdClass $instance The mod_data instance. > * @param stdClass|null $record The preset information, like 'name'. > * @return preset The preset that has been created. > */ > public function create_preset(stdClass $instance, stdClass $record = null): preset { > global $USER; > > if (is_null($record)) { > $record = new stdClass(); > } > > // Set current user if defined. > if (isset($record->userid) && $record->userid != $USER->id) { > $currentuser = $USER; > $user = \core_user::get_user($record->userid); > $this->set_user($user); > } > > // Fill in optional values if not specified. > $presetname = 'New preset ' . microtime(); > if (isset($record->name)) { > $presetname = $record->name; > } > $presetdescription = null; > if (isset($record->description)) { > $presetdescription = $record->description; > } > > $manager = manager::create_from_instance($instance); > $preset = preset::create_from_instance($manager, $presetname, $presetdescription); > $preset->save(); > > if (isset($currentuser)) { > $this->set_user($currentuser); > } > > return $preset;