MDL-45144 convert book events to create_from_xxx() helpers
[moodle.git] / mod / scorm / mod_form.php
blobd240b3fc2068b35581b58e2048145f0e137098d5
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.
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 if (!defined('MOODLE_INTERNAL')) {
18 die('Direct access to this script is forbidden.'); // It must be included from a Moodle page.
21 require_once($CFG->dirroot.'/course/moodleform_mod.php');
22 require_once($CFG->dirroot.'/mod/scorm/locallib.php');
24 class mod_scorm_mod_form extends moodleform_mod {
26 public function definition() {
27 global $CFG, $COURSE, $OUTPUT;
28 $cfgscorm = get_config('scorm');
30 $mform = $this->_form;
32 if (!$CFG->slasharguments) {
33 $mform->addElement('static', '', '', $OUTPUT->notification(get_string('slashargs', 'scorm'), 'notifyproblem'));
36 $mform->addElement('header', 'general', get_string('general', 'form'));
38 // Name.
39 $mform->addElement('text', 'name', get_string('name'));
40 if (!empty($CFG->formatstringstriptags)) {
41 $mform->setType('name', PARAM_TEXT);
42 } else {
43 $mform->setType('name', PARAM_CLEANHTML);
45 $mform->addRule('name', null, 'required', null, 'client');
46 $mform->addRule('name', get_string('maximumchars', '', 255), 'maxlength', 255, 'client');
48 // Summary.
49 $this->add_intro_editor(true);
51 // Package.
52 $mform->addElement('header', 'packagehdr', get_string('packagehdr', 'scorm'));
53 $mform->setExpanded('packagehdr', true);
55 // Scorm types.
56 $scormtypes = array(SCORM_TYPE_LOCAL => get_string('typelocal', 'scorm'));
58 if ($cfgscorm->allowtypeexternal) {
59 $scormtypes[SCORM_TYPE_EXTERNAL] = get_string('typeexternal', 'scorm');
62 if ($cfgscorm->allowtypelocalsync) {
63 $scormtypes[SCORM_TYPE_LOCALSYNC] = get_string('typelocalsync', 'scorm');
66 if ($cfgscorm->allowtypeexternalaicc) {
67 $scormtypes[SCORM_TYPE_AICCURL] = get_string('typeaiccurl', 'scorm');
70 // Reference.
71 if (count($scormtypes) > 1) {
72 $mform->addElement('select', 'scormtype', get_string('scormtype', 'scorm'), $scormtypes);
73 $mform->setType('scormtype', PARAM_ALPHA);
74 $mform->addHelpButton('scormtype', 'scormtype', 'scorm');
75 $mform->addElement('text', 'packageurl', get_string('packageurl', 'scorm'), array('size'=>60));
76 $mform->setType('packageurl', PARAM_RAW);
77 $mform->addHelpButton('packageurl', 'packageurl', 'scorm');
78 $mform->disabledIf('packageurl', 'scormtype', 'eq', SCORM_TYPE_LOCAL);
79 } else {
80 $mform->addElement('hidden', 'scormtype', SCORM_TYPE_LOCAL);
81 $mform->setType('scormtype', PARAM_ALPHA);
84 // New local package upload.
85 $filemanageroptions = array();
86 $filemanageroptions['accepted_types'] = array('.zip', '.xml');
87 $filemanageroptions['maxbytes'] = 0;
88 $filemanageroptions['maxfiles'] = 1;
89 $filemanageroptions['subdirs'] = 0;
91 $mform->addElement('filemanager', 'packagefile', get_string('package', 'scorm'), null, $filemanageroptions);
92 $mform->addHelpButton('packagefile', 'package', 'scorm');
93 $mform->disabledIf('packagefile', 'scormtype', 'noteq', SCORM_TYPE_LOCAL);
95 // Update packages timing.
96 $mform->addElement('select', 'updatefreq', get_string('updatefreq', 'scorm'), scorm_get_updatefreq_array());
97 $mform->setType('updatefreq', PARAM_INT);
98 $mform->setDefault('updatefreq', $cfgscorm->updatefreq);
99 $mform->addHelpButton('updatefreq', 'updatefreq', 'scorm');
101 // Display Settings.
102 $mform->addElement('header', 'displaysettings', get_string('appearance'));
104 // Framed / Popup Window.
105 $mform->addElement('select', 'popup', get_string('display', 'scorm'), scorm_get_popup_display_array());
106 $mform->setDefault('popup', $cfgscorm->popup);
107 $mform->setAdvanced('popup', $cfgscorm->popup_adv);
109 // Width.
110 $mform->addElement('text', 'width', get_string('width', 'scorm'), 'maxlength="5" size="5"');
111 $mform->setDefault('width', $cfgscorm->framewidth);
112 $mform->setType('width', PARAM_INT);
113 $mform->setAdvanced('width', $cfgscorm->framewidth_adv);
114 $mform->disabledIf('width', 'popup', 'eq', 0);
116 // Height.
117 $mform->addElement('text', 'height', get_string('height', 'scorm'), 'maxlength="5" size="5"');
118 $mform->setDefault('height', $cfgscorm->frameheight);
119 $mform->setType('height', PARAM_INT);
120 $mform->setAdvanced('height', $cfgscorm->frameheight_adv);
121 $mform->disabledIf('height', 'popup', 'eq', 0);
123 // Window Options.
124 $winoptgrp = array();
125 foreach (scorm_get_popup_options_array() as $key => $value) {
126 $winoptgrp[] = &$mform->createElement('checkbox', $key, '', get_string($key, 'scorm'));
127 $mform->setDefault($key, $value);
129 $mform->addGroup($winoptgrp, 'winoptgrp', get_string('options', 'scorm'), '<br />', false);
130 $mform->disabledIf('winoptgrp', 'popup', 'eq', 0);
131 $mform->setAdvanced('winoptgrp', $cfgscorm->winoptgrp_adv);
133 // Display activity name.
134 $mform->addElement('advcheckbox', 'displayactivityname', get_string('displayactivityname', 'scorm'));
135 $mform->addHelpButton('displayactivityname', 'displayactivityname', 'scorm');
136 $mform->setDefault('displayactivityname', $cfgscorm->displayactivityname);
138 // Skip view page.
139 $skipviewoptions = scorm_get_skip_view_array();
140 if ($COURSE->format == 'singleactivity') { // Remove option that would cause a constant redirect.
141 unset($skipviewoptions[SCORM_SKIPVIEW_ALWAYS]);
142 if ($cfgscorm->skipview == SCORM_SKIPVIEW_ALWAYS) {
143 $cfgscorm->skipview = SCORM_SKIPVIEW_FIRST;
146 $mform->addElement('select', 'skipview', get_string('skipview', 'scorm'), $skipviewoptions);
147 $mform->addHelpButton('skipview', 'skipview', 'scorm');
148 $mform->setDefault('skipview', $cfgscorm->skipview);
149 $mform->setAdvanced('skipview', $cfgscorm->skipview_adv);
151 // Hide Browse.
152 $mform->addElement('selectyesno', 'hidebrowse', get_string('hidebrowse', 'scorm'));
153 $mform->addHelpButton('hidebrowse', 'hidebrowse', 'scorm');
154 $mform->setDefault('hidebrowse', $cfgscorm->hidebrowse);
155 $mform->setAdvanced('hidebrowse', $cfgscorm->hidebrowse_adv);
157 // Display course structure.
158 $mform->addElement('selectyesno', 'displaycoursestructure', get_string('displaycoursestructure', 'scorm'));
159 $mform->addHelpButton('displaycoursestructure', 'displaycoursestructure', 'scorm');
160 $mform->setDefault('displaycoursestructure', $cfgscorm->displaycoursestructure);
161 $mform->setAdvanced('displaycoursestructure', $cfgscorm->displaycoursestructure_adv);
163 // Toc display.
164 $mform->addElement('select', 'hidetoc', get_string('hidetoc', 'scorm'), scorm_get_hidetoc_array());
165 $mform->addHelpButton('hidetoc', 'hidetoc', 'scorm');
166 $mform->setDefault('hidetoc', $cfgscorm->hidetoc);
167 $mform->setAdvanced('hidetoc', $cfgscorm->hidetoc_adv);
168 $mform->disabledIf('hidetoc', 'scormtype', 'eq', SCORM_TYPE_AICCURL);
170 // Navigation panel display.
171 $mform->addElement('select', 'nav', get_string('nav', 'scorm'), scorm_get_navigation_display_array());
172 $mform->addHelpButton('nav', 'nav', 'scorm');
173 $mform->setDefault('nav', $cfgscorm->nav);
174 $mform->setAdvanced('nav', $cfgscorm->nav_adv);
175 $mform->disabledIf('nav', 'hidetoc', 'noteq', SCORM_TOC_SIDE);
177 // Navigation panel position from left.
178 $mform->addElement('text', 'navpositionleft', get_string('fromleft', 'scorm'), 'maxlength="5" size="5"');
179 $mform->setDefault('navpositionleft', $cfgscorm->navpositionleft);
180 $mform->setType('navpositionleft', PARAM_INT);
181 $mform->setAdvanced('navpositionleft', $cfgscorm->navpositionleft_adv);
182 $mform->disabledIf('navpositionleft', 'hidetoc', 'noteq', SCORM_TOC_SIDE);
183 $mform->disabledIf('navpositionleft', 'nav', 'noteq', SCORM_NAV_FLOATING);
185 // Navigation panel position from top.
186 $mform->addElement('text', 'navpositiontop', get_string('fromtop', 'scorm'), 'maxlength="5" size="5"');
187 $mform->setDefault('navpositiontop', $cfgscorm->navpositiontop);
188 $mform->setType('navpositiontop', PARAM_INT);
189 $mform->setAdvanced('navpositiontop', $cfgscorm->navpositiontop_adv);
190 $mform->disabledIf('navpositiontop', 'hidetoc', 'noteq', SCORM_TOC_SIDE);
191 $mform->disabledIf('navpositiontop', 'nav', 'noteq', SCORM_NAV_FLOATING);
193 // Display attempt status.
194 $mform->addElement('select', 'displayattemptstatus', get_string('displayattemptstatus', 'scorm'),
195 scorm_get_attemptstatus_array());
196 $mform->addHelpButton('displayattemptstatus', 'displayattemptstatus', 'scorm');
197 $mform->setDefault('displayattemptstatus', $cfgscorm->displayattemptstatus);
198 $mform->setAdvanced('displayattemptstatus', $cfgscorm->displayattemptstatus_adv);
200 // Availability.
201 $mform->addElement('header', 'availability', get_string('availability'));
203 $mform->addElement('date_time_selector', 'timeopen', get_string("scormopen", "scorm"), array('optional' => true));
204 $mform->addElement('date_time_selector', 'timeclose', get_string("scormclose", "scorm"), array('optional' => true));
206 // Grade Settings.
207 $mform->addElement('header', 'gradesettings', get_string('grade'));
209 // Grade Method.
210 $mform->addElement('select', 'grademethod', get_string('grademethod', 'scorm'), scorm_get_grade_method_array());
211 $mform->addHelpButton('grademethod', 'grademethod', 'scorm');
212 $mform->setDefault('grademethod', $cfgscorm->grademethod);
214 // Maximum Grade.
215 for ($i=0; $i<=100; $i++) {
216 $grades[$i] = "$i";
218 $mform->addElement('select', 'maxgrade', get_string('maximumgrade'), $grades);
219 $mform->setDefault('maxgrade', $cfgscorm->maxgrade);
220 $mform->disabledIf('maxgrade', 'grademethod', 'eq', GRADESCOES);
222 // Attempts management.
223 $mform->addElement('header', 'attemptsmanagementhdr', get_string('attemptsmanagement', 'scorm'));
225 // Max Attempts.
226 $mform->addElement('select', 'maxattempt', get_string('maximumattempts', 'scorm'), scorm_get_attempts_array());
227 $mform->addHelpButton('maxattempt', 'maximumattempts', 'scorm');
228 $mform->setDefault('maxattempt', $cfgscorm->maxattempt);
230 // What Grade.
231 $mform->addElement('select', 'whatgrade', get_string('whatgrade', 'scorm'), scorm_get_what_grade_array());
232 $mform->disabledIf('whatgrade', 'maxattempt', 'eq', 1);
233 $mform->addHelpButton('whatgrade', 'whatgrade', 'scorm');
234 $mform->setDefault('whatgrade', $cfgscorm->whatgrade);
236 // Force new attempt.
237 $mform->addElement('selectyesno', 'forcenewattempt', get_string('forcenewattempt', 'scorm'));
238 $mform->addHelpButton('forcenewattempt', 'forcenewattempt', 'scorm');
239 $mform->setDefault('forcenewattempt', $cfgscorm->forcenewattempt);
241 // Last attempt lock - lock the enter button after the last available attempt has been made.
242 $mform->addElement('selectyesno', 'lastattemptlock', get_string('lastattemptlock', 'scorm'));
243 $mform->addHelpButton('lastattemptlock', 'lastattemptlock', 'scorm');
244 $mform->setDefault('lastattemptlock', $cfgscorm->lastattemptlock);
246 // Compatibility settings.
247 $mform->addElement('header', 'compatibilitysettingshdr', get_string('compatibilitysettings', 'scorm'));
249 // Force completed.
250 $mform->addElement('selectyesno', 'forcecompleted', get_string('forcecompleted', 'scorm'));
251 $mform->addHelpButton('forcecompleted', 'forcecompleted', 'scorm');
252 $mform->setDefault('forcecompleted', $cfgscorm->forcecompleted);
254 // Autocontinue.
255 $mform->addElement('selectyesno', 'auto', get_string('autocontinue', 'scorm'));
256 $mform->addHelpButton('auto', 'autocontinue', 'scorm');
257 $mform->setDefault('auto', $cfgscorm->auto);
259 // Hidden Settings.
260 $mform->addElement('hidden', 'datadir', null);
261 $mform->setType('datadir', PARAM_RAW);
262 $mform->addElement('hidden', 'pkgtype', null);
263 $mform->setType('pkgtype', PARAM_RAW);
264 $mform->addElement('hidden', 'launch', null);
265 $mform->setType('launch', PARAM_RAW);
266 $mform->addElement('hidden', 'redirect', null);
267 $mform->setType('redirect', PARAM_RAW);
268 $mform->addElement('hidden', 'redirecturl', null);
269 $mform->setType('redirecturl', PARAM_RAW);
271 $this->standard_coursemodule_elements();
273 // Buttons.
274 $this->add_action_buttons();
277 public function data_preprocessing(&$defaultvalues) {
278 global $COURSE;
280 if (isset($defaultvalues['popup']) && ($defaultvalues['popup'] == 1) && isset($defaultvalues['options'])) {
281 if (!empty($defaultvalues['options'])) {
282 $options = explode(',', $defaultvalues['options']);
283 foreach ($options as $option) {
284 list($element, $value) = explode('=', $option);
285 $element = trim($element);
286 $defaultvalues[$element] = trim($value);
290 if (isset($defaultvalues['grademethod'])) {
291 $defaultvalues['grademethod'] = intval($defaultvalues['grademethod']);
293 if (isset($defaultvalues['width']) && (strpos($defaultvalues['width'], '%') === false)
294 && ($defaultvalues['width'] <= 100)) {
295 $defaultvalues['width'] .= '%';
297 if (isset($defaultvalues['width']) && (strpos($defaultvalues['height'], '%') === false)
298 && ($defaultvalues['height'] <= 100)) {
299 $defaultvalues['height'] .= '%';
301 $scorms = get_all_instances_in_course('scorm', $COURSE);
302 $coursescorm = current($scorms);
304 $draftitemid = file_get_submitted_draft_itemid('packagefile');
305 file_prepare_draft_area($draftitemid, $this->context->id, 'mod_scorm', 'package', 0,
306 array('subdirs' => 0, 'maxfiles' => 1));
307 $defaultvalues['packagefile'] = $draftitemid;
309 if (($COURSE->format == 'singleactivity') && ((count($scorms) == 0) || ($defaultvalues['instance'] == $coursescorm->id))) {
310 $defaultvalues['redirect'] = 'yes';
311 $defaultvalues['redirecturl'] = '../course/view.php?id='.$defaultvalues['course'];
312 } else {
313 $defaultvalues['redirect'] = 'no';
314 $defaultvalues['redirecturl'] = '../mod/scorm/view.php?id='.$defaultvalues['coursemodule'];
316 if (isset($defaultvalues['version'])) {
317 $defaultvalues['pkgtype'] = (substr($defaultvalues['version'], 0, 5) == 'SCORM') ? 'scorm':'aicc';
319 if (isset($defaultvalues['instance'])) {
320 $defaultvalues['datadir'] = $defaultvalues['instance'];
322 if (empty($defaultvalues['timeopen'])) {
323 $defaultvalues['timeopen'] = 0;
325 if (empty($defaultvalues['timeclose'])) {
326 $defaultvalues['timeclose'] = 0;
329 // Set some completion default data.
330 if (!empty($defaultvalues['completionstatusrequired']) && !is_array($defaultvalues['completionstatusrequired'])) {
331 // Unpack values.
332 $cvalues = array();
333 foreach (scorm_status_options() as $key => $value) {
334 if (($defaultvalues['completionstatusrequired'] & $key) == $key) {
335 $cvalues[$key] = 1;
339 $defaultvalues['completionstatusrequired'] = $cvalues;
342 if (!isset($defaultvalues['completionscorerequired']) || !strlen($defaultvalues['completionscorerequired'])) {
343 $defaultvalues['completionscoredisabled'] = 1;
347 public function validation($data, $files) {
348 global $CFG, $USER;
349 $errors = parent::validation($data, $files);
351 $type = $data['scormtype'];
353 if ($type === SCORM_TYPE_LOCAL) {
354 if (empty($data['packagefile'])) {
355 $errors['packagefile'] = get_string('required');
357 } else {
358 $draftitemid = file_get_submitted_draft_itemid('packagefile');
360 file_prepare_draft_area($draftitemid, $this->context->id, 'mod_scorm', 'packagefilecheck', null,
361 array('subdirs' => 0, 'maxfiles' => 1));
363 // Get file from users draft area.
364 $usercontext = context_user::instance($USER->id);
365 $fs = get_file_storage();
366 $files = $fs->get_area_files($usercontext->id, 'user', 'draft', $draftitemid, 'id', false);
368 if (count($files)<1) {
369 $errors['packagefile'] = get_string('required');
370 return $errors;
372 $file = reset($files);
373 if (!$file->is_external_file() && !empty($data['updatefreq'])) {
374 // Make sure updatefreq is not set if using normal local file.
375 $errors['updatefreq'] = get_string('updatefreq_error', 'mod_scorm');
377 if (strtolower($file->get_filename()) == 'imsmanifest.xml') {
378 if (!$file->is_external_file()) {
379 $errors['packagefile'] = get_string('aliasonly', 'mod_scorm');
380 } else {
381 $repository = repository::get_repository_by_id($file->get_repository_id(), context_system::instance());
382 if (!$repository->supports_relative_file()) {
383 $errors['packagefile'] = get_string('repositorynotsupported', 'mod_scorm');
386 } else if (strtolower(substr($file->get_filename(), -3)) == 'xml') {
387 $errors['packagefile'] = get_string('invalidmanifestname', 'mod_scorm');
388 } else {
389 // Validate this SCORM package.
390 $errors = array_merge($errors, scorm_validate_package($file));
394 } else if ($type === SCORM_TYPE_EXTERNAL) {
395 $reference = $data['packageurl'];
396 // Syntax check.
397 if (!preg_match('/(http:\/\/|https:\/\/|www).*\/imsmanifest.xml$/i', $reference)) {
398 $errors['packageurl'] = get_string('invalidurl', 'scorm');
399 } else {
400 // Availability check.
401 $result = scorm_check_url($reference);
402 if (is_string($result)) {
403 $errors['packageurl'] = $result;
407 } else if ($type === 'packageurl') {
408 $reference = $data['reference'];
409 // Syntax check.
410 if (!preg_match('/(http:\/\/|https:\/\/|www).*(\.zip|\.pif)$/i', $reference)) {
411 $errors['packageurl'] = get_string('invalidurl', 'scorm');
412 } else {
413 // Availability check.
414 $result = scorm_check_url($reference);
415 if (is_string($result)) {
416 $errors['packageurl'] = $result;
420 } else if ($type === SCORM_TYPE_AICCURL) {
421 $reference = $data['packageurl'];
422 // Syntax check.
423 if (!preg_match('/(http:\/\/|https:\/\/|www).*/', $reference)) {
424 $errors['packageurl'] = get_string('invalidurl', 'scorm');
425 } else {
426 // Availability check.
427 $result = scorm_check_url($reference);
428 if (is_string($result)) {
429 $errors['packageurl'] = $result;
435 return $errors;
438 // Need to translate the "options" and "reference" field.
439 public function set_data($defaultvalues) {
440 $defaultvalues = (array)$defaultvalues;
442 if (isset($defaultvalues['scormtype']) and isset($defaultvalues['reference'])) {
443 switch ($defaultvalues['scormtype']) {
444 case SCORM_TYPE_LOCALSYNC :
445 case SCORM_TYPE_EXTERNAL:
446 case SCORM_TYPE_AICCURL:
447 $defaultvalues['packageurl'] = $defaultvalues['reference'];
450 unset($defaultvalues['reference']);
452 if (!empty($defaultvalues['options'])) {
453 $options = explode(',', $defaultvalues['options']);
454 foreach ($options as $option) {
455 $opt = explode('=', $option);
456 if (isset($opt[1])) {
457 $defaultvalues[$opt[0]] = $opt[1];
462 $this->data_preprocessing($defaultvalues);
463 parent::set_data($defaultvalues);
466 public function add_completion_rules() {
467 $mform =& $this->_form;
468 $items = array();
470 // Require score.
471 $group = array();
472 $group[] =& $mform->createElement('text', 'completionscorerequired', '', array('size' => 5));
473 $group[] =& $mform->createElement('checkbox', 'completionscoredisabled', null, get_string('disable'));
474 $mform->setType('completionscorerequired', PARAM_INT);
475 $mform->addGroup($group, 'completionscoregroup', get_string('completionscorerequired', 'scorm'), '', false);
476 $mform->addHelpButton('completionscoregroup', 'completionscorerequired', 'scorm');
477 $mform->disabledIf('completionscorerequired', 'completionscoredisabled', 'checked');
478 $mform->setDefault('completionscorerequired', 0);
480 $items[] = 'completionscoregroup';
483 // Require status.
484 $first = true;
485 $firstkey = null;
486 foreach (scorm_status_options(true) as $key => $value) {
487 $name = null;
488 $key = 'completionstatusrequired['.$key.']';
489 if ($first) {
490 $name = get_string('completionstatusrequired', 'scorm');
491 $first = false;
492 $firstkey = $key;
494 $mform->addElement('checkbox', $key, $name, $value);
495 $mform->setType($key, PARAM_BOOL);
496 $items[] = $key;
498 $mform->addHelpButton($firstkey, 'completionstatusrequired', 'scorm');
500 return $items;
503 function completion_rule_enabled($data) {
504 $status = !empty($data['completionstatusrequired']);
505 $score = empty($data['completionscoredisabled']) && strlen($data['completionscorerequired']);
507 return $status || $score;
510 function get_data($slashed = true) {
511 $data = parent::get_data($slashed);
513 if (!$data) {
514 return false;
517 // Convert completionstatusrequired to a proper integer, if any.
518 $total = 0;
519 if (isset($data->completionstatusrequired) && is_array($data->completionstatusrequired)) {
520 foreach (array_keys($data->completionstatusrequired) as $state) {
521 $total |= $state;
523 $data->completionstatusrequired = $total;
526 if (!empty($data->completionunlocked)) {
527 // Turn off completion settings if the checkboxes aren't ticked.
528 $autocompletion = isset($data->completion) && $data->completion == COMPLETION_TRACKING_AUTOMATIC;
530 if (isset($data->completionstatusrequired) && $autocompletion) {
531 // Do nothing: completionstatusrequired has been already converted
532 // into a correct integer representation.
533 } else {
534 $data->completionstatusrequired = null;
537 if (!empty($data->completionscoredisabled) || !$autocompletion) {
538 $data->completionscorerequired = null;
542 return $data;