HEX
Server: Apache
System: Linux webm010.cluster103.gra.hosting.ovh.net 6.18.42-ovh-vps-grsec-zfs+ #1 SMP PREEMPT_DYNAMIC Wed Aug 5 15:59:48 CEST 2026 x86_64
User: iestorre (46869)
PHP: 8.0.30
Disabled: _dyuweyrj4,_dyuweyrj4r,dl
Upload Files
File: /home/iestorre/moodleAW/moodle04/backup/cc/cc_lib/cc_version1.php
<?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/>.

/**
* @package    backup-convert
* @subpackage cc-library
* @copyright  2011 Darko Miletic <dmiletic@moodlerooms.com>
* @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/

require_once 'cc_utils.php';
require_once 'cc_version_base.php';
require_once 'cc_organization.php';


/**
 * Version 1 class of Common Cartridge
 *
 */
class cc_version1 extends cc_version_base {
    const   webcontent          = 'webcontent';
    const   questionbank        = 'imsqti_xmlv1p2/imscc_xmlv1p0/question-bank';
    const   assessment          = 'imsqti_xmlv1p2/imscc_xmlv1p0/assessment';
    const   associatedcontent   = 'associatedcontent/imscc_xmlv1p0/learning-application-resource';
    const   discussiontopic     = 'imsdt_xmlv1p0';
    const   weblink             = 'imswl_xmlv1p0';

    public static $checker = array(self::webcontent,
                                   self::assessment,
                                   self::associatedcontent,
                                   self::discussiontopic,
                                   self::questionbank,
                                   self::weblink);

    /**
    * Validate if the type are valid or not
    *
    * @param string $type
    * @return bool
    */
    public function valid($type) {
        return in_array($type, self::$checker);
    }

    public function __construct() {
        $this->ccnamespaces     = array('imscc'    => 'http://www.imsglobal.org/xsd/imscc/imscp_v1p1',
                                        'lomimscc' => 'http://ltsc.ieee.org/xsd/imscc/LOM',
                                        'lom'      => 'http://ltsc.ieee.org/xsd/LOM',
                                        'voc'      => 'http://ltsc.ieee.org/xsd/LOM/vocab',
                                        'xsi'      => 'http://www.w3.org/2001/XMLSchema-instance'
                                        );

        $this->ccnsnames        = array('imscc'    => 'http://www.imsglobal.org/profile/cc/ccv1p0/derived_schema/imscp_v1p2_localised.xsd' ,
                                        'lom'      => 'http://www.imsglobal.org/profile/cc/ccv1p0/derived_schema/domainProfile_2/lomLoose_localised.xsd' ,
                                        'lomimscc' => 'http://www.imsglobal.org/profile/cc/ccv1p0/derived_schema/domainProfile_1/lomLoose_localised.xsd',
                                        'voc'      => 'http://www.imsglobal.org/profile/cc/ccv1p0/derived_schema/domainProfile_2/vocab/loose.xsd'
                                        );

        $this->ccversion        = '1.0.0';
        $this->camversion       = '1.0.0';
        $this->_generator       = 'Moodle 2 Common Cartridge generator';
    }

    protected function on_create(DOMDocument &$doc, $rootmanifestnode=null,$nmanifestID=null) {
      $doc->formatOutput        = true;
      $doc->preserveWhiteSpace  = true;


      $this->manifestID = is_null($nmanifestID) ? cc_helpers::uuidgen('M_') : $nmanifestID;
      $mUUID = $doc->createAttribute('identifier');
      $mUUID->nodeValue = $this->manifestID;


      if (is_null($rootmanifestnode)) {
          if (!empty($this->_generator)) {
              $comment = $doc->createComment($this->_generator);
              $doc->appendChild($comment);
          }

          $rootel = $doc->createElementNS($this->ccnamespaces['imscc'],'manifest');
          $rootel->appendChild($mUUID);
          $doc->appendChild($rootel);

          //add all namespaces
          foreach ($this->ccnamespaces as $key => $value) {
                if ($key != 'lom' ){
                    $dummy_attr = $key.":dummy";
                    $doc->createAttributeNS($value,$dummy_attr);
                }
          }

          // add location of schemas
          $schemaLocation='';
          foreach ($this->ccnsnames as $key => $value) {
              $vt = empty($schemaLocation) ? '' : ' ';
              $schemaLocation .= $vt.$this->ccnamespaces[$key].' '.$value;
          }
          $aSchemaLoc = $doc->createAttributeNS($this->ccnamespaces['xsi'],'xsi:schemaLocation');
          $aSchemaLoc->nodeValue=$schemaLocation;
          $rootel->appendChild($aSchemaLoc);

      } else {
          $rootel = $doc->createElementNS($this->ccnamespaces['imscc'],'imscc:manifest');
          $rootel->appendChild($mUUID);
      }

      $metadata = $doc->createElementNS($this->ccnamespaces['imscc'],'metadata');
      $schema = $doc->createElementNS($this->ccnamespaces['imscc'],'schema','IMS Common Cartridge');
      $schemaversion = $doc->createElementNS($this->ccnamespaces['imscc'],'schemaversion',$this->ccversion);

      $metadata->appendChild($schema);
      $metadata->appendChild($schemaversion);
      $rootel->appendChild($metadata);

      if (!is_null($rootmanifestnode)) {
          $rootmanifestnode->appendChild($rootel);
      }

      $organizations = $doc->createElementNS($this->ccnamespaces['imscc'],'organizations');
      $rootel->appendChild($organizations);
      $resources = $doc->createElementNS($this->ccnamespaces['imscc'],'resources');
      $rootel->appendChild($resources);

      return true;
    }


    protected function update_attribute(DOMDocument &$doc, $attrname, $attrvalue, DOMElement &$node) {
        $busenew = (is_object($node) && $node->hasAttribute($attrname));
        $nResult = null;
        if (!$busenew && is_null($attrvalue)) {
            $node->removeAttribute($attrname);
        } else {
            $nResult = $busenew ? $node->getAttributeNode($attrname) : $doc->createAttribute($attrname);
            $nResult->nodeValue = $attrvalue;
            if (!$busenew) {
                $node->appendChild($nResult);
            }
        }
        return $nResult;
    }


    protected function update_attribute_ns(DOMDocument &$doc, $attrname, $attrnamespace,$attrvalue, DOMElement &$node) {
        $busenew = (is_object($node) && $node->hasAttributeNS($attrnamespace, $attrname));
        $nResult = null;
        if (!$busenew && is_null($attrvalue)) {
            $node->removeAttributeNS($attrnamespace, $attrname);
        } else {
            $nResult = $busenew ? $node->getAttributeNodeNS($attrnamespace, $attrname) : $doc->createAttributeNS($attrnamespace, $attrname);
            $nResult->nodeValue = $attrvalue;
            if (!$busenew) {
                $node->appendChild($nResult);
            }
        }
        return $nResult;
    }


    protected function get_child_node(DOMDocument &$doc, $itemname, DOMElement &$node) {
        $nlist = $node->getElementsByTagName($itemname);
        $item = is_object($nlist) && ($nlist->length > 0) ? $nlist->item(0) : null;
        return $item;
    }


    protected function update_child_item(DOMDocument &$doc, $itemname, $itemvalue, DOMElement &$node, $attrtostore=null) {
        $tnode = $this->get_child_node($doc,'title',$node);
        $usenew = is_null($tnode);
        $tnode = $usenew ? $doc->createElementNS($this->ccnamespaces['imscc'], $itemname) : $tnode;
        if (!is_null($attrtostore)) {
            foreach ($attrtostore as $key => $value) {
                $this->update_attribute($doc,$key,$value,$tnode);
            }
        }
        $tnode->nodeValue = $itemvalue;
        if ($usenew) {
            $node->appendChild($tnode);
        }
    }


    protected function update_items($items, DOMDocument &$doc, DOMElement &$xmlnode) {
        foreach ($items as $key => $item) {
            $itemnode = $doc->createElementNS($this->ccnamespaces['imscc'], 'item');
            $this->update_attribute($doc, 'identifier'   , $key                , $itemnode);
            $this->update_attribute($doc, 'identifierref', $item->identifierref, $itemnode);
            $this->update_attribute($doc, 'parameters'   , $item->parameters   , $itemnode);
            if (!empty($item->title)) {
                $titlenode = $doc->createElementNS($this->ccnamespaces['imscc'],
                                                   'title',
                                                   $item->title);
                $itemnode->appendChild($titlenode);
            }
            if ($item->has_child_items()) {
                $this->update_items($item->childitems, $doc, $itemnode);
            }
            $xmlnode->appendChild($itemnode);
        }
    }


    /**
     * Create a Resource (How to)
     *
     * @param cc_i_resource $res
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_resource(cc_i_resource &$res, DOMDocument &$doc, $xmlnode=null) {
        $usenew = is_object($xmlnode);
        $dnode  = $usenew ? $xmlnode : $doc->createElementNS($this->ccnamespaces['imscc'], "resource");
        $this->update_attribute($doc,'identifier',$res->identifier,$dnode);
        $this->update_attribute($doc,'type'      ,$res->type      ,$dnode);
        !is_null($res->href) ? $this->update_attribute($doc,'href',$res->href,$dnode): null;
        $this->update_attribute($doc,'base'      ,$res->base      ,$dnode);

        foreach ($res->files as $file) {
            $nd = $doc->createElementNS($this->ccnamespaces['imscc'],'file');
            $ndatt = $doc->createAttribute('href');
            $ndatt->nodeValue = $file;
            $nd->appendChild($ndatt);
            $dnode->appendChild($nd);
        }
        $this->resources[$res->identifier]  = $res;

        foreach ($res->dependency as $dependency){
            $nd = $doc->createElementNS($this->ccnamespaces['imscc'],'dependency');
            $ndatt = $doc->createAttribute('identifierref');
            $ndatt->nodeValue = $dependency;
            $nd->appendChild($ndatt);
            $dnode->appendChild($nd);
        }

        return $dnode;
    }



    /**
     * Create an Item Folder (How To)
     *
     * @param cc_i_organization $org
     * @param DOMDocument $doc
     * @param DOMElement $xmlnode
     */
    protected function create_item_folder (cc_i_organization &$org, DOMDocument &$doc, DOMElement &$xmlnode=null){

            $itemfoldernode = $doc->createElementNS($this->ccnamespaces['imscc'],'item');
            $this->update_attribute($doc,'identifier', "root", $itemfoldernode);

            if ($org->has_items()) {
                $this->update_items($org->itemlist, $doc, $itemfoldernode);
            }
            if (is_null($this->organizations)) {
                $this->organizations = array();
            }
            $this->organizations[$org->identifier]  = $org;

            $xmlnode->appendChild($itemfoldernode);
    }




    /**
     * Create an Organization (How To)
     *
     * @param cc_i_organization $org
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_organization (cc_i_organization &$org, DOMDocument &$doc, $xmlnode=null){

        $usenew = is_object($xmlnode);
        $dnode  = $usenew ? $xmlnode : $doc->createElementNS($this->ccnamespaces['imscc'], "organization");
        $this->update_attribute($doc,'identifier' ,$org->identifier,$dnode);
        $this->update_attribute($doc,'structure'  ,$org->structure ,$dnode);

        $this->create_item_folder($org,$doc,$dnode);

        return $dnode;
    }




    /**
     * Create Metadata For Manifest (How To)
     *
     * @param cc_i_metadata_manifest $met
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_manifest (cc_i_metadata_manifest $met,DOMDocument &$doc,$xmlnode=null) {

        $dnode  =  $doc->createElementNS($this->ccnamespaces['lomimscc'], "lom");
        if (!empty($xmlnode)) {
            $xmlnode->appendChild($dnode);
        }
        $dnodegeneral   = empty($met->arraygeneral  ) ? null : $this->create_metadata_general  ($met, $doc, $xmlnode);
        $dnodetechnical = empty($met->arraytech     ) ? null : $this->create_metadata_technical($met, $doc, $xmlnode);
        $dnoderights    = empty($met->arrayrights   ) ? null : $this->create_metadata_rights   ($met, $doc, $xmlnode);
        $dnodelifecycle = empty($met->arraylifecycle) ? null : $this->create_metadata_lifecycle($met, $doc, $xmlnode);

        !is_null($dnodegeneral)?$dnode->appendChild($dnodegeneral):null;
        !is_null($dnodetechnical)?$dnode->appendChild($dnodetechnical):null;
        !is_null($dnoderights)?$dnode->appendChild($dnoderights):null;
        !is_null($dnodelifecycle)?$dnode->appendChild($dnodelifecycle):null;

        return $dnode;

    }



    /**
     * Create Metadata For Resource (How To)
     *
     * @param cc_i_metadata_resource $met
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_resource (cc_i_metadata_resource $met,DOMDocument &$doc,$xmlnode=null) {

        $dnode = $doc->createElementNS($this->ccnamespaces['lom'], "lom");

        !empty($xmlnode)? $xmlnode->appendChild($dnode):null;
        !empty($met->arrayeducational) ? $this->create_metadata_educational($met,$doc,$dnode):null;

        return $dnode;
    }




    /**
     * Create Metadata For File (How To)
     *
     * @param cc_i_metadata_file $met
     * @param DOMDocument $doc
     * @param Object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_file (cc_i_metadata_file $met,DOMDocument &$doc,$xmlnode=null) {

        $dnode = $doc->createElementNS($this->ccnamespaces['lom'], "lom");

        !empty($xmlnode)? $xmlnode->appendChild($dnode):null;
        !empty($met->arrayeducational) ? $this->create_metadata_educational($met,$doc,$dnode):null;

        return $dnode;
    }




    /**
     * Create General Metadata (How To)
     *
     * @param object $met
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_general($met,DOMDocument &$doc,$xmlnode){
        ($xmlnode);
        $nd = $doc->createElementNS($this->ccnamespaces['lomimscc'],'general');

        foreach ($met->arraygeneral as $name => $value) {
            !is_array($value)?$value =array($value):null;
            foreach ($value as $k => $v){
                ($k);
                if ($name != 'language' && $name != 'catalog' && $name != 'entry'){
                    $nd2 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name);
                    $nd3 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'string',$v[1]);
                    $ndatt = $doc->createAttribute('language');
                    $ndatt->nodeValue = $v[0];
                    $nd3->appendChild($ndatt);
                    $nd2->appendChild($nd3);
                    $nd->appendChild($nd2);
                }else{
                    if ($name == 'language'){
                        $nd2 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name,$v[0]);
                        $nd->appendChild($nd2);
                    }
                }
            }
        }
        if (!empty($met->arraygeneral['catalog']) || !empty($met->arraygeneral['entry'])){
            $nd2 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'identifier');
            $nd->appendChild($nd2);
            if (!empty($met->arraygeneral['catalog'])){
                $nd3 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'catalog',$met->arraygeneral['catalog'][0][0]);
                $nd2->appendChild($nd3);
            }
            if (!empty($met->arraygeneral['entry'])){
                $nd4 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'entry',$met->arraygeneral['entry'][0][0]);
                $nd2->appendChild($nd4);
            }
        }
        return $nd;
    }




    /**
     * Create Technical Metadata (How To)
     *
     * @param object $met
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_technical($met,DOMDocument &$doc,$xmlnode){
        ($xmlnode);
        $nd = $doc->createElementNS($this->ccnamespaces['lomimscc'],'technical');
        $xmlnode->appendChild($nd);

        foreach ($met->arraytech as $name => $value) {
            ($name);
            !is_array($value)?$value =array($value):null;
            foreach ($value as $k => $v){
                ($k);
                    $nd2 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name,$v[0]);
                    $nd->appendChild($nd2);
            }
        }
        return $nd;
    }




    /**
     * Create Rights Metadata (How To)
     *
     * @param object $met
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_rights($met,DOMDocument &$doc,$xmlnode){
        ($xmlnode);

        $nd = $doc->createElementNS($this->ccnamespaces['lomimscc'],'rights');

        foreach ($met->arrayrights as $name => $value) {
            !is_array($value)?$value =array($value):null;
            foreach ($value as $k => $v){
                ($k);
                if ($name == 'description'){
                    $nd2 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name);
                    $nd3 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'string',$v[1]);
                    $ndatt = $doc->createAttribute('language');
                    $ndatt->nodeValue = $v[0];
                    $nd3->appendChild($ndatt);
                    $nd2->appendChild($nd3);
                    $nd->appendChild($nd2);
                }elseif ($name == 'copyrightAndOtherRestrictions' || $name == 'cost'){
                    $nd2 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name);
                    $nd3 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'value',$v[0]);
                    $nd2->appendChild($nd3);
                    $nd->appendChild($nd2);
                }
            }
        }
        return $nd;
    }




    /**
     * Create LifeCyle Metadata (How To)
     *
     * @param object $met
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_lifecycle($met,DOMDocument &$doc,$xmlnode){
        ($xmlnode);

        $nd = $doc->createElementNS($this->ccnamespaces['lomimscc'],'lifeCycle');
        $nd2= $doc->createElementNS($this->ccnamespaces['lomimscc'],'contribute');


        $nd->appendChild ($nd2);
        $xmlnode->appendChild ($nd);

        foreach ($met->arraylifecycle as $name => $value) {
            !is_array($value)?$value =array($value):null;
            foreach ($value as $k => $v){
                ($k);
                if ($name == 'role'){
                    $nd3 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name);
                    $nd2->appendChild($nd3);
                    $nd4 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'value',$v[0]);
                    $nd3->appendChild($nd4);
                }else{
                    if ($name == 'date'){
                        $nd3 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name);
                        $nd2->appendChild($nd3);
                        $nd4 = $doc->createElementNS($this->ccnamespaces['lomimscc'],'dateTime',$v[0]);
                        $nd3->appendChild($nd4);
                    }else{
                        $nd3 = $doc->createElementNS($this->ccnamespaces['lomimscc'],$name,$v[0]);
                        $nd2->appendChild($nd3);
                    }
                }
            }
        }
        return $nd;
    }




    /**
     * Create Education Metadata (How To)
     *
     * @param object $met
     * @param DOMDocument $doc
     * @param object $xmlnode
     * @return DOMNode
     */
    protected function create_metadata_educational ($met,DOMDocument  &$doc, $xmlnode){
        $nd = $doc->createElementNS($this->ccnamespaces['lom'],'educational');
        $nd2 = $doc->createElementNS($this->ccnamespaces['lom'],'intendedEndUserRole');
        $nd3 = $doc->createElementNS($this->ccnamespaces['voc'],'vocabulary');

        $xmlnode->appendChild($nd);
        $nd->appendChild($nd2);
        $nd2->appendChild($nd3);

        foreach ($met->arrayeducational as $name => $value) {
            !is_array($value)?$value =array($value):null;
            foreach ($value as $k => $v){
                ($k);
                $nd4 = $doc->createElementNS($this->ccnamespaces['voc'],$name,$v[0]);
                $nd3->appendChild($nd4);
            }
        }
        return $nd;
    }

}