ILIAS  trunk Revision v12.0_alpha-1227-g7ff6d300864
ilObjPortfolioTemplate 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 ilObjPortfolioTemplate:
+ Collaboration diagram for ilObjPortfolioTemplate:

Public Member Functions

 isActivationLimited ()
 
 setActivationLimited (bool $a_value)
 
 setActivationVisibility (bool $a_value)
 
 getActivationVisibility ()
 
 setActivationStartDate (?int $starting_time=null)
 
 setActivationEndDate (?int $ending_time=null)
 
 getActivationStartDate ()
 
 getActivationEndDate ()
 
- Public Member Functions inherited from ilObjPortfolioBase
 __construct (int $a_id=0, bool $a_reference=true)
 Constructor. More...
 
 setPublicComments (bool $a_value)
 
 hasPublicComments ()
 
 hasProfilePicture ()
 
 setProfilePicture (bool $a_status)
 
 getBackgroundColor ()
 
 setBackgroundColor (string $a_value)
 Set background color, e.g. More...
 
 getFontColor ()
 
 setFontColor (string $a_value)
 
 fixLinksOnTitleChange (array $a_title_changes)
 Update internal portfolio links on title change. More...
 
- Public Member Functions inherited from ilObject2
 __construct (int $a_id=0, bool $a_reference=true)
 Constructor. More...
 
 read ()
 
 create (bool $a_clone_mode=false)
 
 update ()
 
 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...
 
 cloneMetaData (ilObject $target_obj)
 Copy meta data. More...
 
 cloneObject (int $target_id, int $copy_id=0, bool $omit_tree=false)
 
- 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, int $new_obj_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...
 

Static Public Member Functions

static getAvailablePortfolioTemplates (string $a_permission="read")
 
- Static Public Member Functions inherited from ilObjPortfolioBase
static clonePagesAndSettings (ilObjPortfolioBase $a_source, ilObjPortfolioBase $a_target, ?array $a_recipe=null, bool $copy_all=false)
 Build template from portfolio and vice versa. More...
 
- 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 getIconForType (string $type)
 
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)
 

Protected Member Functions

 initType ()
 
 doRead ()
 
 doCreate (bool $clone_mode=false)
 
 doUpdate ()
 
 deleteAllPages ()
 
 doCloneObject (ilObject2 $new_obj, int $a_target_id, ?int $a_copy_id=null)
 
 updateActivation ()
 
- Protected Member Functions inherited from ilObjPortfolioBase
 doRead ()
 
 doReadCustom (array $a_row)
 May be overwritten by derived classes. More...
 
 doCreate (bool $clone_mode=false)
 
 doUpdate ()
 
 doUpdateCustom (array &$a_fields)
 May be overwritte by derived classes. More...
 
 doDelete ()
 
 deleteAllPages ()
 
- Protected Member Functions inherited from ilObject2
 initType ()
 
 doRead ()
 
 doCreate (bool $clone_mode=false)
 
 beforeCreate ()
 If overwritten this method should return true, there is currently no "abort" handling for cases where "false" is returned. More...
 
 doUpdate ()
 
 beforeUpdate ()
 
 doDelete ()
 
 beforeDelete ()
 
 doCloneObject (ilObject2 $new_obj, int $a_target_id, ?int $a_copy_id=null)
 
 beforeCloneObject ()
 
- Protected Member Functions inherited from ilObject
 doMDUpdateListener (string $a_element)
 
 beforeMDUpdateListener (string $a_element)
 
 doCreateMetaData ()
 
 beforeCreateMetaData ()
 
 doUpdateMetaData ()
 
 beforeUpdateMetaData ()
 
 doDeleteMetaData ()
 
 beforeDeleteMetaData ()
 
 handleAutoRating ()
 
 hasAutoRating ()
 

Protected Attributes

bool $activation_limited = false
 
bool $activation_visibility = false
 
int $activation_starting_time = 0
 
int $activation_ending_time = 0
 
- Protected Attributes inherited from ilObjPortfolioBase
ILIAS Notes Service $notes
 
ilSetting $setting
 
bool $comments = false
 
string $bg_color = ""
 
string $font_color = ""
 
string $img = ""
 
string $ppic = ""
 
bool $style = false
 
- 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
 
LOMServices $lom_services
 
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

- 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
 
- Static Protected Member Functions inherited from ilObjPortfolioBase
static cloneBasics (ilObjPortfolioBase $a_source, ilObjPortfolioBase $a_target)
 Clone basic settings. More...
 
static updateDomNodes (DOMDocument $a_dom, string $a_xpath, string $a_attr_id, string $a_attr_value)
 

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

Author
Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 22 of file class.ilObjPortfolioTemplate.php.

Member Function Documentation

◆ deleteAllPages()

ilObjPortfolioTemplate::deleteAllPages ( )
protected

Reimplemented from ilObjPortfolioBase.

Definition at line 67 of file class.ilObjPortfolioTemplate.php.

67 : void
68 {
69 // delete pages
71 foreach ($pages as $page) {
72 $page_obj = new ilPortfolioTemplatePage($page["id"]);
73 $page_obj->setPortfolioId($this->id);
74 $page_obj->delete();
75 }
76 }
static getAllPortfolioPages(int $a_portfolio_id)
Get pages of portfolio.
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...

References ilPortfolioPage\getAllPortfolioPages().

+ Here is the call graph for this function:

◆ doCloneObject()

ilObjPortfolioTemplate::doCloneObject ( ilObject2  $new_obj,
int  $a_target_id,
?int  $a_copy_id = null 
)
protected

Reimplemented from ilObject2.

Definition at line 78 of file class.ilObjPortfolioTemplate.php.

78 : void
79 {
80 assert($new_obj instanceof ilObjPortfolioTemplate);
81 //copy online status if object is not the root copy object
82 $cp_options = ilCopyWizardOptions::_getInstance($a_copy_id);
83
84 /* should be handled by object
85 if (!$cp_options->isRootNode($this->getRefId())) {
86 $new_obj->setOnline($this->isOnline());
87 }*/
88
89 self::cloneBasics($this, $new_obj);
90
91 // copy pages
92 foreach (ilPortfolioPage::getAllPortfolioPages($this->getId()) as $page) {
93 // see ilObjWiki::cloneObject();
94
95 $page = new ilPortfolioTemplatePage($page["id"]);
96
97 $new_page = new ilPortfolioTemplatePage();
98 $new_page->setPortfolioId($new_obj->getId());
99 $new_page->setTitle($page->getTitle());
100 $new_page->setType($page->getType());
101 $new_page->setOrderNr($page->getOrderNr());
102 $new_page->create(false);
103
104 $page->copy($new_page->getId(), "", $new_obj->getId(), true, $a_copy_id);
105 }
106 }
static _getInstance(int $a_copy_id)
static cloneBasics(ilObjPortfolioBase $a_source, ilObjPortfolioBase $a_target)
Clone basic settings.
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...

References ilCopyWizardOptions\_getInstance(), ilObjPortfolioBase\cloneBasics(), ilPortfolioPage\getAllPortfolioPages(), and ilObject\getId().

+ Here is the call graph for this function:

◆ doCreate()

ilObjPortfolioTemplate::doCreate ( bool  $clone_mode = false)
protected

Reimplemented from ilObjPortfolioBase.

Definition at line 55 of file class.ilObjPortfolioTemplate.php.

55 : void
56 {
57 parent::doCreate($clone_mode);
58 $this->updateActivation();
59 }

References updateActivation().

+ Here is the call graph for this function:

◆ doRead()

ilObjPortfolioTemplate::doRead ( )
protected

Reimplemented from ilObjPortfolioBase.

Definition at line 34 of file class.ilObjPortfolioTemplate.php.

34 : void
35 {
36 parent::doRead();
37
38 if (($this->ref_id ?? 0) > 0) {
39 $activation = ilObjectActivation::getItem($this->ref_id);
40 switch ($activation["timing_type"]) {
42 $this->setActivationLimited(true);
43 $this->setActivationStartDate($activation["timing_start"]);
44 $this->setActivationEndDate($activation["timing_end"]);
45 $this->setActivationVisibility($activation["visible"]);
46 break;
47
48 default:
49 $this->setActivationLimited(false);
50 break;
51 }
52 }
53 }
setActivationEndDate(?int $ending_time=null)
setActivationStartDate(?int $starting_time=null)
static getItem(int $ref_id)

References ilObjectActivation\getItem(), setActivationEndDate(), setActivationLimited(), setActivationStartDate(), setActivationVisibility(), and ilObjectActivation\TIMINGS_ACTIVATION.

+ Here is the call graph for this function:

◆ doUpdate()

ilObjPortfolioTemplate::doUpdate ( )
protected

Reimplemented from ilObjPortfolioBase.

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

61 : void
62 {
63 parent::doUpdate();
64 $this->updateActivation();
65 }

References updateActivation().

+ Here is the call graph for this function:

◆ getActivationEndDate()

ilObjPortfolioTemplate::getActivationEndDate ( )

Definition at line 168 of file class.ilObjPortfolioTemplate.php.

168 : ?int
169 {
170 return ($this->activation_ending_time > 0) ? $this->activation_ending_time : null;
171 }

Referenced by updateActivation().

+ Here is the caller graph for this function:

◆ getActivationStartDate()

ilObjPortfolioTemplate::getActivationStartDate ( )

Definition at line 163 of file class.ilObjPortfolioTemplate.php.

163 : ?int
164 {
165 return ($this->activation_starting_time > 0) ? $this->activation_starting_time : null;
166 }

Referenced by updateActivation().

+ Here is the caller graph for this function:

◆ getActivationVisibility()

ilObjPortfolioTemplate::getActivationVisibility ( )

Definition at line 148 of file class.ilObjPortfolioTemplate.php.

148 : bool
149 {
151 }

References $activation_visibility.

Referenced by updateActivation().

+ Here is the caller graph for this function:

◆ getAvailablePortfolioTemplates()

static ilObjPortfolioTemplate::getAvailablePortfolioTemplates ( string  $a_permission = "read")
static

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

179 : array {
180 global $DIC;
181
182 $ilUser = $DIC->user();
183 $ilAccess = $DIC->access();
184
185 $res = array();
186
187 foreach (ilObject::_getObjectsByType("prtt") as $obj) {
188 $has_permission = false;
189
190 if ($obj["owner"] == $ilUser->getId()) {
191 $has_permission = true;
192 } else {
193 foreach (ilObject::_getAllReferences($obj["obj_id"]) as $ref_id) {
194 if ($ilAccess->checkAccess($a_permission, "", $ref_id)) {
195 $has_permission = true;
196 break;
197 }
198 }
199 }
200
201 if ($has_permission) {
202 $res[$obj["obj_id"]] = $obj["title"];
203 }
204 }
205
206 asort($res);
207 return $res;
208 }
static _getAllReferences(int $id)
get all reference ids for object ID
static _getObjectsByType(string $obj_type="", ?int $owner=null)
$res
Definition: ltiservices.php:69
global $DIC
Definition: shib_login.php:26

Referenced by ilObjPortfolioGUI\createPortfolioFromAssignment(), ilExSubmissionObjectGUI\createPortfolioFromAssignmentObject(), ilObjPortfolioTemplateGUI\initCopyPageFormOptions(), ilObjPortfolioGUI\initCreateFromTemplateForm(), ilExSubmissionObjectGUI\setSelectedPortfolioTemplateObject(), and ilPortfolioRepositoryGUI\show().

+ Here is the caller graph for this function:

◆ initType()

ilObjPortfolioTemplate::initType ( )
protected

Reimplemented from ilObject2.

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

29 : void
30 {
31 $this->type = "prtt";
32 }

◆ isActivationLimited()

ilObjPortfolioTemplate::isActivationLimited ( )

Definition at line 133 of file class.ilObjPortfolioTemplate.php.

133 : bool
134 {
136 }

References $activation_limited.

Referenced by updateActivation().

+ Here is the caller graph for this function:

◆ setActivationEndDate()

ilObjPortfolioTemplate::setActivationEndDate ( ?int  $ending_time = null)

Definition at line 158 of file class.ilObjPortfolioTemplate.php.

158 : void
159 {
160 $this->activation_ending_time = $ending_time;
161 }

Referenced by doRead().

+ Here is the caller graph for this function:

◆ setActivationLimited()

ilObjPortfolioTemplate::setActivationLimited ( bool  $a_value)

Definition at line 138 of file class.ilObjPortfolioTemplate.php.

138 : void
139 {
140 $this->activation_limited = $a_value;
141 }

Referenced by doRead().

+ Here is the caller graph for this function:

◆ setActivationStartDate()

ilObjPortfolioTemplate::setActivationStartDate ( ?int  $starting_time = null)

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

153 : void
154 {
155 $this->activation_starting_time = $starting_time;
156 }

Referenced by doRead().

+ Here is the caller graph for this function:

◆ setActivationVisibility()

ilObjPortfolioTemplate::setActivationVisibility ( bool  $a_value)

Definition at line 143 of file class.ilObjPortfolioTemplate.php.

143 : void
144 {
145 $this->activation_visibility = $a_value;
146 }

Referenced by doRead().

+ Here is the caller graph for this function:

◆ updateActivation()

ilObjPortfolioTemplate::updateActivation ( )
protected

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

113 : void
114 {
115 // moved activation to ilObjectActivation
116 if (($this->ref_id ?? 0) > 0) {
117 ilObjectActivation::getItem($this->ref_id);
118
119 $item = new ilObjectActivation();
120 if (!$this->isActivationLimited()) {
121 $item->setTimingType(ilObjectActivation::TIMINGS_DEACTIVATED);
122 } else {
123 $item->setTimingType(ilObjectActivation::TIMINGS_ACTIVATION);
124 $item->setTimingStart($this->getActivationStartDate());
125 $item->setTimingEnd($this->getActivationEndDate());
126 $item->toggleVisible($this->getActivationVisibility());
127 }
128
129 $item->update($this->ref_id);
130 }
131 }
Class ilObjectActivation.

References getActivationEndDate(), getActivationStartDate(), getActivationVisibility(), ilObjectActivation\getItem(), isActivationLimited(), ilObjectActivation\TIMINGS_ACTIVATION, and ilObjectActivation\TIMINGS_DEACTIVATED.

Referenced by doCreate(), and doUpdate().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Field Documentation

◆ $activation_ending_time

int ilObjPortfolioTemplate::$activation_ending_time = 0
protected

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

◆ $activation_limited

bool ilObjPortfolioTemplate::$activation_limited = false
protected

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

Referenced by isActivationLimited().

◆ $activation_starting_time

int ilObjPortfolioTemplate::$activation_starting_time = 0
protected

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

◆ $activation_visibility

bool ilObjPortfolioTemplate::$activation_visibility = false
protected

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

Referenced by getActivationVisibility().


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