MDL-55127 mod_data: Search entries fixes
[moodle.git] / mod / data / tests / generator / lib.php
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
17 /**
18  * Data generator class for mod_data.
19  *
20  * @package    mod_data
21  * @category   test
22  * @copyright  2012 Petr Skoda {@link http://skodak.org}
23  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
24  */
26 defined('MOODLE_INTERNAL') || die();
29 /**
30  * Data generator class for mod_data.
31  *
32  * Currently, the field types in the ignoredfieldtypes array aren't supported.
33  *
34  * @package    mod_data
35  * @category   test
36  * @copyright  2012 Petr Skoda {@link http://skodak.org}
37  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
38  */
39 class mod_data_generator extends testing_module_generator {
41     /**
42      * @var int keep track of how many database fields have been created.
43      */
44     protected $databasefieldcount = 0;
46     /**
47      * @var int keep track of how many database records have been created.
48      */
49     protected $databaserecordcount = 0;
51     /**
52      * @var The field types which not handled by the generator as of now.
53      */
54     protected $ignoredfieldtypes = array('latlong', 'file', 'picture');
57     /**
58      * To be called from data reset code only,
59      * do not use in tests.
60      * @return void
61      */
62     public function reset() {
63         $this->databasefieldcount = 0;
64         $this->databaserecordcount = 0;
66         parent::reset();
67     }
69     /**
70      * Creates a mod_data instance
71      *
72      * @param array $record
73      * @param array $options
74      * @return StdClass
75      */
76     public function create_instance($record = null, array $options = null) {
77         // Note, the parent class does not type $record to cast to array and then to object.
78         $record = (object) (array) $record;
80         if (!isset($record->assessed)) {
81             $record->assessed = 0;
82         }
83         if (!isset($record->scale)) {
84             $record->scale = 0;
85         }
87         return parent::create_instance((array) $record, $options);
88     }
90     /**
91      * Creates a field for a mod_data instance.
92      * Currently, the field types in the ignoredfieldtypes array aren't supported.
93      *
94      * @param StdClass $record
95      * @param mod_data $data
96      * @return data_field_{type}
97      */
98     public function create_field(stdClass $record = null, $data = null) {
99         $record = (array) $record;
101         if (in_array($record['type'], $this->ignoredfieldtypes)) {
102             throw new coding_exception('$record\'s type value must not be same as values in ignoredfieldtypes
103                     in phpunit_util::create_field()');
104             return false;
105         }
107         $this->databasefieldcount++;
109         if (!isset($data->course)) {
110             throw new coding_exception('course must be present in phpunit_util::create_field() $data');
111         }
113         if (!isset($data->id)) {
114             throw new coding_exception('dataid must be present in phpunit_util::create_field() $data');
115         } else {
116             $record['dataid'] = $data->id;
117         }
119         if (!isset($record['type'])) {
120             throw new coding_exception('type must be present in phpunit_util::create_field() $record');
121         }
123         if (!isset($record['required'])) {
124             $record['required'] = 0;
125         }
127         if (!isset($record['name'])) {
128             $record['name'] = "testField - " . $this->databasefieldcount;
129         }
131         if (!isset($record['description'])) {
132             $record['description'] = " This is testField - " . $this->databasefieldcount;
133         }
135         if (!isset($record['param1'])) {
136             if ($record['type'] == 'checkbox') {
137                 $record['param1'] = implode("\n", array('opt1', 'opt2', 'opt3', 'opt4'));
138             } else if ($record['type'] == 'radiobutton') {
139                 $record['param1'] = implode("\n", array('radioopt1', 'radioopt2', 'radioopt3', 'radioopt4'));
140             } else if ($record['type'] == 'menu') {
141                 $record['param1'] = implode("\n", array('menu1', 'menu2', 'menu3', 'menu4'));
142             } else if ($record['type'] == 'multimenu') {
143                 $record['param1'] = implode("\n", array('multimenu1', 'multimenu2', 'multimenu3', 'multimenu4'));
144             } else if (($record['type'] === 'text') || ($record['type'] === 'url')) {
145                 $record['param1'] = 1;
146             } else {
147                 $record['param1'] = '';
148             }
149         }
151         if (!isset($record['param2'])) {
153             if ($record['type'] === 'textarea') {
154                 $record['param2'] = 60;
155             } else {
156                 $record['param2'] = '';
157             }
158         }
160         if (!isset($record['param3'])) {
162             if (($record['type'] === 'textarea')) {
163                 $record['param3'] = 35;
164             } else {
165                 $record['param3'] = '';
166             }
167         }
169         if (!isset($record['param4'])) {
171             if (($record['type'] === 'textarea')) {
172                 $record['param4'] = 1;
173             }
174         }
176         if (!isset($record['param5'])) {
177             if (($record['type'] === 'textarea')) {
178                 $record['param5'] = 0;
179             }
180         }
182         $record = (object) $record;
184         $field = data_get_field($record, $data);
185         $field->insert_field();
187         data_generate_default_template($data, 'addtemplate', 0, false, true);
189         return $field;
190     }
192     /**
193      * Creates a field for a mod_data instance.
194      * Keep in mind the default data field params created in create_field() function!
195      * ...if you haven't provided your own custom data field parameters there.
196      * Currently, the field types in the ignoredfieldtypes array aren't supported.
197      * The developers using the generator must adhere to the following format :
198      *
199      *   Syntax : $contents[ fieldid ] = fieldvalue
200      *   $contents['checkbox'] = array('val1', 'val2', 'val3' .....)
201      *   $contents['data'] = 'dd-mm-yyyy'
202      *   $contents['menu'] = 'value';
203      *   $contents['multimenu'] =  array('val1', 'val2', 'val3' .....)
204      *   $contents['number'] = 'numeric value'
205      *   $contents['radiobuton'] = 'value'
206      *   $contents['text'] = 'text'
207      *   $contents['textarea'] = 'text'
208      *   $contents['url'] = 'example.url' or array('example.url', 'urlname')
209      *
210      * @param mod_data $data
211      * @param array $contents
212      * @return data_field_{type}
213      */
214     public function create_entry($data, array $contents, $groupid = 0) {
215         global $DB;
217         $this->databaserecordcount++;
219         $recordid = data_add_record($data, $groupid);
221         $fields = $DB->get_records('data_fields', array('dataid' => $data->id));
223         // Validating whether required field are filled.
224         foreach ($fields as $field) {
225             $fieldhascontent = true;
227             if (in_array($field->type, $this->ignoredfieldtypes)) {
228                 continue;
229             }
231             $field = data_get_field($field, $data);
233             $fieldid = $field->field->id;
235             if ($field->type === 'date') {
236                 $values = array();
238                 $temp = explode('-', $contents[$fieldid], 3);
240                 $values['field_' . $fieldid . '_day'] = (int)trim($temp[0]);
241                 $values['field_' . $fieldid . '_month'] = (int)trim($temp[1]);
242                 $values['field_' . $fieldid . '_year'] = (int)trim($temp[2]);
244                 // Year should be less than 2038, so it can be handled by 32 bit windows.
245                 if ($values['field_' . $fieldid . '_year'] > 2038) {
246                     throw new coding_exception('DateTime::getTimestamp resturns false on 32 bit win for year beyond ' .
247                         '2038. Please use year less than 2038.');
248                 }
250                 $contents[$fieldid] = $values;
252                 foreach ($values as $fieldname => $value) {
253                     if (!$field->notemptyfield($value, $fieldname)) {
254                         $fieldhascontent = false;
255                     }
256                 }
257             } else if ($field->type === 'textarea') {
258                 $values = array();
260                 $values['field_' . $fieldid] = $contents[$fieldid];
261                 $values['field_' . $fieldid . '_content1'] = 1;
263                 $contents[$fieldid] = $values;
265                 $fieldname = 'field_' . $fieldid;
266                 if (!$field->notemptyfield($values[$fieldname], $fieldname)) {
267                     $fieldhascontent = false;
268                 }
270             } else if ($field->type === 'url') {
271                 $values = array();
273                 if (is_array($contents[$fieldid])) {
274                     foreach ($contents[$fieldid] as $key => $value) {
275                         $values['field_' . $fieldid . '_' . $key] = $value;
276                     }
277                 } else {
278                     $values['field_' . $fieldid . '_0'] = $contents[$fieldid];
279                 }
281                 $contents[$fieldid] = $values;
282                 $fieldname = 'field_' . $fieldid . '_0';
283                 if (!$field->notemptyfield($values[$fieldname], $fieldname)) {
284                     $fieldhascontent = false;
285                 }
287             } else {
288                 if ($field->notemptyfield($contents[$fieldid], 'field_' . $fieldid . '_0')) {
289                     continue;
290                 }
291             }
293             if ($field->field->required && !$fieldhascontent) {
294                 return false;
295             }
296         }
298         foreach ($contents as $fieldid => $content) {
299             $field = data_get_field_from_id($fieldid, $data);
301             if (is_array($content) and in_array($field->type, array('date', 'textarea', 'url'))) {
303                 foreach ($content as $fieldname => $value) {
304                     $field->update_content($recordid, $value, $fieldname);
305                 }
307             } else {
308                 $field->update_content($recordid, $content);
309             }
310         }
312         return $recordid;
313     }