elements from an imsmanifest file. * Container for the scormItem class that deals with elements in an imsmanifest file. * * @package chamilo.learnpath.scorm * * @author Yannick Warnier */ class scormItem extends learnpathItem { public $identifier = ''; public $identifierref = ''; public $isvisible = ''; public $parameters = ''; public $title = ''; public $sub_items = []; public $metadata; //public $prerequisites = ''; - defined in learnpathItem.class.php // Modified by Ivan Tcholakov, 06-FEB-2010. //public $max_time_allowed = ''; //should be something like HHHH:MM:SS.SS public $max_time_allowed = '00:00:00'; public $timelimitaction = ''; public $datafromlms = ''; public $mastery_score = ''; public $scorm_contact; /** * Class constructor. Depending of the type of construction called ('db' or 'manifest'), will create a scormItem * object from database records or from the DOM element given as parameter. * * @param string $type Type of construction needed ('db' or 'manifest', default = 'manifest') * @param mixed $element Depending on the type given, DB id for the lp_item or reference to the DOM element * @param int $course_id */ public function __construct($type = 'manifest', &$element, $course_id = 0) { if (isset($element)) { // Parsing using PHP5 DOMXML methods. switch ($type) { case 'db': parent::__construct($element, api_get_user_id(), $course_id); $this->scorm_contact = false; // TODO: Implement this way of metadata object creation. break; case 'manifest': // Do the same as the default. default: //if ($first_item->type == XML_ELEMENT_NODE) this is already check prior to the call to this function. $children = $element->childNodes; foreach ($children as $child) { switch ($child->nodeType) { case XML_ELEMENT_NODE: switch ($child->tagName) { case 'title': $tmp_children = $child->childNodes; if ($tmp_children->length == 1 && $child->firstChild->nodeValue != '') { $this->title = $child->firstChild->nodeValue; } break; case 'max_score': if ($tmp_children->length == 1 && $child->firstChild->nodeValue != '') { $this->max_score = $child->firstChild->nodeValue; } break; case 'maxtimeallowed': case 'adlcp:maxtimeallowed': $tmp_children = $child->childNodes; if ($tmp_children->length == 1 && $child->firstChild->nodeValue != '') { $this->max_time_allowed = $child->firstChild->nodeValue; } break; case 'prerequisites': case 'adlcp:prerequisites': $tmp_children = $child->childNodes; if ($tmp_children->length == 1 && $child->firstChild->nodeValue != '') { $this->prereq_string = $child->firstChild->nodeValue; } break; case 'timelimitaction': case 'adlcp:timelimitaction': $tmp_children = $child->childNodes; if ($tmp_children->length == 1 && $child->firstChild->nodeValue != '') { $this->timelimitaction = $child->firstChild->nodeValue; } break; case 'datafromlms': case 'adlcp:datafromlms': case 'adlcp:launchdata': //in some cases (Wouters) $tmp_children = $child->childNodes; if ($tmp_children->length == 1 && $child->firstChild->nodeValue != '') { $this->datafromlms = $child->firstChild->nodeValue; } break; case 'masteryscore': case 'adlcp:masteryscore': $tmp_children = $child->childNodes; if ($tmp_children->length == 1 && $child->firstChild->nodeValue != '') { $this->mastery_score = $child->firstChild->nodeValue; } break; case 'item': $oItem = new scormItem('manifest', $child); if ($oItem->identifier != '') { $this->sub_items[$oItem->identifier] = $oItem; } break; case 'metadata': $this->metadata = new scormMetadata('manifest', $child); break; } break; case XML_TEXT_NODE: // This case is actually treated by looking into ELEMENT_NODEs above. break; } } if ($element->hasAttributes()) { $attributes = $element->attributes; //$keep_href = ''; foreach ($attributes as $attrib) { switch ($attrib->name) { case 'identifier': $this->identifier = $attrib->value; break; case 'identifierref': $this->identifierref = $attrib->value; break; case 'isvisible': $this->isvisible = $attrib->value; break; case 'parameters': $this->parameters = $attrib->value; break; } } } } // End parsing using PHP5 DOMXML methods. } } /** * Builds a flat list with the current item and calls itself recursively on all children. * * @param array Reference to the array to complete with the current item * @param int Optional absolute order (pointer) of the item in this learning path * @param int Optional relative order of the item at this level * @param int Optional level. If not given, assumes it's level 0 */ public function get_flat_list(&$list, &$abs_order, $rel_order = 1, $level = 0) { $list[] = [ 'abs_order' => $abs_order, 'datafromlms' => $this->datafromlms, 'identifier' => $this->identifier, 'identifierref' => $this->identifierref, 'isvisible' => $this->isvisible, 'level' => $level, 'masteryscore' => $this->mastery_score, 'maxtimeallowed' => $this->max_time_allowed, 'metadata' => $this->metadata, 'parameters' => $this->parameters, 'prerequisites' => (!empty($this->prereq_string) ? $this->prereq_string : ''), 'rel_order' => $rel_order, 'timelimitaction' => $this->timelimitaction, 'title' => $this->title, 'max_score' => $this->max_score, ]; $abs_order++; $i = 1; foreach ($this->sub_items as $id => $dummy) { $oSubitem = &$this->sub_items[$id]; $oSubitem->get_flat_list($list, $abs_order, $i, $level + 1); $i++; } } /** * Save function. Uses the parent save function and adds a layer for SCORM. * * @param bool Save from URL params (1) or from object attributes (0) */ public function save($from_outside = true, $prereqs_complete = false) { parent::save($from_outside, $prereqs_complete); // Under certain conditions, the scorm_contact should not be set, because no scorm signal was sent. $this->scorm_contact = true; if (!$this->scorm_contact) { //error_log('New LP - was expecting SCORM message but none received', 0); } } }