ILIAS  release_8 Revision v8.19
All Data Structures Namespaces Files Functions Variables Modules Pages
ilObjPortfolio 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 ilObjPortfolio:
+ Collaboration diagram for ilObjPortfolio:

Public Member Functions

 setDefault (bool $a_value)
 
 isDefault ()
 
 deleteImage ()
 
 uploadImage (array $a_upload)
 
 isCommentsExportPossible ()
 Is export possible. More...
 
- Public Member Functions inherited from ilObjPortfolioBase
 __construct (int $a_id=0, bool $a_reference=true)
 
 setOnline (bool $a_value)
 
 isOnline ()
 
 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)
 
 getImage ()
 Get banner image. More...
 
 setImage (string $a_value)
 Set banner image. More...
 
 getImageFullPath (bool $a_as_thumb=false)
 Get banner image incl. More...
 
 deleteImage ()
 remove existing file More...
 
 uploadImage (array $a_upload)
 Upload new image file. More...
 
 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 ()
 
 cloneMetaData (ilObject $target_obj)
 
 cloneObject (int $target_id, int $copy_id=0, bool $omit_tree=false)
 
- Public Member Functions inherited from ilObject
 __construct (int $id=0, bool $reference=true)
 
 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 $desc)
 
 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...
 

Static Public Member Functions

static setUserDefault (int $a_user_id, ?int $a_portfolio_id=null)
 Set the user default portfolio. More...
 
static getPortfoliosOfUser (int $a_user_id)
 Get portfolios of user. More...
 
static getDefaultPortfolio (int $a_user_id)
 Get default portfolio of user. More...
 
static deleteUserPortfolios (int $a_user_id)
 Delete all portfolio data for user. More...
 
static getAvailablePortfolioLinksForUserIds (array $a_owner_ids, ?string $a_back_url=null)
 
static getAdvMDSubItemTitle (int $a_obj_id, string $a_sub_type, int $a_sub_id)
 
- Static Public Member Functions inherited from ilObjPortfolioBase
static lookupOnline (int $a_id)
 
static initStorage (int $a_id, string $a_subdir=null)
 Init file system storage. More...
 
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 _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 ()
 
 doReadCustom (array $a_row)
 
 doUpdate ()
 
 doUpdateCustom (array &$a_fields)
 
 deleteAllPages ()
 
 handleQuotaUpdate ()
 
- 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 $default = false
 
- Protected Attributes inherited from ilObjPortfolioBase
ILIAS Notes Service $notes
 
ilSetting $setting
 
bool $online = false
 
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
 
int $id
 
bool $referenced
 
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 = ""
 
bool $offline = false
 
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)
 
static createBlogInPersonalWorkspace (string $a_title)
 

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 Portfolio

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 23 of file class.ilObjPortfolio.php.

Member Function Documentation

◆ deleteAllPages()

ilObjPortfolio::deleteAllPages ( )
protected

Definition at line 71 of file class.ilObjPortfolio.php.

References ilPortfolioPage\getAllPortfolioPages().

71  : void
72  {
73  // delete pages
74  $pages = ilPortfolioPage::getAllPortfolioPages($this->id);
75  foreach ($pages as $page) {
76  $page_obj = new ilPortfolioPage($page["id"]);
77  $page_obj->setPortfolioId($this->id);
78  $page_obj->delete();
79  }
80  }
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...
+ Here is the call graph for this function:

◆ deleteImage()

ilObjPortfolio::deleteImage ( )

Definition at line 182 of file class.ilObjPortfolio.php.

References handleQuotaUpdate().

182  : void
183  {
184  if ($this->id) {
185  parent::deleteImage();
186  $this->handleQuotaUpdate();
187  }
188  }
+ Here is the call graph for this function:

◆ deleteUserPortfolios()

static ilObjPortfolio::deleteUserPortfolios ( int  $a_user_id)
static

Delete all portfolio data for user.

Definition at line 167 of file class.ilObjPortfolio.php.

Referenced by ilObjUser\delete().

167  : void
168  {
169  $all = self::getPortfoliosOfUser($a_user_id);
170  if ($all) {
171  $access_handler = new ilPortfolioAccessHandler();
172 
173  foreach ($all as $item) {
174  $access_handler->removePermission($item["id"]);
175 
176  $portfolio = new self($item["id"], false);
177  $portfolio->delete();
178  }
179  }
180  }
Access handler for portfolio NOTE: This file needs to stay in the classes directory, WAC will be confused otherwise.
+ Here is the caller graph for this function:

◆ doReadCustom()

ilObjPortfolio::doReadCustom ( array  $a_row)
protected

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

References setDefault().

51  : void
52  {
53  $this->setDefault((bool) $a_row["is_default"]);
54  }
setDefault(bool $a_value)
+ Here is the call graph for this function:

◆ doUpdate()

ilObjPortfolio::doUpdate ( )
protected

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

References isDefault(), ilObjPortfolioBase\isOnline(), and setDefault().

56  : void
57  {
58  // must be online to be default
59  if (!$this->isOnline() && $this->isDefault()) {
60  $this->setDefault(false);
61  }
62 
63  parent::doUpdate();
64  }
setDefault(bool $a_value)
+ Here is the call graph for this function:

◆ doUpdateCustom()

ilObjPortfolio::doUpdateCustom ( array &  $a_fields)
protected

Definition at line 66 of file class.ilObjPortfolio.php.

References isDefault().

66  : void
67  {
68  $a_fields["is_default"] = array("integer", $this->isDefault());
69  }
+ Here is the call graph for this function:

◆ getAdvMDSubItemTitle()

static ilObjPortfolio::getAdvMDSubItemTitle ( int  $a_obj_id,
string  $a_sub_type,
int  $a_sub_id 
)
static

Implements ilAdvancedMetaDataSubItems.

Definition at line 245 of file class.ilObjPortfolio.php.

245  : string
246  {
247  return \ilPortfolioPage::lookupTitle($a_sub_id);
248  }

◆ getAvailablePortfolioLinksForUserIds()

static ilObjPortfolio::getAvailablePortfolioLinksForUserIds ( array  $a_owner_ids,
?string  $a_back_url = null 
)
static

Definition at line 203 of file class.ilObjPortfolio.php.

References ilObject\$id, $params, $res, ilObject\$title, $url, and ilLink\_getLink().

Referenced by ilPublicUserProfileGUI\getEmbeddable(), ilLearningSequenceRoles\readMemberData(), ilObjGroupGUI\readMemberData(), and ilObjCourseGUI\readMemberData().

206  : array {
207  $res = array();
208 
209  $access_handler = new ilPortfolioAccessHandler();
210 
211  $params = null;
212  if ($a_back_url) {
213  $params = array("back_url" => rawurlencode($a_back_url));
214  }
215 
216  foreach ($access_handler->getShardObjectsDataForUserIds($a_owner_ids) as $owner_id => $items) {
217  foreach ($items as $id => $title) {
218  $url = ilLink::_getLink($id, 'prtf', $params);
219  $res[$owner_id][$url] = $title;
220  }
221  }
222 
223  return $res;
224  }
string $title
$res
Definition: ltiservices.php:69
if(! $DIC->user() ->getId()||!ilLTIConsumerAccess::hasCustomProviderCreationAccess()) $params
Definition: ltiregstart.php:33
Access handler for portfolio NOTE: This file needs to stay in the classes directory, WAC will be confused otherwise.
$url
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getDefaultPortfolio()

static ilObjPortfolio::getDefaultPortfolio ( int  $a_user_id)
static

Get default portfolio of user.

Definition at line 142 of file class.ilObjPortfolio.php.

References $DIC, $ilDB, $ilSetting, and $res.

Referenced by ilUserProfileBadge\evaluate(), ilPublicUserProfileGUI\getProfilePortfolio(), ilPersonalProfileGUI\getProfilePortfolio(), ilBuddySystemNotification\hasPublicProfile(), and ilPortfolioAccessHandler\syncProfile().

142  : ?int
143  {
144  global $DIC;
145 
146  $ilDB = $DIC->database();
147  $ilSetting = $DIC->settings();
148 
149  if (!$ilSetting->get('user_portfolios')) {
150  return null;
151  }
152 
153  $set = $ilDB->query("SELECT up.id FROM usr_portfolio up" .
154  " JOIN object_data od ON (up.id = od.obj_id)" .
155  " WHERE od.owner = " . $ilDB->quote($a_user_id, "integer") .
156  " AND up.is_default = " . $ilDB->quote(1, "integer"));
157  $res = $ilDB->fetchAssoc($set);
158  if ($res && $res["id"]) {
159  return (int) $res["id"];
160  }
161  return null;
162  }
$res
Definition: ltiservices.php:69
global $DIC
Definition: feed.php:28
global $ilSetting
Definition: privfeed.php:17
+ Here is the caller graph for this function:

◆ getPortfoliosOfUser()

static ilObjPortfolio::getPortfoliosOfUser ( int  $a_user_id)
static

Get portfolios of user.

Returns
array[]

Definition at line 119 of file class.ilObjPortfolio.php.

References $DIC, $ilDB, and $res.

Referenced by ilPortfolioTableGUI\getItems(), ilExSubmissionObjectGUI\getOverviewContentBlog(), ilPortfolioRepositoryGUI\getPortfolioList(), ilObjPortfolioGUI\initCopyPageFormOptions(), ilObjPortfolioTemplateGUI\initDidacticTemplate(), and ilExSubmissionObjectGUI\selectPortfolioObject().

121  : array {
122  global $DIC;
123 
124  $ilDB = $DIC->database();
125 
126  $set = $ilDB->query("SELECT up.*,od.title,od.description" .
127  " FROM usr_portfolio up" .
128  " JOIN object_data od ON (up.id = od.obj_id)" .
129  " WHERE od.owner = " . $ilDB->quote($a_user_id, "integer") .
130  " AND od.type = " . $ilDB->quote("prtf", "text") .
131  " ORDER BY od.title");
132  $res = array();
133  while ($rec = $ilDB->fetchAssoc($set)) {
134  $res[] = $rec;
135  }
136  return $res;
137  }
$res
Definition: ltiservices.php:69
global $DIC
Definition: feed.php:28
+ Here is the caller graph for this function:

◆ handleQuotaUpdate()

ilObjPortfolio::handleQuotaUpdate ( )
protected

Definition at line 199 of file class.ilObjPortfolio.php.

Referenced by deleteImage(), and uploadImage().

199  : void
200  {
201  }
+ Here is the caller graph for this function:

◆ initType()

ilObjPortfolio::initType ( )
protected

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

27  : void
28  {
29  $this->type = "prtf";
30  }

◆ isCommentsExportPossible()

ilObjPortfolio::isCommentsExportPossible ( )

Is export possible.

Definition at line 229 of file class.ilObjPortfolio.php.

References ilObjPortfolioBase\$setting, ilSetting\get(), and ilPrivacySettings\getInstance().

229  : bool
230  {
232  $privacy = ilPrivacySettings::getInstance();
233  if ($setting->get("disable_comments")) {
234  return false;
235  }
236  if (!$this->notes->domain()->commentsActive($this->id)) {
237  return false;
238  }
239  if (!$privacy->enabledCommentsExport()) {
240  return false;
241  }
242  return true;
243  }
get(string $a_keyword, ?string $a_default_value=null)
get setting
+ Here is the call graph for this function:

◆ isDefault()

ilObjPortfolio::isDefault ( )

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

References $default.

Referenced by doUpdate(), and doUpdateCustom().

41  : bool
42  {
43  return $this->default;
44  }
+ Here is the caller graph for this function:

◆ setDefault()

ilObjPortfolio::setDefault ( bool  $a_value)

Definition at line 36 of file class.ilObjPortfolio.php.

Referenced by doReadCustom(), and doUpdate().

36  : void
37  {
38  $this->default = $a_value;
39  }
+ Here is the caller graph for this function:

◆ setUserDefault()

static ilObjPortfolio::setUserDefault ( int  $a_user_id,
?int  $a_portfolio_id = null 
)
static

Set the user default portfolio.

Definition at line 90 of file class.ilObjPortfolio.php.

References $DIC, and $ilDB.

Referenced by ilPortfolioRepositoryGUI\setDefault(), ilPortfolioAccessHandler\syncProfile(), ilPortfolioRepositoryGUI\unsetDefault(), and ilObjPortfolioGUI\updateCustom().

93  : void {
94  global $DIC;
95 
96  $ilDB = $DIC->database();
97 
98  $all = array();
99  foreach (self::getPortfoliosOfUser($a_user_id) as $item) {
100  $all[] = $item["id"];
101  }
102  if ($all) {
103  $ilDB->manipulate("UPDATE usr_portfolio" .
104  " SET is_default = " . $ilDB->quote(false, "integer") .
105  " WHERE " . $ilDB->in("id", $all, "", "integer"));
106  }
107 
108  if ($a_portfolio_id) {
109  $ilDB->manipulate("UPDATE usr_portfolio" .
110  " SET is_default = " . $ilDB->quote(true, "integer") .
111  " WHERE id = " . $ilDB->quote($a_portfolio_id, "integer"));
112  }
113  }
global $DIC
Definition: feed.php:28
+ Here is the caller graph for this function:

◆ uploadImage()

ilObjPortfolio::uploadImage ( array  $a_upload)

Definition at line 190 of file class.ilObjPortfolio.php.

References handleQuotaUpdate().

190  : bool
191  {
192  if (parent::uploadImage($a_upload)) {
193  $this->handleQuotaUpdate();
194  return true;
195  }
196  return false;
197  }
+ Here is the call graph for this function:

Field Documentation

◆ $default

bool ilObjPortfolio::$default = false
protected

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

Referenced by isDefault().


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