Description of class. More...

Collaboration diagram for ilECSCmsTreeSynchronizer:

Public Member Functions
	__construct (ilECSSetting $server, $mid, $tree_id)
	Constructor. More...

	getServer ()
	Get server. More...

	getTree ()

	getDefaultSettings ()
	Get default settings. More...

	getGlobalSettings ()
	get global settings More...

	sync ()
	Synchronize tree. More...

Protected Member Functions
	checkTreeUpdates ($a_root_obj_id)
	Start tree update check. More...

	handleTreeUpdate ($a_parent_ref_id, $a_tnode_id)
	Handle tree update (recursively) More...

	syncNode ($tree_obj_id, $parent_id, $a_mapped=false)
	Sync node. More...

	syncCategory (ilECSNodeMappingAssignment $ass, $parent_id)
	Sync category. More...

Private Attributes
	$server = null

	$mid = null

	$tree_id = null

	$tree = null

	$default_settings = array()

	$global_settings = null

Detailed Description

Description of class.

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Definition at line 15 of file class.ilECSCmsTreeSynchronizer.php.

Constructor & Destructor Documentation

◆ __construct()

ilECSCmsTreeSynchronizer::__construct	(	ilECSSetting	$server,
			$mid,
			$tree_id
	)

Constructor.

Definition at line 29 of file class.ilECSCmsTreeSynchronizer.php.

        {
                $this->server = $server;
                $this->mid = $mid;
                $this->tree = new ilECSCmsTree($tree_id);
                $this->tree_id = $tree_id;
                
                include_once './Services/WebServices/ECS/classes/Mapping/class.ilECSNodeMappingSettings.php';
                $this->global_settings = ilECSNodeMappingSettings::getInstanceByServerMid($this->getServer()->getServerId(),$this->mid);
        }

References $mid, $server, $tree_id, ilECSNodeMappingSettings\getInstanceByServerMid(), and getServer().

Here is the call graph for this function:

Member Function Documentation

◆ checkTreeUpdates()

ilECSCmsTreeSynchronizer::checkTreeUpdates ( $a_root_obj_id )

protected

Start tree update check.

Parameters

type $a_root_obj_id

Returns: bool

Definition at line 113 of file class.ilECSCmsTreeSynchronizer.php.

        {
                if($this->default_settings['tree_update'] == false)
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': Tree update disabled for tree with id '. $this->getTree()->getTreeId());
                        return false;
                }
                
                // Start recursion
                include_once './Services/WebServices/ECS/classes/Mapping/class.ilECSNodeMappingAssignment.php';
                $mapping = new ilECSNodeMappingAssignment(
                                $this->getServer()->getServerId(),
                                $this->mid,
                                $this->tree_id,
                                $a_root_obj_id
                );
                $a_root_ref_id = $mapping->getRefId();
                if($a_root_ref_id)
                {
                        $this->handleTreeUpdate($a_root_ref_id, $a_root_obj_id);
                }
        }

References $GLOBALS, getServer(), and handleTreeUpdate().

Referenced by sync().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDefaultSettings()

ilECSCmsTreeSynchronizer::getDefaultSettings ( )

Get default settings.

Returns: type

Definition at line 61 of file class.ilECSCmsTreeSynchronizer.php.

        {
                return (array) $this->default_settings;
        }

References $default_settings.

Referenced by sync().

Here is the caller graph for this function:

◆ getGlobalSettings()

ilECSCmsTreeSynchronizer::getGlobalSettings ( )

get global settings

Returns: ilECSNodeMappingSettings

Definition at line 70 of file class.ilECSCmsTreeSynchronizer.php.

        {
                return $this->global_settings;
        }

References $global_settings.

Referenced by syncCategory().

Here is the caller graph for this function:

◆ getServer()

ilECSCmsTreeSynchronizer::getServer ( )

Get server.

Returns: ilECSSetting

Definition at line 44 of file class.ilECSCmsTreeSynchronizer.php.

        {
                return $this->server;
        }

References $server.

Referenced by __construct(), checkTreeUpdates(), handleTreeUpdate(), sync(), syncCategory(), and syncNode().

Here is the caller graph for this function:

◆ getTree()

ilECSCmsTreeSynchronizer::getTree ( )

Returns: ilECSCmsTree

Definition at line 52 of file class.ilECSCmsTreeSynchronizer.php.

        {
                return $this->tree;
        }

References $tree.

Referenced by handleTreeUpdate(), and syncNode().

Here is the caller graph for this function:

◆ handleTreeUpdate()

ilECSCmsTreeSynchronizer::handleTreeUpdate	(	$a_parent_ref_id,
		$a_tnode_id
	)

protected

Handle tree update (recursively)

Parameters

type	$a_parent_ref_id
type	$tnode_id

Definition at line 141 of file class.ilECSCmsTreeSynchronizer.php.

        {
                global $tree;
                
                // Check if node is already imported at location "parent_ref_id"
                // If not => move it
                $cms_data = new ilECSCmsData($a_tnode_id);
                
                include_once './Services/WebServices/ECS/classes/class.ilECSImport.php';
                $import_obj_id = ilECSImport::lookupObjIdByContentId(
                                $this->getServer()->getServerId(),
                                $this->mid,
                                $cms_data->getCmsId());
                if(!$import_obj_id)
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': cms tree node not imported. tnode_id: '. $a_tnode_id);
                        return false;
                }
                
                $GLOBALS['ilLog']->write(__METHOD__.' parent ref:'.$a_parent_ref_id.' tnode:'. $a_tnode_id);
                $ref_ids = ilObject::_getAllReferences($import_obj_id);
                $import_ref_id = end($ref_ids);
                $import_ref_id_parent = $tree->getParentId($import_ref_id);
                
                if($a_parent_ref_id != $import_ref_id_parent)
                {
                        // move node
                        $GLOBALS['ilLog']->write(__METHOD__.': Moving node '.$a_parent_ref_id.' to '.$import_ref_id);
                        $tree->moveTree($import_ref_id,$a_parent_ref_id);
                }
                
                // iterate through childs
                $childs = $this->getTree()->getChilds($a_tnode_id);
                foreach((array) $childs as $node)
                {
                        $this->handleTreeUpdate($import_ref_id, $node['child']);
                }
                return true;
        }

References $GLOBALS, $tree, ilObject\_getAllReferences(), getServer(), getTree(), handleTreeUpdate(), and ilECSImport\lookupObjIdByContentId().

Referenced by checkTreeUpdates(), and handleTreeUpdate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sync()

ilECSCmsTreeSynchronizer::sync ( )

Synchronize tree.

Returns: boolean

Definition at line 80 of file class.ilECSCmsTreeSynchronizer.php.

        {
                include_once './Services/WebServices/ECS/classes/Mapping/class.ilECSNodeMappingAssignments.php';
                $this->default_settings = ilECSNodeMappingAssignments::lookupSettings(
                        $this->getServer()->getServerId(),
                        $this->mid,
                        $this->tree_id,
                        0
                );
                
                // return if setting is false => no configuration done
                if(!$this->getDefaultSettings())
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': No directory allocation settings. Aborting');
                        return true;
                }
                        
                // lookup obj id of root node
                include_once './Services/WebServices/ECS/classes/Tree/class.ilECSCmsData.php';
                
                $root_obj_id = ilECSCmsTree::lookupRootId($this->tree_id);
                $this->syncNode($root_obj_id,0);
                
                // Tree structure is up to date, now check node movements
                $this->checkTreeUpdates($root_obj_id);
                return true;
        }

References $GLOBALS, checkTreeUpdates(), getDefaultSettings(), getServer(), ilECSCmsTree\lookupRootId(), ilECSNodeMappingAssignments\lookupSettings(), and syncNode().

Here is the call graph for this function:

◆ syncCategory()

ilECSCmsTreeSynchronizer::syncCategory	(	ilECSNodeMappingAssignment	$ass,
			$parent_id
	)

protected

Sync category.

Parameters

ilECSNodeMappingAssignment $ass

Definition at line 228 of file class.ilECSCmsTreeSynchronizer.php.

        {
                include_once './Services/WebServices/ECS/classes/Tree/class.ilECSCmsData.php';
                $data = new ilECSCmsData($ass->getCSId());
 
                // Check if node is imported => create
                // perform title update
                // perform position update
                include_once './Services/WebServices/ECS/classes/class.ilECSImport.php';
                $obj_id = ilECSImport::lookupObjIdByContentId(
                                $this->getServer()->getServerId(),
                                $this->mid,
                                $data->getCmsId());
                if($obj_id)
                {
                        $refs = ilObject::_getAllReferences($obj_id);
                        $ref_id = end($refs);
                        
                        
                        $cat = ilObjectFactory::getInstanceByRefId($ref_id,false);
                        if(($cat instanceof ilObject) and $this->default_settings['title_update'])
                        {
                                $GLOBALS['ilLog']->write(__METHOD__.': Updating cms category ');
                                $GLOBALS['ilLog']->write(__METHOD__.': Title is '. $data->getTitle());
                                $cat->deleteTranslation($GLOBALS['lng']->getDefaultLanguage());
                                $cat->addTranslation(
                                                $data->getTitle(),
                                                $cat->getLongDescription(),
                                                $GLOBALS['lng']->getDefaultLanguage(),
                                                1
                                        );
                                $cat->setTitle($data->getTitle());
                                $cat->update();
                        }
                        else
                        {
                                $GLOBALS['ilLog']->write(__METHOD__.': Updating cms category -> nothing to do');
                        }
                        return $ref_id;
                }
                elseif($this->getGlobalSettings()->isEmptyContainerCreationEnabled())
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': Creating new cms category');
                        
                        // Create category
                        include_once './Modules/Category/classes/class.ilObjCategory.php';
                        $cat = new ilObjCategory();
                        $cat->setTitle($data->getTitle());
                        $cat->create(); // true for upload
                        $cat->createReference();
                        $cat->putInTree($parent_id);
                        $cat->setPermissions($parent_id);
                        $cat->deleteTranslation($GLOBALS['lng']->getDEfaultLanguage());
                        $cat->addTranslation(
                                        $data->getTitle(),
                                        $cat->getLongDescription(),
                                        $GLOBALS['lng']->getDefaultLanguage(),
                                        1
                                );
                        
                        // set imported
                        $import = new ilECSImport(
                                        $this->getServer()->getServerId(),
                                        $cat->getId()
                                );
                        $import->setMID($this->mid);
                        $import->setContentId($data->getCmsId());
                        $import->setImported(true);
                        $import->save();
                        
                        return $cat->getRefId();
                }
                else
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': Creation of empty containers is disabled.');
                        return 0;
                }
        }

References $data, $GLOBALS, $ref_id, ilObject\_getAllReferences(), ilECSNodeMappingAssignment\getCSId(), getGlobalSettings(), ilObjectFactory\getInstanceByRefId(), getServer(), and ilECSImport\lookupObjIdByContentId().

Referenced by syncNode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ syncNode()

ilECSCmsTreeSynchronizer::syncNode	(	$tree_obj_id,
		$parent_id,
		$a_mapped = `false`
	)

protected

Sync node.

Parameters

type	$cs_id
type	$setting

Definition at line 186 of file class.ilECSCmsTreeSynchronizer.php.

        {
                $childs = $this->getTree()->getChilds($tree_obj_id);
                
                $assignment = new ilECSNodeMappingAssignment(
                                $this->getServer()->getServerId(),
                                $this->mid,
                                $this->tree_id,
                                $tree_obj_id);
                
                if($assignment->getRefId())
                {
                        $parent_id = $assignment->getRefId();
                }
                
                // information for deeper levels
                if($assignment->isMapped())
                {
                        $a_mapped = true;
                }
                
                if($a_mapped)
                {
                        $parent_id = $this->syncCategory($assignment,$parent_id);
                }
                
                // this is not necessary
                #if($parent_id)
                {
                        // iterate through childs
                        foreach($childs as $node)
                        {
                                $this->syncNode($node['child'],$parent_id,$a_mapped);
                        }
                }
                return true;
        }