ilStructureObject Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilStructureObject:

Collaboration diagram for ilStructureObject:

Public Member Functions
	__construct (ilObjLearningModule $a_content_obj, int $a_id=0)
	delete (bool $a_delete_meta_data=true)
	copy (ilObjLearningModule $a_target_lm)
	copy chapter More...
	exportXML (ilXmlWriter $a_xml_writer, int $a_inst, ilLog $expLog)
	exportXMLMetaData (ilXmlWriter $a_xml_writer)
	modifyExportIdentifier (string $a_tag, string $a_param, string $a_value)
	exportXMLPageObjects (ilXmlWriter $a_xml_writer, int $a_inst=0)
	exportXMLStructureObjects (ilXmlWriter $a_xml_writer, int $a_inst, ilLog $expLog)
	exportFO (ilXmlWriter $a_xml_writer)
	exportFOPageObjects (ilXmlWriter $a_xml_writer)
Public Member Functions inherited from ilLMObject
	__construct (ilObjLearningModule $a_content_obj, int $a_id=0)
	MDUpdateListener (string $a_element)
	Meta data update listener Important note: Do never call create() or update() method of ilObject here. More...
	createMetaData ()
	create meta data entry More...
	updateMetaData ()
	update meta data entry More...
	deleteMetaData ()
	delete meta data entry More...
	setDataRecord (array $a_record)
	this method should only be called by class ilLMObjectFactory More...
	read ()
	setTitle (string $a_title)
	getTitle ()
	setShortTitle (string $a_title)
	getShortTitle ()
	setDescription (string $a_description)
	getDescription ()
	setType (string $a_type)
	getType ()
	setLMId (int $a_lm_id)
	getLMId ()
	setContentObject (ilObjLearningModule $a_content_obj)
	getContentObject ()
	setId (int $a_id)
	getId ()
	getImportId ()
	setImportId (string $a_id)
	setLayout (string $a_val)
	getLayout ()
	create (bool $a_upload=false)
	update ()
	delete (bool $a_delete_meta_data=true)
	existsExportID (int $a_lm_id, int $a_exp_id, string $a_type="pg")
	Does export ID exist in lm? More...
	getExportIDInfo (int $a_lm_id, int $a_exp_id, string $a_type="pg")

Static Public Member Functions
static	_getPresentationTitle (int $a_st_id, string $a_mode=self::CHAPTER_TITLE, bool $a_include_numbers=false, bool $a_time_scheduled_activation=false, bool $a_force_content=false, int $a_lm_id=0, string $a_lang="-", bool $a_include_short=false)
static	getChapterList (int $a_lm_id)
Static Public Member Functions inherited from ilLMObject
static	_lookupNID (int $a_lm_id, int $a_lm_obj_id, string $a_type)
	lookup named identifier (ILIAS_NID) More...
static	preloadDataByLM (int $a_lm_id)
	Preload data records by lm. More...
static	_lookupTitle (int $a_obj_id)
static	_lookupShortTitle (int $a_obj_id)
static	_lookupType (int $a_obj_id, int $a_lm_id=0)
static	_writeTitle (int $a_obj_id, string $a_title)
static	_writeImportId (int $a_id, string $a_import_id)
static	_writePublicAccessStatus (array $a_pages, int $a_cont_obj_id)
	update public access flags in lm_data for all pages of a content object More...
static	_isPagePublic (int $a_node_id, bool $a_check_public_mode=false)
static	_getIdForImportId (string $a_import_id)
	get current object id for import id (static) More...
static	_getAllObjectsForImportId (string $a_import_id, int $a_in_lm=0)
	Get all items for an import ID. More...
static	_exists (int $a_id)
	checks wether a lm content object with specified id exists or not More...
static	getObjectList (int $lm_id, string $type="")
static	_deleteAllObjectData (ilObjLearningModule $a_cobj)
	delete all objects of content object (digi book / learning module) More...
static	_lookupContObjID (int $a_id)
	get learning module id for lm object More...
static	putInTree (ilLMObject $a_obj, int $a_parent_id=0, int $a_target_node_id=0)
	put this object into content object tree More...
static	getTree (int $a_cont_obj_id)
	Get learning module tree. More...
static	clipboardCut (int $a_cont_obj_id, array $a_ids)
	Copy a set of chapters/pages into the clipboard. More...
static	clipboardCopy (int $a_cont_obj_id, array $a_ids)
	Copy a set of chapters/pages into the clipboard. More...
static	saveTitles (ilObjLearningModule $a_lm, array $a_titles, string $a_lang="-")
	Save titles for lm objects. More...
static	updateInternalLinks (array $a_copied_nodes, string $a_parent_type="lm")
	Update internal links, after multiple pages have been copied. More...
static	uniqueTypesCheck (array $a_items)
	Check for unique types (all pages or all chapters) More...
static	writeLayout (int $a_obj_id, string $a_layout, ?ilObjLearningModule $a_lm=null)
	Write layout setting. More...
static	lookupLayout (int $a_obj_id)
	Lookup type. More...
static	getPagesOfChapter (int $a_lm_id, int $a_chap_id)
	Get pages of chapter. More...
static	_getAllLMObjectsOfLM (int $a_lm_id, string $a_type="")
	Get all objects of learning module. More...
static	saveExportId (int $a_lm_id, int $a_lmobj_id, string $a_exp_id, string $a_type="pg")
static	getExportId (int $a_lm_id, int $a_lmobj_id, string $a_type="pg")
static	getDuplicateExportIDs (int $a_lm_id, string $a_type="pg")
	Get duplicate export IDs (count export ID usages) More...
static	_getNodePresentationTitle (array $a_node, string $a_mode=self::PAGE_TITLE, bool $a_include_numbers=false, bool $a_time_scheduled_activation=false, bool $a_force_content=false, int $a_lm_id=0, string $a_lang="-")
static	getShortTitles (int $a_lm_id, string $a_lang="-")
static	writeShortTitle (int $a_id, string $a_short_title, string $a_lang="-")

Data Fields
string	$origin_id
ilLMTree	$tree
Data Fields inherited from ilLMObject
const	CHAPTER_TITLE = "st_title"
const	PAGE_TITLE = "pg_title"
const	NO_HEADER = "none"
int	$lm_id = 0
string	$type = ""
int	$id = 0
array	$data_record
ilObjLearningModule	$content_object
string	$title = ""
string	$short_title = ""
string	$description = ""
bool	$active = true

Private Member Functions
	delete_rec (ilLMTree $a_tree, bool $a_delete_meta_data=true)
	Delete sub tree. More...

Additional Inherited Members
Static Protected Member Functions inherited from ilLMObject
static	_lookup (int $a_obj_id, string $a_field)
Protected Attributes inherited from ilLMObject
string	$layout = ""
string	$import_id = ""
ilObjUser	$user
ilDBInterface	$db
Static Protected Attributes inherited from ilLMObject
static	$data_records = array()

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Handles StructureObjects of ILIAS Learning Modules (see ILIAS DTD)

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 24 of file class.ilStructureObject.php.

Constructor & Destructor Documentation

__construct()

ilStructureObject::__construct	(	ilObjLearningModule	$a_content_obj,
		int	$a_id = 0
	)

Reimplemented from ilLMObject.

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

      {
        $this->setType("st");
        parent::__construct($a_content_obj, $a_id);
        $this->tree = new ilLMTree($this->getLMId());
    }

References ILIAS\GlobalScreen\Provider\__construct(), ilLMObject\getLMId(), and ilLMObject\setType().

Here is the call graph for this function:

Member Function Documentation

_getPresentationTitle()

static ilStructureObject::_getPresentationTitle ( int  $a_st_id, string  $a_mode = self::CHAPTER_TITLE, bool  $a_include_numbers = false, bool  $a_time_scheduled_activation = false, bool  $a_force_content = false, int  $a_lm_id = 0, string  $a_lang = "-", bool  $a_include_short = false  )

static

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

     : string {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        if ($a_lm_id == 0) {
            $a_lm_id = ilLMObject::_lookupContObjID($a_st_id);
        }
 
        if ($a_lm_id == 0) {
            return "";
        }
 
        // this is optimized when ilLMObject::preloadDataByLM is invoked (e.g. done in ilLMExplorerGUI)
        $title = "";
        if ($a_include_short) {
            $title = trim(ilLMObject::_lookupShortTitle($a_st_id));
        }
        if ($title == "") {
            $title = ilLMObject::_lookupTitle($a_st_id);
        }
 
        // this is also optimized since ilObjectTranslation re-uses instances for one lm
        $ot = ilObjectTranslation::getInstance($a_lm_id);
        $languages = $ot->getLanguages();
 
        if ($a_lang != "-" && $ot->getContentActivated()) {
            $lmobjtrans = new ilLMObjTranslation($a_st_id, $a_lang);
            $trans_title = "";
            if ($a_include_short) {
                $trans_title = trim($lmobjtrans->getShortTitle());
            }
            if ($trans_title == "") {
                $trans_title = $lmobjtrans->getTitle();
            }
            if ($trans_title == "") {
                $lmobjtrans = new ilLMObjTranslation($a_st_id, $ot->getFallbackLanguage());
                $trans_title = $lmobjtrans->getTitle();
            }
            if ($trans_title != "") {
                $title = $trans_title;
            }
        }
 
        $tree = ilLMTree::getInstance($a_lm_id);
 
        $nr = "";
        if ($a_include_numbers) {
            // this is optimized, since isInTree is cached
            if ($tree->isInTree($a_st_id)) {
                // optimization needed from here
 
                // get chapter tree node
                $query = "SELECT * FROM lm_tree WHERE child = " .
                    $ilDB->quote($a_st_id, "integer") . " AND lm_id = " .
                    $ilDB->quote($a_lm_id, "integer");
                $tree_set = $ilDB->query($query);
                $tree_node = $tree_set->fetchRow(ilDBConstants::FETCHMODE_ASSOC);
                $depth = $tree_node["depth"];
 
                $nr = $tree->getChildSequenceNumber($tree_node, "st") . " ";
                for ($i = $depth - 1; $i > 1; $i--) {
                    // get next parent tree node
                    $query = "SELECT * FROM lm_tree WHERE child = " .
                        $ilDB->quote($tree_node["parent"], "integer") . " AND lm_id = " .
                        $ilDB->quote($a_lm_id, "integer");
                    $tree_set = $ilDB->query($query);
                    $tree_node = $tree_set->fetchRow(ilDBConstants::FETCHMODE_ASSOC);
                    $seq = $tree->getChildSequenceNumber($tree_node, "st");
 
                    $nr = $seq . "." . $nr;
                }
            }
        }
 
        return $nr . $title;
    }

References ilLMObject\_lookupContObjID().

Referenced by ilLMTOCExplorerGUI\getNodeContent(), ilLMPresentationGUI\ilLocator(), ilLMPresentationGUI\showPrintView(), ilLMPresentationGUI\showPrintViewSelection(), and ilStructureObjectGUI\subchap().

Here is the call graph for this function:

Here is the caller graph for this function:

copy()

ilStructureObject::copy

(

ilObjLearningModule

$a_target_lm

)

copy chapter

Definition at line 74 of file class.ilStructureObject.php.

     : ilStructureObject {
        $chap = new ilStructureObject($a_target_lm);
        $chap->setTitle($this->getTitle());
        if ($this->getLMId() != $a_target_lm->getId()) {
            $chap->setImportId("il__st_" . $this->getId());
        }
        $chap->setLMId($a_target_lm->getId());
        $chap->setType($this->getType());
        $chap->setDescription($this->getDescription());
        $chap->create(true);
        $a_copied_nodes[$this->getId()] = $chap->getId();
 
        // copy meta data
        $md = new ilMD($this->getLMId(), $this->getId(), $this->getType());
        $new_md = $md->cloneMD($a_target_lm->getId(), $chap->getId(), $this->getType());
 
        // copy translations
        ilLMObjTranslation::copy($this->getId(), $chap->getId());
 
 
        return $chap;
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

delete()

ilStructureObject::delete

(

bool

$a_delete_meta_data = true

)

Reimplemented from ilLMObject.

Definition at line 38 of file class.ilStructureObject.php.

                                                           : void
    {
        // only relevant for online help authoring
        ilHelpMapping::removeScreenIdsOfChapter($this->getId());
 
        $node_data = $this->tree->getNodeData($this->getId());
        $this->delete_rec($this->tree, $a_delete_meta_data);
        $this->tree->deleteTree($node_data);
    }

References delete_rec(), ilLMObject\getId(), and ilHelpMapping\removeScreenIdsOfChapter().

Here is the call graph for this function:

delete_rec()

ilStructureObject::delete_rec ( ilLMTree  $a_tree, bool  $a_delete_meta_data = true  )

private

Delete sub tree.

Definition at line 51 of file class.ilStructureObject.php.

     : void {
        $childs = $a_tree->getChilds($this->getId());
        foreach ($childs as $child) {
            $obj = ilLMObjectFactory::getInstance($this->content_object, $child["obj_id"], false);
            if (is_object($obj)) {
                if ($obj->getType() == "st") {
                    $obj->delete_rec($a_tree, $a_delete_meta_data);
                }
                if ($obj->getType() == "pg") {
                    $obj->delete($a_delete_meta_data);
                }
            }
            unset($obj);
        }
        parent::delete($a_delete_meta_data);
    }

References ilLMObjectFactory\getInstance().

Referenced by delete().

Here is the call graph for this function:

Here is the caller graph for this function:

exportFO()

ilStructureObject::exportFO

(

ilXmlWriter

$a_xml_writer

)

Definition at line 264 of file class.ilStructureObject.php.

     : void {
 
        // fo:block (complete)
        $attrs = array();
        $attrs["font-family"] = "Times";
        $attrs["font-size"] = "14pt";
        $a_xml_writer->xmlElement("fo:block", $attrs, $this->getTitle());
 
        // page objects
        $this->exportFOPageObjects($a_xml_writer);
    }

exportFOPageObjects()

ilStructureObject::exportFOPageObjects

(

ilXmlWriter

$a_xml_writer

)

Definition at line 278 of file class.ilStructureObject.php.

     : void {
        $childs = $this->tree->getChilds($this->getId());
        foreach ($childs as $child) {
            if ($child["type"] != "pg") {
                continue;
            }
 
            // export xml to writer object
            $page_obj = new ilLMPageObject($this->getContentObject(), $child["obj_id"]);
            $page_obj->exportFO($a_xml_writer);
        }
    }

exportXML()

ilStructureObject::exportXML	(	ilXmlWriter	$a_xml_writer,
		int	$a_inst,
		ilLog	$expLog
	)

Definition at line 99 of file class.ilStructureObject.php.

     : void {
        $expLog->write(date("[y-m-d H:i:s] ") . "Structure Object " . $this->getId());
        $attrs = array();
        $a_xml_writer->xmlStartTag("StructureObject", $attrs);
 
        // MetaData
        $this->exportXMLMetaData($a_xml_writer);
 
        // StructureObjects
        $this->exportXMLPageObjects($a_xml_writer, $a_inst);
 
        // PageObjects
        $this->exportXMLStructureObjects($a_xml_writer, $a_inst, $expLog);
 
        $a_xml_writer->xmlEndTag("StructureObject");
    }

exportXMLMetaData()

ilStructureObject::exportXMLMetaData

(

ilXmlWriter

$a_xml_writer

)

Definition at line 120 of file class.ilStructureObject.php.

     : void {
        $md2xml = new ilMD2XML($this->getLMId(), $this->getId(), $this->getType());
        $md2xml->setExportMode(true);
        $md2xml->startExport();
        $a_xml_writer->appendXML($md2xml->getXML());
    }

exportXMLPageObjects()

ilStructureObject::exportXMLPageObjects	(	ilXmlWriter	$a_xml_writer,
		int	$a_inst = 0
	)

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

     : void {
        $childs = $this->tree->getChilds($this->getId());
        foreach ($childs as $child) {
            if ($child["type"] != "pg") {
                continue;
            }
 
            // export xml to writer object
            ilLMPageObject::_exportXMLAlias($a_xml_writer, $child["obj_id"], $a_inst);
        }
    }

References ilLMPageObject\_exportXMLAlias().

Here is the call graph for this function:

exportXMLStructureObjects()

ilStructureObject::exportXMLStructureObjects	(	ilXmlWriter	$a_xml_writer,
		int	$a_inst,
		ilLog	$expLog
	)

Definition at line 243 of file class.ilStructureObject.php.

     : void {
        $childs = $this->tree->getChilds($this->getId());
        foreach ($childs as $child) {
            if ($child["type"] != "st") {
                continue;
            }
 
            // export xml to writer object
            $structure_obj = new ilStructureObject(
                $this->getContentObject(),
                $child["obj_id"]
            );
            $structure_obj->exportXML($a_xml_writer, $a_inst, $expLog);
            unset($structure_obj);
        }
    }

getChapterList()

static ilStructureObject::getChapterList ( int  $a_lm_id )

static

Definition at line 293 of file class.ilStructureObject.php.

     : array {
        $tree = new ilLMTree($a_lm_id);
 
        $chapters = array();
        $ndata = $tree->getNodeData($tree->readRootId());
        $childs = $tree->getSubTree($ndata);
        foreach ($childs as $child) {
            if ($child["type"] == "st") {
                $chapters[] = $child;
            }
        }
        return $chapters;
    }

Referenced by ilExportIDTableGUI\__construct(), and ilHelpMappingTableGUI\getChapters().

Here is the caller graph for this function:

modifyExportIdentifier()

ilStructureObject::modifyExportIdentifier	(	string	$a_tag,
		string	$a_param,
		string	$a_value
	)

Definition at line 129 of file class.ilStructureObject.php.

     : string {
        if ($a_tag == "Identifier" && $a_param == "Entry") {
            $a_value = "il_" . IL_INST_ID . "_st_" . $this->getId();
        }
 
        return $a_value;
    }

References ILIAS\Survey\Mode\getId(), and IL_INST_ID.

Here is the call graph for this function:

Field Documentation

$origin_id

string ilStructureObject::$origin_id

Definition at line 26 of file class.ilStructureObject.php.

$tree

ilLMTree ilStructureObject::$tree

Definition at line 27 of file class.ilStructureObject.php.

---

The documentation for this class was generated from the following file:

• Modules/LearningModule/classes/class.ilStructureObject.php