elements in an imsmanifest file * @package dokeos.learnpath.scorm * @author Yannick Warnier */ /** * This class handles the elements from an imsmanifest file. */ require_once('learnpathItem.class.php'); class scormItem extends learnpathItem{ var $identifier = ''; var $identifierref = ''; var $isvisible = ''; var $parameters = ''; var $title = ''; var $sub_items = array(); var $metadata; //var $prerequisites = ''; - defined in learnpathItem.class.php // Modified by Ivan Tcholakov, 06-FEB-2010. //var $max_time_allowed = ''; //should be something like HHHH:MM:SS.SS var $max_time_allowed = '00:00:00'; // var $timelimitaction = ''; var $datafromlms = ''; var $mastery_score = ''; var $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 of construction needed ('db' or 'manifest', default = 'manifest') * @param mixed Depending on the type given, DB id for the lp_item or reference to the DOM element */ function scormItem($type='manifest',&$element) { if(isset($element)) { $v = substr(phpversion(),0,1); if($v == 4){ switch($type){ case 'db': parent::learnpathItem($element,api_get_user_id()); $this->scorm_contact = false; //TODO implement this way of metadata object creation return false; 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->children(); foreach($children as $a => $dummy) { $child =& $children[$a]; switch($child->type) { case XML_ELEMENT_NODE: switch($child->tagname){ case 'title': $tmp_children = $child->children(); if(count($tmp_children)==1 and $tmp_children[0]->content!='' ) { $this->title = $tmp_children[0]->content; } break; case 'maxtimeallowed': $tmp_children = $child->children(); if(count($tmp_children)==1 and $tmp_children[0]->content!='' ) { $this->max_time_allowed = $tmp_children[0]->content; } break; case 'prerequisites': $tmp_children = $child->children(); if(count($tmp_children)==1 and $tmp_children[0]->content!='' ) { $this->prereq_string = $tmp_children[0]->content; } break; case 'timelimitaction': $tmp_children = $child->children(); if(count($tmp_children)==1 and $tmp_children[0]->content!='' ) { $this->timelimitaction = $tmp_children[0]->content; } break; case 'datafromlms': $tmp_children = $child->children(); if(count($tmp_children)==1 and $tmp_children[0]->content!='' ) { $this->datafromlms = $tmp_children[0]->content; } break; case 'masteryscore': $tmp_children = $child->children(); if(count($tmp_children)==1 and $tmp_children[0]->content!='' ) { $this->mastery_score = $tmp_children[0]->content; } 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; } } $attributes = $element->attributes(); //$keep_href = ''; foreach($attributes as $a1 => $dummy) { $attrib =& $attributes[$a1]; 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; } } return true; } }elseif($v == 5){ //parsing using PHP5 DOMXML methods switch($type){ case 'db': parent::learnpathItem($element,api_get_user_id()); $this->scorm_contact = false; //TODO implement this way of metadata object creation return false; 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(count($tmp_children)==1 and $tmp_children[0]->textContent!='' ) if($tmp_children->length==1 and $child->firstChild->nodeValue!='' ) { $this->title = $child->firstChild->nodeValue; } break; case 'max_score': if($tmp_children->length==1 and $child->firstChild->nodeValue!='' ) { $this->max_score = $child->firstChild->nodeValue; } break; case 'maxtimeallowed': case 'adlcp:maxtimeallowed': $tmp_children = $child->childNodes; //if(count($tmp_children)==1 and $tmp_children[0]->textContent!='' ) if($tmp_children->length==1 and $child->firstChild->nodeValue!='' ) { $this->max_time_allowed = $child->firstChild->nodeValue; } break; case 'prerequisites': case 'adlcp:prerequisites': $tmp_children = $child->childNodes; //if(count($tmp_children)==1 and $tmp_children[0]->textContent!='' ) if($tmp_children->length==1 and $child->firstChild->nodeValue!='' ) { $this->prereq_string = $child->firstChild->nodeValue; } break; case 'timelimitaction': case 'adlcp:timelimitaction': $tmp_children = $child->childNodes; //if(count($tmp_children)==1 and $tmp_children[0]->textContent!='' ) if($tmp_children->length==1 and $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(count($tmp_children)==1 and $tmp_children[0]->textContent!='' ) if($tmp_children->length==1 and $child->firstChild->nodeValue!='' ) { $this->datafromlms = $child->firstChild->nodeValue; } break; case 'masteryscore': case 'adlcp:masteryscore': $tmp_children = $child->childNodes; //if(count($tmp_children)==1 and $tmp_children[0]->textContent!='' ) if($tmp_children->length==1 and $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; } } } return true; } }else{ //cannot parse because not PHP4 nor PHP5... We should not even be here anyway... return false; } } return false; } /** * 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 integer Optional absolute order (pointer) of the item in this learning path * @param integer Optional relative order of the item at this level * @param integer Optional level. If not given, assumes it's level 0 */ function get_flat_list(&$list,&$abs_order,$rel_order=1,$level=0) { $list[] = array( '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 boolean Save from URL params (1) or from object attributes (0) */ 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); } } } ?>