File Source for OCSP_GROUP.phpclass

<?php
/**
* Class file ADDRESS.phpclass
*
* @project Open CSP-Management
* @package user
*
* @author Peter Krebs <pitlinz@users.sourceforge.net>
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
*
* @since pk-08-03-14
*
*/
if (!class_exists('DBMS_TABLEOBJ'))
{
require __OCSP_PHPINCPATH__."db/DBMS_TABLEOBJ.phpclass";
}
if (!class_exists('OCSP_GROUPTREE'))
{
require dirname(__FILE__) . _OCSP_DIRSEP_ . "OCSP_GROUPTREE.phpclass";
}
/**
* Class class OCSP_GROUP handles T_SYS_GROUP
*
* @project Open CSP-Management
* @package user
*
* @author Peter Krebs <pitlinz@users.sourceforge.net>
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
*
* @since pk-08-03-14
*
*/
class OCSP_GROUP
extends DBMS_TABLEOBJ
{
/**
* @constant string CLASS_SRC_FILE
*/
const CLASS_SRC_FILE = __FILE__;
/**
* @staticvar string $myTable name of the db table
*/
protected $myTable="T_SYS_GROUP";
// ------------------------------------------------------
// factory
// ------------------------------------------------------
/**
* factory a group object
*
* @param int $aId
* @param boolean $debug
*
* @return OCSP_GROUP
*
*/
public static function factory_fromId($aId,$debug=false)
{
$obj_grpTree = OCSP_GROUPTREE::getInstance();
if ($obj_grpTree->userIsMember($aId,OCSP_OBJ::currentUser()->getId()))
{
$obj_ret = new OCSP_GROUP();
$obj_ret->setDBRow($obj_grpTree->getGroupRow($aId),true,$debug);
return $obj_ret;
}
return NULL;
}
// ------------------------------------------------------
// construct
// ------------------------------------------------------
public function __construct($debug=False)
{
$this->init($debug);
}
// ------------------------------------------------------
// getter / setter
// ------------------------------------------------------
/**
* returns the group id
*
* @return int
*
* @since pk-08-05-09
*/
public function getId()
{
return intval($this->getDBField('GRP_ID'));
}
/**
* return the group name
*
* @return string
*
* @since pk-08-05-09
*/
public function getName()
{
if (intval($this->getId()))
{
return $this->getDBField('GRP_NAME');
} else {
return "PUBLIC";
}
}
// ------------------------------------------------------
// tree
// ------------------------------------------------------
/**
* returns if the group is a child of $aGrpId
*
* @param int $aGrpId
*
* @return boolean
*
* @since pk-08-05-09
*/
public function isChildOf($aGrpId)
{
return ((intval($this->getDBField('GRP_PARENT')) == intval($aGrpId)) ? True : False);
}
/**
* returns an array of child objects
*
* if $childClass isset the class must have been loaded already
*
* @param string $childClass class of the children
* @param boolean $debug
*
* @return array
*/
public function getChildren($childClass='OCSP_GROUP',$debug=False)
{
if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUP::getChildren(" . $childClass . ")");
if (!class_exists($childClass))
{
throw new Exception(_OCSP_EXCEP_CLASSNOTFOUND_);
}
if (!$this->isConnected(True))
{
throw new Exception(_OCSP_EXCEP_NODBCONN_);
}
if ($arr_rows = $this->myDBObj->getArray($this->myTable,array('GRP_PARENT' => intval($this->getId())),0,0,'GRP_NAME',$debug))
{
$int_idx = 0;
$arr_ret = array();
foreach($arr_rows as $arr_row)
{
eval("\$arr_ret[" . $int_idx ."]=new ".$childClass."();");
$arr_ret[$int_idx]->setDBRow($arr_row,True);
$int_idx++;
}
if ($int_idx>0)
{
return $arr_ret;
}
}
return Null;
}
// ------------------------------------------------------
// db methods
// ------------------------------------------------------
/**
* inserts a new row to the table
*
* @param boolean $debug
*
* @returns int returns the autoIncFld ID if exists or 1 on success
*
*/
function dbInsert($debug=false)
{
if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUP::dbInsert()");
if (!$this->isConnected(True))
{
throw new Exception(_OCSP_EXCEP_NODBCONN_);
}
$this->setDBField('GRP_ID',$this->myDBObj->getOne("SELECT MAX(GRP_ID)+1 FROM " . $this->myTable));
if (parent::dbInsert($debug))
{
OCSP_GROUPTREE::getInstance()->populateGroups($debug);
return $this->getDBField('GRP_ID');
}
return Null;
}
/**
* replaces a row in the table
*
* @param boolean $debug show debug info
* @param boolean $ignorPopulated (if false the table MUST have been populated)
*
* @global array $OCSP_OBJ
*
* @returns boolean
*
*/
function dbReplace($debug=FALSE,$ignorPopulated=FALSE)
{
if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUP::dbReplace()");
if ($int_grpId = parent::dbReplace($debug,$ignorPopulated))
{
OCSP_GROUPTREE::getInstance()->populateGroups($debug);
}
return $int_grpId;
}
// ------------------------------------------------------
// rights
// ------------------------------------------------------
/**
* returns if the current user can edit the group
*
* @param boolean $debug
*
* @return boolean
*/
function userCanShow($debug=false)
{
if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUP::userCanEdit()");
if (!OCSP_OBJ::currentUser()) return false;
return OCSP_GROUPTREE::getInstance()->userIsMember($this->getDBField('GRP_ID'),OCSP_OBJ::currentUser()->getId(),true,$debug);
}
/**
* returns if the current user can edit the group
*
* @param boolean $debug
*
* @return boolean
*/
function userCanInsert($debug=false)
{
if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUP::userCanEdit()");
if (!OCSP_OBJ::currentUser()) return false;
if ($int_parent = intval($this->getDBField('GRP_PARENT')) && ($int_parent > 0))
{
return OCSP_GROUPTREE::getInstance()->userIsMember($int_parent,OCSP_OBJ::currentUser()->getId(),true,$debug);
} else {
return OCSP_OBJ::currentUser()->isAdmin();
}
return false;
}
/**
* returns if the current user can edit the group
*
* @param boolean $debug
*
* @return boolean
*/
function userCanEdit($debug=false)
{
if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUP::userCanEdit()");
if (!OCSP_OBJ::currentUser()) return false;
if ($int_grpId = $this->getDBField('GRP_ID') && ($int_grpId > 0))
{
return OCSP_GROUPTREE::getInstance()->userIsAdmin($int_grpId,OCSP_OBJ::currentUser()->getId(),$debug);
}
return false;
}
/**
* returns if the current user can delete the group
*
* @param boolean $debug
*
* @return boolean
*/
function userCanDelete($debug=false)
{
if ($debug) echoDebugMethod(__FILE__,get_class($this),"CLIENT::userCanDelete()");
if (!OCSP_OBJ::currentUser()) return false;
if ($int_grpId = intval($this->getDBField('GRP_ID')))
{
if (($int_grpId > 0) && ($int_grpId != _OCSP_GROUP_ADMIN_))
{
return OCSP_OBJ::currentUser()->isAdmin();
}
}
return false;
}
}
?>

Source for file OCSP_GROUP.phpclass