- added some more documentation

- no need to check for _parentID=0 or _parentID='' etc. Using empty()
  is sufficient
This commit is contained in:
steinm 2010-12-14 12:43:14 +00:00
parent fda33a7e2d
commit e6e5f7200c

View File

@ -140,7 +140,7 @@ class LetoDMS_Folder {
} /* }}} */
/**
* Return creation date of document
* Return creation date of folder
*
* @return integer unix timestamp of creation date
*/
@ -148,8 +148,13 @@ class LetoDMS_Folder {
return $this->_date;
} /* }}} */
/**
* Returns the parent
*
* @return object parent folder or false if there is no parent folder
*/
function getParent() { /* {{{ */
if ($this->_id == $this->_dms->rootFolderID || !isset($this->_parentID) || ($this->_parentID == null) || ($this->_parentID == "") || ($this->_parentID == 0)) {
if ($this->_id == $this->_dms->rootFolderID || empty($this->_parentID)) {
return false;
}
@ -159,10 +164,19 @@ class LetoDMS_Folder {
return $this->_parent;
} /* }}} */
/**
* Set a new folder
*
* This function moves a folder from one parent folder into another parent
* folder. It will fail if the root folder is moved.
*
* @param object new parent folder
* @return boolean true if operation was successful otherwise false
*/
function setParent($newParent) { /* {{{ */
$db = $this->_dms->getDB();
if ($this->_id == $this->_dms->rootFolderID || !isset($this->_parentID) || ($this->_parentID == null) || ($this->_parentID == "") || ($this->_parentID == 0)) {
if ($this->_id == $this->_dms->rootFolderID || empty($this->_parentID)) {
return false;
}
@ -198,12 +212,23 @@ class LetoDMS_Folder {
return true;
} /* }}} */
/**
* Returns the owner
*
* @return object owner of the folder
*/
function getOwner() { /* {{{ */
if (!isset($this->_owner))
$this->_owner = $this->_dms->getUser($this->_ownerID);
return $this->_owner;
} /* }}} */
/**
* Set the owner
*
* @param object new owner of the folder
* @return boolean true if successful otherwise false
*/
function setOwner($newOwner) { /* {{{ */
$db = $this->_dms->getDB();
@ -293,6 +318,13 @@ class LetoDMS_Folder {
return true;
} /* }}} */
/**
* Returns a list of subfolders
*
* @param string $orderby if set to 'n' the list is ordered by name, otherwise
* it will be ordered by sequence
* @return array list of folder objects or false in case of an error
*/
function getSubFolders($orderby="") { /* {{{ */
$db = $this->_dms->getDB();