ilObjHelpSettings Class Reference

Help settings application class. More...

Inheritance diagram for ilObjHelpSettings:

Collaboration diagram for ilObjHelpSettings:

Public Member Functions
	ilObjHelpSettings ($a_id=0, $a_call_by_reference=true)
	Constructor.
	initType ()
	Init type.
	uploadHelpModule ($a_file)
	Upload help file.
	getHelpModules ()
	Get help modules.
	lookupModuleTitle ($a_id)
	lookup module title
	lookupModuleLmId ($a_id)
	lookup module lm id
	deleteModule ($a_id)
	Delete module.
Public Member Functions inherited from ilObject2
	__construct ($a_id=0, $a_reference=true)
	Constructor public.
	withReferences ()
	determines wehter objects are referenced or not (got ref ids or not)
	read ($a_force_db=false)
	Read data from db.
	getId ()
	get object id public
	setId ($a_id)
	set object id public
	setRefId ($a_id)
	set reference id public
	getRefId ()
	get reference id public
	getType ()
	get object type public
	setType ($a_type)
	set object type public
	getPresentationTitle ()
	get presentation title Normally same as title Overwritten for sessions
	getTitle ()
	get object title public
	getUntranslatedTitle ()
	get untranslated object title public
	setTitle ($a_title)
	set object title
	getDescription ()
	get object description
	setDescription ($a_desc)
	set object description
	getLongDescription ()
	get object long description (stored in object_description)
	getImportId ()
	get import id
	setImportId ($a_import_id)
	set import id
	getOwner ()
	get object owner
	getOwnerName ()
	_lookupOwnerName ($a_owner_id)
	lookup owner name for owner id
	setOwner ($a_owner)
	set object owner
	getCreateDate ()
	get create date public
	getLastUpdateDate ()
	get last update date public
	setObjDataRecord ($a_record)
	set object_data record (note: this method should only be called from the ilObjectFactory class)
	create ($a_clone_mode=false)
	update ()
	update object in db
	MDUpdateListener ($a_element)
	Meta data update listener.
	createMetaData ()
	create meta data entry
	updateMetaData ()
	update meta data entry
	deleteMetaData ()
	delete meta data entry
	updateOwner ()
	update owner of object in db
	_getIdForImportId ($a_import_id)
	get current object id for import id (static)
	_lookupOwner ($a_id)
	lookup object owner
	_lookupLastUpdate ($a_id, $a_as_string=false)
	lookup last update
	_getLastUpdateOfObjects ($a_objs)
	Get last update for a set of media objects.
	_setDeletedDate ($a_ref_id)
	only called in ilTree::saveSubTree
	_resetDeletedDate ($a_ref_id)
	only called in ilObjectGUI::insertSavedNodes
	_lookupDeletedDate ($a_ref_id)
	only called in ilObjectGUI::insertSavedNodes
	_writeTitle ($a_obj_id, $a_title)
	write title to db (static)
	_writeDescription ($a_obj_id, $a_desc)
	write description to db (static)
	_writeImportId ($a_obj_id, $a_import_id)
	write import id to db (static)
	_isInTrash ($a_ref_id)
	checks wether object is in trash
	_hasUntrashedReference ($a_obj_id)
	checks wether an object has at least one reference that is not in trash
	_getObjectsDataForType ($a_type, $a_omit_trash=false)
	get all objects of a certain type
	putInTree ($a_parent_ref)
	maybe this method should be in tree object!?
	setPermissions ($a_parent_ref)
	set permissions of object
	createReference ()
	creates reference for object
	countReferences ()
	count references of object
	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!!
	initDefaultRoles ()
	init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type If you want to setup default local roles you MUST overwrite this method in derived object classes (see ilObjForum for an example) public
	createRoleFolder ()
	creates a local role folder
	notify ($a_event, $a_ref_id, $a_parent_non_rbac_id, $a_node_id, $a_params=0)
	notifys an object about an event occured Based on the event passed, each object may decide how it reacts.
	setRegisterMode ($a_bool)
	isUserRegistered ($a_user_id=0)
	requireRegistration ()
	appendCopyInfo ($a_target_id, $a_copy_id)
	Prepend Copy info if object with same name exists in that container.
	cloneMetaData ($target_obj)
	Copy meta data.
	cloneObject ($a_target_id, $a_copy_id=null, $a_omit_tree=false)
	Clone object permissions, put in tree ...
	cloneDependencies ($a_target_id, $a_copy_id)
	Clone object dependencies.
Public Member Functions inherited from ilObject
	ilObject ($a_id=0, $a_reference=true)
	Constructor public.
	getDiskUsage ()
	Gets the disk usage of the object in bytes.
	create ()
	create
	applyDidacticTemplate ($a_tpl_id)
	Apply template.
	getXMLZip ()
	getHTMLDirectory ()
	_lookupCreationDate ($a_id)
	Lookup creation date.

Static Public Member Functions
static	createHelpModule ()
	Create help module.
static	writeHelpModuleLmId ($a_id, $a_lm_id)
	Write help module lm id.
static	isHelpLM ($a_lm_id)
	Check if LM is a help LM.
Static Public Member Functions inherited from ilObject2
static	_lookupObjIdByImportId ($a_import_id)
static	_getAllReferences ($a_id)
	get all reference ids of object
static	_lookupTitle ($a_id)
	lookup object title
static	_getIdsForTitle ($title, $type= '', $partialmatch=false)
static	_lookupDescription ($a_id)
	lookup object description
static	_lookupObjId ($a_id)
static	_lookupType ($a_id, $a_reference=false)
	lookup object type
static	_lookupObjectId ($a_ref_id)
	lookup object id
static	_exists ($a_id, $a_reference=false)
static	_getObjectsByType ($a_obj_type="", $a_owner="")
	Get objects by type.
static	_prepareCloneSelection ($a_ref_ids, $new_type)
static	_getIcon ($a_obj_id="", $a_size="big", $a_type="", $a_offline=false)
	Get icon for repository item.
Static Public Member Functions inherited from ilObject
static	setDeletedDates ($a_ref_ids)
	Set deleted date type $ilDB.
static	_exists ($a_id, $a_reference=false, $a_type=null)
	checks if an object exists in object_data
static	_prepareCloneSelection ($a_ref_ids, $new_type, $show_path=true)
	Prepare copy wizard object selection.
static	collectDeletionDependencies (&$deps, $a_ref_id, $a_obj_id, $a_type, $a_depth=0)
	Collect deletion dependencies.
static	getDeletionDependencies ($a_obj_id)
	Get deletion dependencies.
static	getLongDescriptions (array $a_obj_ids)
	Get long description data.
static	getAllOwnedRepositoryObjects ($a_user_id)
	Get all ids of objects user owns.
static	hasAutoRating ($a_type, $a_ref_id)
	Check if auto rating is active for parent group/course.

Additional Inherited Members
Data Fields inherited from ilObject
const	TITLE_LENGTH = 255
	max length of object title
const	DESC_LENGTH = 128
	$ilias
	$lng
	$id
	$ref_id
	$type
	$title
	$untranslatedTitle
	$desc
	$long_desc
	$owner
	$create_date
	$last_update
	$import_id
	$register = false
	$referenced
	$objectList
	$max_title
	$max_desc
	$add_dots
	$obj_data_record
	object_data record
Protected Member Functions inherited from ilObject2
	doRead ()
	doCreate ()
	beforeCreate ()
	doUpdate ()
	beforeUpdate ()
	doMDUpdateListener ($a_element)
	beforeMDUpdateListener ($a_element)
	doCreateMetaData ()
	beforeCreateMetaData ()
	doUpdateMetaData ()
	beforeUpdateMetaData ()
	doDelete ()
	beforeDelete ()
	doCloneObject ($new_obj, $a_target_id, $a_copy_id=null)
	beforeCloneObject ()

Detailed Description

Help settings application class.

Author

Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

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

Member Function Documentation

static ilObjHelpSettings::createHelpModule ( )

static

Create help module.

Parameters

@return

Definition at line 43 of file class.ilObjHelpSettings.php.

References ilObject\$id.

Referenced by uploadHelpModule().

        {
                global $ilDB;
                
                $id = $ilDB->nextId("help_module");
                
                $ilDB->manipulate("INSERT INTO help_module ".
                        "(id) VALUES (".
                        $ilDB->quote($id, "integer").
                        ")");
                
                return $id;
        }

Here is the caller graph for this function:

ilObjHelpSettings::deleteModule

(

$a_id

)

Delete module.

Parameters

@return

Definition at line 170 of file class.ilObjHelpSettings.php.

References $ilSetting, ilObject\_lookupType(), ilHelpMapping\deleteEntriesOfModule(), and ilHelp\deleteTooltipsOfModule().

        {
                global $ilDB, $ilSetting;
                
                // if this is the currently activated one, deactivate it first
                if ($a_id == (int) $ilSetting->get("help_module"))
                {
                        $ilSetting->set("help_module", "");
                }
                
                $set = $ilDB->query("SELECT * FROM help_module ".
                        " WHERE id = ".$ilDB->quote($a_id, "integer")
                        );
                $rec  = $ilDB->fetchAssoc($set);

                // delete learning module
                if (ilObject::_lookupType($rec["lm_id"]) == "lm")
                {
                        include_once("./Modules/LearningModule/classes/class.ilObjLearningModule.php");
                        $lm = new ilObjLearningModule($rec["lm_id"], false);
                        $lm->delete();
                }
                
                // delete mappings
                include_once("./Services/Help/classes/class.ilHelpMapping.php");
                ilHelpMapping::deleteEntriesOfModule($a_id);
                
                // delete tooltips
                include_once("./Services/Help/classes/class.ilHelp.php");
                ilHelp::deleteTooltipsOfModule($a_id);
                
                // delete help module record
                $ilDB->manipulate("DELETE FROM help_module WHERE ".
                        " id = ".$ilDB->quote($a_id, "integer"));
                
        }

Here is the call graph for this function:

ilObjHelpSettings::getHelpModules

(

)

Get help modules.

Parameters

@return

Definition at line 105 of file class.ilObjHelpSettings.php.

References ilObject\_lookupCreationDate(), ilObject2\_lookupTitle(), and ilObject\_lookupType().

        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT * FROM help_module");
                
                $mods = array();
                while ($rec  = $ilDB->fetchAssoc($set))
                {
                        if (ilObject::_lookupType($rec["lm_id"]) == "lm")
                        {
                                $rec["title"] = ilObject::_lookupTitle($rec["lm_id"]);
                                $rec["create_date"] = ilObject::_lookupCreationDate($rec["lm_id"]);
                        }
                        
                        $mods[] = $rec;
                }
                
                return $mods;
        }

Here is the call graph for this function:

ilObjHelpSettings::ilObjHelpSettings	(		$a_id = 0,
			$a_call_by_reference = true
	)

Constructor.

Parameters

integer	reference_id or object_id
boolean	treat the id as reference_id (true) or object_id (false)

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

References ilObject2\__construct().

        {
                parent::__construct($a_id,$a_call_by_reference);
        }

Here is the call graph for this function:

ilObjHelpSettings::initType

(

)

Init type.

Reimplemented from ilObject2.

Definition at line 32 of file class.ilObjHelpSettings.php.

        {
                $this->type = "hlps";
        }

static ilObjHelpSettings::isHelpLM (   $a_lm_id )

static

Check if LM is a help LM.

Parameters

integer

$a_lm_id

lm id

Returns

bool true/false

Definition at line 213 of file class.ilObjHelpSettings.php.

Referenced by ilLMObject\_getIdForImportId().

        {
                global $ilDB;

                $set = $ilDB->query("SELECT id FROM help_module ".
                        " WHERE lm_id = ".$ilDB->quote($a_lm_id, "integer")
                );
                if ($rec = $ilDB->fetchAssoc($set))
                {
                        return true;
                }
                return false;
        }

Here is the caller graph for this function:

ilObjHelpSettings::lookupModuleLmId

(

$a_id

)

lookup module lm id

Parameters

@return

Definition at line 153 of file class.ilObjHelpSettings.php.

Referenced by ilHelpGUI\showHelp().

        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT lm_id FROM help_module ".
                        " WHERE id = ".$ilDB->quote($a_id, "integer")
                        );
                $rec  = $ilDB->fetchAssoc($set);
                return $rec["lm_id"];
        }

Here is the caller graph for this function:

ilObjHelpSettings::lookupModuleTitle

(

$a_id

)

lookup module title

Parameters

@return

Definition at line 132 of file class.ilObjHelpSettings.php.

References ilObject2\_lookupTitle(), and ilObject\_lookupType().

        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT * FROM help_module ".
                        " WHERE id = ".$ilDB->quote($a_id, "integer")
                        );
                $rec  = $ilDB->fetchAssoc($set);
                if (ilObject::_lookupType($rec["lm_id"]) == "lm")
                {
                        return ilObject::_lookupTitle($rec["lm_id"]);
                }
                return "";
        }

Here is the call graph for this function:

ilObjHelpSettings::uploadHelpModule

(

$a_file

)

Upload help file.

Parameters

@return

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

References ilObject\$id, createHelpModule(), and writeHelpModuleLmId().

        {
                $id = $this->createHelpModule();
                
                // create and insert object in objecttree
                include_once("./Modules/LearningModule/classes/class.ilObjContentObject.php");
                $newObj = new ilObjContentObject();
                $newObj->setType("lm");
                $newObj->setTitle("Help Module");
                $newObj->create(true);
                $newObj->createLMTree();
                
                self::writeHelpModuleLmId($id, $newObj->getId());

                // import help learning module
                $mess = $newObj->importFromZipFile($a_file["tmp_name"], $a_file["name"],
                        false, $id);
        }

Here is the call graph for this function:

static ilObjHelpSettings::writeHelpModuleLmId (   $a_id,   $a_lm_id  )

static

Write help module lm id.

Parameters

@return

Definition at line 63 of file class.ilObjHelpSettings.php.

Referenced by uploadHelpModule().

        {
                global $ilDB;
                
                $ilDB->manipulate("UPDATE help_module SET ".
                        " lm_id = ".$ilDB->quote($a_lm_id, "integer").
                        " WHERE id = ".$ilDB->quote($a_id, "integer")
                        );
        }

Here is the caller graph for this function:

---

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

• Services/Help/classes/class.ilObjHelpSettings.php