ILIAS  release_9 Revision v9.13-25-g2c18ec4c24f
ilObjFileBasedLM 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 ilObjFileBasedLM:
+ Collaboration diagram for ilObjFileBasedLM:

Public Member Functions

 __construct (int $a_id=0, bool $a_call_by_reference=true)
 
 update (bool $a_skip_meta=false)
 
 read ()
 
 create (bool $a_skip_meta=false)
 
 getDataDirectory (string $mode="filesystem")
 
 createDataDirectory ()
 
 getStartFile ()
 
 setStartFile (string $a_file, bool $a_omit_file_check=false)
 
 delete ()
 
 populateByDirectoy (string $a_dir, string $a_filename="")
 Populate by directory. More...
 
 isInfoEnabled ()
 
- Public Member Functions inherited from ilObject
 getObjectProperties ()
 
 flushObjectProperties ()
 
 withReferences ()
 determines whether objects are referenced or not (got ref ids or not) More...
 
 processAutoRating ()
 
 read ()
 
 getId ()
 
 setId (int $id)
 
 setRefId (int $ref_id)
 
 getRefId ()
 
 getType ()
 
 setType (string $type)
 
 getPresentationTitle ()
 get presentation title Normally same as title Overwritten for sessions More...
 
 getTitle ()
 
 getUntranslatedTitle ()
 Get untranslated object title WebDAV needs to access the untranslated title of an object. More...
 
 setTitle (string $title)
 
 getDescription ()
 
 setDescription (string $description)
 
 getLongDescription ()
 get object long description (stored in object_description) More...
 
 getImportId ()
 
 setImportId (string $import_id)
 
 setOfflineStatus (bool $status)
 
 getOfflineStatus ()
 
 supportsOfflineHandling ()
 
 getOwner ()
 
 getOwnerName ()
 get full name of object owner More...
 
 setOwner (int $usr_id)
 
 getCreateDate ()
 Get create date in YYYY-MM-DD HH-MM-SS format. More...
 
 getLastUpdateDate ()
 Get last update date in YYYY-MM-DD HH-MM-SS format. More...
 
 create ()
 note: title, description and type should be set when this function is called More...
 
 update ()
 
 MDUpdateListener (string $element)
 Metadata update listener. More...
 
 createMetaData ()
 
 updateMetaData ()
 
 deleteMetaData ()
 
 updateOwner ()
 update owner of object in db More...
 
 putInTree (int $parent_ref_id)
 maybe this method should be in tree object!? More...
 
 setPermissions (int $parent_ref_id)
 
 setParentRolePermissions (int $parent_ref_id)
 Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g. More...
 
 createReference ()
 creates reference for object More...
 
 countReferences ()
 
 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!! More...
 
 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. More...
 
 applyDidacticTemplate (int $tpl_id)
 
 getXMLZip ()
 
 getHTMLDirectory ()
 
 appendCopyInfo (int $target_id, int $copy_id)
 Prepend Copy info if object with same name exists in that container. More...
 
 cloneDependencies (int $target_id, int $copy_id)
 Clone object dependencies. More...
 
 cloneMetaData (ilObject $target_obj)
 Copy meta data. More...
 
 selfOrParentWithRatingEnabled ()
 
 getPossibleSubObjects (bool $filter=true)
 get all possible sub objects of this type the object can decide which types of sub objects are possible jut in time overwrite if the decision distinguish from standard model More...
 

Protected Attributes

string $start_file = null
 
bool $online
 
- Protected Attributes inherited from ilObject
ilLogger $obj_log
 
ILIAS $ilias
 
ilObjectDefinition $obj_definition
 
ilDBInterface $db
 
ilLogger $log
 
ilErrorHandling $error
 
ilTree $tree
 
ilAppEventHandler $app_event_handler
 
ilRbacAdmin $rbac_admin
 
ilRbacReview $rbac_review
 
ilObjUser $user
 
ilLanguage $lng
 
bool $call_by_reference
 
int $max_title = self::TITLE_LENGTH
 
int $max_desc = self::DESC_LENGTH
 
bool $add_dots = true
 
int $ref_id = null
 
string $type = ""
 
string $title = ""
 
string $desc = ""
 
string $long_desc = ""
 
int $owner = 0
 
string $create_date = ""
 
string $last_update = ""
 
string $import_id = ""
 
bool $register = false
 

Additional Inherited Members

- Static Public Member Functions inherited from ilObject
static _lookupObjIdByImportId (string $import_id)
 Get (latest) object id for an import id. More...
 
static _lookupImportId (int $obj_id)
 
static _lookupOwnerName (int $owner_id)
 Lookup owner name for owner id. More...
 
static _getIdForImportId (string $import_id)
 
static _getAllReferences (int $id)
 get all reference ids for object ID More...
 
static _lookupTitle (int $obj_id)
 
static lookupOfflineStatus (int $obj_id)
 Lookup offline status using objectDataCache. More...
 
static _lookupOwner (int $obj_id)
 Lookup owner user ID for object ID. More...
 
static _getIdsForTitle (string $title, string $type='', bool $partial_match=false)
 
static _lookupDescription (int $obj_id)
 
static _lookupLastUpdate (int $obj_id, bool $formatted=false)
 
static _getLastUpdateOfObjects (array $obj_ids)
 
static _lookupObjId (int $ref_id)
 
static _setDeletedDate (int $ref_id, int $deleted_by)
 
static setDeletedDates (array $ref_ids, int $user_id)
 
static _resetDeletedDate (int $ref_id)
 
static _lookupDeletedDate (int $ref_id)
 
static _writeTitle (int $obj_id, string $title)
 write title to db (static) More...
 
static _writeDescription (int $obj_id, string $desc)
 write description to db (static) More...
 
static _writeImportId (int $obj_id, string $import_id)
 write import id to db (static) More...
 
static _lookupType (int $id, bool $reference=false)
 
static _isInTrash (int $ref_id)
 
static _hasUntrashedReference (int $obj_id)
 checks whether an object has at least one reference that is not in trash More...
 
static _lookupObjectId (int $ref_id)
 
static _getObjectsDataForType (string $type, bool $omit_trash=false)
 get all objects of a certain type More...
 
static _exists (int $id, bool $reference=false, ?string $type=null)
 checks if an object exists in object_data More...
 
static _getObjectsByType (string $obj_type="", int $owner=null)
 
static _prepareCloneSelection (array $ref_ids, string $new_type, bool $show_path=true)
 Prepare copy wizard object selection. More...
 
static _getIcon (int $obj_id=0, string $size="big", string $type="", bool $offline=false)
 Get icon for repository item. More...
 
static collectDeletionDependencies (array &$deps, int $ref_id, int $obj_id, string $type, int $depth=0)
 Collect deletion dependencies. More...
 
static getDeletionDependencies (int $obj_id)
 Get deletion dependencies. More...
 
static getLongDescriptions (array $obj_ids)
 
static getAllOwnedRepositoryObjects (int $user_id)
 
static fixMissingTitles ($type, array &$obj_title_map)
 Try to fix missing object titles. More...
 
static _lookupCreationDate (int $obj_id)
 
static _getObjectTypeIdByTitle (string $type, \ilDBInterface $ilDB=null)
 
- Data Fields inherited from ilObject
const TITLE_LENGTH = 255
 
const DESC_LENGTH = 128
 
const LONG_DESC_LENGTH = 4000
 
const TABLE_OBJECT_DATA = "object_data"
 
array $objectList
 
string $untranslatedTitle
 
- Protected Member Functions inherited from ilObject
 doMDUpdateListener (string $a_element)
 
 beforeMDUpdateListener (string $a_element)
 
 doCreateMetaData ()
 
 beforeCreateMetaData ()
 
 doUpdateMetaData ()
 
 beforeUpdateMetaData ()
 
 doDeleteMetaData ()
 
 beforeDeleteMetaData ()
 
 handleAutoRating ()
 
 hasAutoRating ()
 

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 File Based Learning Module (HTML) object

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

Definition at line 23 of file class.ilObjFileBasedLM.php.

Constructor & Destructor Documentation

◆ __construct()

ilObjFileBasedLM::__construct ( int  $a_id = 0,
bool  $a_call_by_reference = true 
)

Definition at line 28 of file class.ilObjFileBasedLM.php.

References $DIC, and ILIAS\MetaData\Repository\Validation\Data\__construct().

31  {
32  global $DIC;
33 
34 
35  $this->db = $DIC->database();
36  // this also calls read() method! (if $a_id is set)
37  $this->type = "htlm";
38  parent::__construct($a_id, $a_call_by_reference);
39  }
global $DIC
Definition: feed.php:28
__construct(VocabulariesInterface $vocabularies)
+ Here is the call graph for this function:

Member Function Documentation

◆ create()

ilObjFileBasedLM::create ( bool  $a_skip_meta = false)

Definition at line 68 of file class.ilObjFileBasedLM.php.

References ilObject\$db, $id, $ilDB, createDataDirectory(), and ilObject\createMetaData().

68  : int
69  {
70  $ilDB = $this->db;
71 
72  $id = parent::create();
73  $this->createDataDirectory();
74 
75  $ilDB->manipulate("INSERT INTO file_based_lm (id, startfile) VALUES " .
76  " (" . $ilDB->quote($this->getId(), "integer") . "," .
77  $ilDB->quote($this->getStartFile(), "text") . ")");
78  if (!$a_skip_meta) {
79  $this->createMetaData();
80  }
81  return $id;
82  }
ilDBInterface $db
$id
plugin.php for ilComponentBuildPluginInfoObjectiveTest::testAddPlugins
Definition: plugin.php:23
+ Here is the call graph for this function:

◆ createDataDirectory()

ilObjFileBasedLM::createDataDirectory ( )

Definition at line 92 of file class.ilObjFileBasedLM.php.

References getDataDirectory(), and ilFileUtils\makeDir().

Referenced by create().

92  : void
93  {
95  }
getDataDirectory(string $mode="filesystem")
static makeDir(string $a_dir)
creates a new directory and inherits all filesystem permissions of the parent directory You may pass ...
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ delete()

ilObjFileBasedLM::delete ( )

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

References ilObject\$db, $ilDB, ilFileUtils\delDir(), ilObject\deleteMetaData(), and getDataDirectory().

113  : bool
114  {
115  $ilDB = $this->db;
116 
117  // always call parent delete function first!!
118  if (!parent::delete()) {
119  return false;
120  }
121 
122  // Delete meta data
123  $this->deleteMetaData();
124 
125  // delete file_based_lm record
126  $ilDB->manipulate("DELETE FROM file_based_lm WHERE id = " .
127  $ilDB->quote($this->getId(), "integer"));
128 
129  // delete data directory
131 
132  return true;
133  }
getDataDirectory(string $mode="filesystem")
static delDir(string $a_dir, bool $a_clean_only=false)
removes a dir and all its content (subdirs and files) recursively
ilDBInterface $db
+ Here is the call graph for this function:

◆ getDataDirectory()

ilObjFileBasedLM::getDataDirectory ( string  $mode = "filesystem")

Definition at line 84 of file class.ilObjFileBasedLM.php.

References ilObject\getId(), and ilFileUtils\getWebspaceDir().

Referenced by createDataDirectory(), delete(), populateByDirectoy(), and setStartFile().

84  : string
85  {
86  $lm_data_dir = ilFileUtils::getWebspaceDir($mode) . "/lm_data";
87  $lm_dir = $lm_data_dir . "/lm_" . $this->getId();
88 
89  return $lm_dir;
90  }
static getWebspaceDir(string $mode="filesystem")
get webspace directory
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getStartFile()

ilObjFileBasedLM::getStartFile ( )

Definition at line 97 of file class.ilObjFileBasedLM.php.

References $start_file.

Referenced by populateByDirectoy().

97  : ?string
98  {
99  return $this->start_file;
100  }
+ Here is the caller graph for this function:

◆ isInfoEnabled()

ilObjFileBasedLM::isInfoEnabled ( )

Definition at line 177 of file class.ilObjFileBasedLM.php.

References ilObject\getId(), and ilObjContentObjectAccess\isInfoEnabled().

177  : bool
178  {
180  }
+ Here is the call graph for this function:

◆ populateByDirectoy()

ilObjFileBasedLM::populateByDirectoy ( string  $a_dir,
string  $a_filename = "" 
)

Populate by directory.

Add a filename to do a special check for ILIAS HTML export files. If the corresponding directory is found within the passed directory path (i.e. "htlm_<id>") this subdirectory is used instead.

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

References ilCopyWizardOptions\_getInstance(), ilObject\cloneMetaData(), getDataDirectory(), ilObject\getOfflineStatus(), getStartFile(), ilFileUtils\rCopy(), and ilFileUtils\renameExecutables().

144  : void {
145  preg_match("/.*htlm_([0-9]*)\.zip/", $a_filename, $match);
146  if (is_dir($a_dir . "/htlm_" . ($match[1] ?? ""))) {
147  $a_dir .= "/htlm_" . ($match[1] ?? "");
148  }
149  ilFileUtils::rCopy($a_dir, $this->getDataDirectory());
151  }
getDataDirectory(string $mode="filesystem")
static rCopy(string $a_sdir, string $a_tdir, bool $preserveTimeAttributes=false)
Copies content of a directory $a_sdir recursively to a directory $a_tdir.
static renameExecutables(string $a_dir)
+ Here is the call graph for this function:

◆ read()

ilObjFileBasedLM::read ( )

Definition at line 56 of file class.ilObjFileBasedLM.php.

References ilObject\$db, $ilDB, $lm_set, $q, ilObject\getId(), and setStartFile().

56  : void
57  {
58  $ilDB = $this->db;
59 
60  parent::read();
61 
62  $q = "SELECT * FROM file_based_lm WHERE id = " . $ilDB->quote($this->getId(), "integer");
63  $lm_set = $ilDB->query($q);
64  $lm_rec = $ilDB->fetchAssoc($lm_set);
65  $this->setStartFile((string) $lm_rec["startfile"]);
66  }
setStartFile(string $a_file, bool $a_omit_file_check=false)
ilDBInterface $db
$lm_set
$q
Definition: shib_logout.php:21
+ Here is the call graph for this function:

◆ setStartFile()

ilObjFileBasedLM::setStartFile ( string  $a_file,
bool  $a_omit_file_check = false 
)

Definition at line 102 of file class.ilObjFileBasedLM.php.

References getDataDirectory().

Referenced by read().

105  : void {
106  if ($a_file &&
107  (file_exists($this->getDataDirectory() . "/" . $a_file) || $a_omit_file_check)) {
108  $this->start_file = $a_file;
109  }
110  }
getDataDirectory(string $mode="filesystem")
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ update()

ilObjFileBasedLM::update ( bool  $a_skip_meta = false)

Definition at line 41 of file class.ilObjFileBasedLM.php.

References ilObject\$db, $ilDB, $q, and ilObject\updateMetaData().

41  : bool
42  {
43  $ilDB = $this->db;
44 
45  if (!$a_skip_meta) {
46  $this->updateMetaData();
47  }
48  parent::update();
49 
50  $ilDB->manipulate($q = "UPDATE file_based_lm SET " .
51  " startfile = " . $ilDB->quote($this->getStartFile(), "text") . " " .
52  " WHERE id = " . $ilDB->quote($this->getId(), "integer"));
53  return true;
54  }
ilDBInterface $db
$q
Definition: shib_logout.php:21
+ Here is the call graph for this function:

Field Documentation

◆ $online

bool ilObjFileBasedLM::$online
protected

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

◆ $start_file

string ilObjFileBasedLM::$start_file = null
protected

Definition at line 25 of file class.ilObjFileBasedLM.php.

Referenced by getStartFile().


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