Source for file OCSP_GROUPTREE.phpclass

Documentation is available at OCSP_GROUPTREE.phpclass

  1. <?php
  2. /**
  3.   * Class file OCSP_GROUPTREE.phpclass
  4.   *
  5.   * @project    Open CSP-Management
  6.   * @package    user
  7.   *
  8.   * @author     Peter Krebs <pitlinz@users.sourceforge.net>
  9.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  10.   *
  11.   * @version    pk-03-12-30
  12.   * @version    $Id: OCSP_GROUPTREE.phpclass,v 1.13 2008/12/02 07:36:22 pitlinz Exp $
  13.   */
  14.  
  15.  
  16. if (!class_exists('OCSP_OBJ'))
  17. {
  18.     require_once __OCSP_PHPINCPATH__ . "common" . _OCSP_DIRSEP_ . "OCSP_OBJ.phpclass";
  19. }
  20.  
  21. if (!class_exists('OCSP_USER'))
  22. {
  23.     require_once dirname(__FILE__) . _OCSP_DIRSEP_ . "OCSP_USER.phpclass";
  24. }
  25.  
  26. /**#@+
  27.   * Constants for system group id's
  28.   * @since pk-08-03-13
  29.   */
  30.     define('_OCSP_GROUP_PUBLIC_',0);
  31.     define('_OCSP_GROUP_LOGGEDIN_',-1);
  32.     define('_OCSP_GROUP_ITEMAUTHOR_',-2);
  33.     
  34.     define('_OCSP_GROUP_PROJ_ADMINGRP_',-80);
  35.     define('_OCSP_GROUP_PROJ_EDITOR_GRP_',-81);
  36.     define('_OCSP_GROUP_PROJ_AUTHOR_GRP_',-82);
  37.     define('_OCSP_GROUP_PROJ_USER_GRP_',-83);
  38.             
  39.     define('_OCSP_GROUP_NOTLOGGEDIN_',-99);
  40.     define('_OCSP_GROUP_SYSTEMJOB_',-98);
  41.     define('_OCSP_GROUP_TERMINATOR_',-89); // don't check parents lower then this
  42.     
  43.     define('_OCSP_GROUP_ADMIN_',1);
  44.     define('_OCSP_GROUP_DBMS_',2);
  45.     
  46.     define('_OCSP_GROUP_CMSADMIN_',3);
  47.     define('_OCSP_GROUP_CMSEDITOR_',5);
  48.     define('_OCSP_GROUP_CMSAUTHOR_',6);
  49.     
  50.     define('_OCSP_GROUP_PRODUCTS_',7);
  51.     
  52.     define('_OCSP_GROUP_TEMPLATE_',4);
  53.     
  54.     define('_OCSP_GROUP_CLIADMIN_',10);
  55.     
  56.     define('_OCSP_GROUPRIGHTS_INSERT',32);
  57.     define('_OCSP_GROUPRIGHTS_EDIT',64);
  58.     define('_OCSP_GROUPRIGHTS_DELETE',96);
  59.     
  60. /**#@-*/ 
  61.     
  62. /**
  63.   * handels groups
  64.   *
  65.   * @project    Open CSP-Management
  66.   * @package    user
  67.   *
  68.   * @author     Peter Krebs <pitlinz@users.sourceforge.net>
  69.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  70.   *
  71.   * @since pk-08-03-12
  72.   * @version    $Id: OCSP_GROUPTREE.phpclass,v 1.13 2008/12/02 07:36:22 pitlinz Exp $
  73.   * 
  74.   */
  75. class OCSP_GROUPTREE
  76.     extends OCSP_OBJ 
  77. {
  78.  
  79.     /*** class constants  --------------------------------------------- */
  80.  
  81.     /**
  82.       * @constant string CLASS_SRC_FILE
  83.       * 
  84.       * @abstract
  85.       */
  86.     const CLASS_SRC_FILE = __FILE__;
  87.  
  88.     /*** class variables  --------------------------------------------- */
  89.            
  90.     /**
  91.      * singleton instance
  92.      *
  93.      * @var OCSP_GROUPTREE $instance 
  94.      */
  95.     private static $instance;
  96.  
  97.     
  98.     /*** attrubtes       --------------------------------------------- */
  99.     
  100.     /**
  101.      * @var array $myGroups 
  102.      */
  103.     protected $myGroups = array();
  104.     
  105.     /**
  106.      * @var array $groupChildren 
  107.      */
  108.     protected $myChildTree = array();
  109.      
  110.     
  111.     /**
  112.      * array with already seen group members
  113.      *
  114.      * @var array $myGroupMembers 
  115.      */
  116.     protected $myGroupMembers = array();
  117.  
  118.     /**
  119.      * array with already seen group admins
  120.      *
  121.      * @var array $myGroupAdmins 
  122.      */    
  123.     protected $myGroupAdmins  = array();
  124.     
  125.     /**
  126.      * flag to notice if the class attributes has changed
  127.      *
  128.      * @var boolean $hasChanged 
  129.      */
  130.     protected $hasChanged = false;
  131.     
  132.     /**
  133.      * array with checked groups for a user
  134.      * 
  135.      * $this->checkedgroups[M|A][usrId][grpId] = True
  136.      *
  137.      * @var array $checkedgroups 
  138.      */
  139.     private $checkedgroups = array();
  140.     
  141.     
  142.     /**
  143.      * returns the object instance
  144.      *
  145.      * @return OCSP_GROUPTREE 
  146.      */
  147.     public static function getInstance()
  148.     {
  149.         if (!self::$instance)
  150.         {
  151.             self::$instance = new OCSP_GROUPTREE();
  152.         }
  153.         return self::$instance;
  154.     }
  155.     
  156.       /**
  157.        * constructor
  158.        *
  159.        */
  160.       protected function __construct()
  161.       { 
  162.         $this->populateGroups();
  163.       }
  164.       
  165.       public function populateGroups($debug=false)
  166.       {
  167.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::populateGroups();");
  168.           
  169.           $this->myGroupAdmins     = array();
  170.           $this->myGroupMembers    = array();
  171.           
  172.           if (!($obj_db = OCSP_OBJ::currentUser()->getMyDBObj()))
  173.           {
  174.               throw new Exception(_OCSP_EXCEP_NODBCONN_);
  175.           }
  176.           $str_query = "SELECT * FROM T_SYS_GROUP ORDER BY GRP_PARENT";
  177.         if ($obj_cursor = $obj_db->query($str_query))
  178.         {
  179.             while($arr_row = $obj_cursor->fetchArrayFld())
  180.             {
  181.                 $this->myGroups[$arr_row['GRP_ID']]=$arr_row;
  182.                 $this->myChildTree[$arr_row['GRP_PARENT']][] = $arr_row['GRP_ID']; 
  183.             }
  184.         } else {
  185.             throw new Exception(_OCSP_EXCEP_QUERYFAILED_);    
  186.         }    
  187.       }
  188.  
  189.       /**
  190.        * returns a group row also for system groups
  191.        *
  192.        * @param int $aId 
  193.        * @param boolean $debug 
  194.        * 
  195.        * @return array 
  196.        */
  197.       public function getGroupRow($aId,$debug=False)
  198.       {
  199.            
  200.           switch (intval($aId))
  201.           {
  202.               case 0:
  203.                   return array('GRP_ID'=>0,'GRP_NAME'=>'[Public]');
  204.               case _OCSP_GROUP_LOGGEDIN_:
  205.                   return array('GRP_ID'=>_OCSP_GROUP_LOGGEDIN_,'GRP_NAME'=>'[Angemeldete Benutzer]','GRP_PARENT'=>_OCSP_GROUP_ADMIN_);
  206.               case _OCSP_GROUP_NOTLOGGEDIN_:
  207.                   return array('GRP_ID'=>_OCSP_GROUP_LOGGEDIN_,'GRP_NAME'=>'[nicht angemeldete Benutzer]','GRP_PARENT'=>_OCSP_GROUP_ADMIN_);                  
  208.               default:
  209.                   if (!isset($this->myGroups[$aId]))
  210.                   {
  211.                     if ($aId < 0) {
  212.                         return array('GRP_ID'=>$aId,'GRP_NAME'=>'[Systemgruppe]','GRP_PARENT'=>_OCSP_GROUP_ADMIN_);                      
  213.                     } else {
  214.                         throw new Exception(_OCSP_EXCEP_NOID_);
  215.                         return false;
  216.                     }
  217.                   } else {
  218.                       if ($this->userIsMember($aId,OCSP_OBJ::currentUser()->getId(),True,$debug))
  219.                       {
  220.                           return $this->myGroups[$aId];
  221.                       } else {
  222.                           return array('GRP_ID'=>$aId,'GRP_NAME'=>$this->myGroups[$aId]['GRP_NAME']);
  223.                       }
  224.                   }
  225.                   
  226.           }
  227.           return NULL;
  228.       }
  229.  
  230.       public function getGroupName($aId)
  231.       {
  232.           if ($arr_row = $this->getGroupRow($aId))
  233.           {
  234.               return $arr_row['GRP_NAME'];
  235.           }
  236.       }
  237.       
  238.       /**
  239.        * appends a child tree to $retArr
  240.        *
  241.        * @param array &$retArr 
  242.        * @param int $parentId 
  243.        * @param string $keyPrepend 
  244.        * @param boolean $debug 
  245.        * 
  246.        * @return array 
  247.        */
  248.       protected function _addChildGroupToArray(&$retArr,$parentId,$keyPrepend,$debug=false)
  249.       {
  250.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::_addChildGroupArray(Parent: " . $parentId . ")");
  251.           if (isset($this->myChildTree[$parentId]))
  252.           {
  253.               foreach($this->myChildTree[$parentId] as $int_grpId)
  254.               {
  255.                   if (!in_array($this->myGroups[$int_grpId],$retArr))
  256.                   {
  257.                         if (!($int_idx = intval($this->myGroups[$int_grpId]['GRP_SORTORDER'])))
  258.                       {
  259.                           $int_idx = 1;
  260.                       }      
  261.                       while(isset($retArr[$keyPrepend . sprintf("%04d",$int_idx)]))
  262.                       {
  263.                           $int_idx++;        
  264.                       }
  265.                     $retArr[$keyPrepend . sprintf("%04d",$int_idx)] = $this->myGroups[$int_grpId];
  266.                     $this->_addChildGroupToArray($retArr,$int_grpId,$keyPrepend . sprintf("%04d",$int_idx) . ".",$debug);
  267.                   } else {
  268.                       if ($debug) echoDebugLine(__FILE__,__LINE__,"<pre>" . print_r($this->myGroups[$int_grpId],True) . "</pre>");
  269.                                                                      
  270.                   }
  271.               }
  272.               return True;
  273.           } else {
  274.               return false;
  275.           }
  276.       }
  277.  
  278.       /**
  279.        * returns an array with all groups
  280.        *
  281.        * @param boolean $withSystemGroups 
  282.        * @param boolean $debug 
  283.        * 
  284.        * @return array 
  285.        */
  286.       public function getGroupTreeArray($debug=false)
  287.       {                    
  288.           if ($debug) echoDebugMethod(__FILE__,get_class($this),'OCSP_GROUPTREE::getGroupArray()');
  289.                     
  290.           foreach($this->myChildTree[0] as $int_grpId) 
  291.           {
  292.               if (!($int_idx = intval($this->myGroups[$int_grpId]['GRP_SORTORDER'])))
  293.               {
  294.                   $int_idx = 1;
  295.               }
  296.             while(isset($arr_ret[sprintf("%04d",$int_idx)]))
  297.             {
  298.                 $int_idx++;
  299.             }
  300.             $arr_ret[sprintf("%04d",$int_idx)] = $this->myGroups[$int_grpId];
  301.             $this->_addChildGroupToArray($arr_ret,$int_grpId,sprintf("%04d",$int_idx) . ".",$debug);            
  302.           }
  303.           ksort($arr_ret);
  304.           return $arr_ret;
  305.       }
  306.       
  307.       /**
  308.        * returns an array with the 1st level children of a group
  309.        * 
  310.        * @param int $parentId 
  311.        * @param boolean $debug 
  312.        * 
  313.        * @return array 
  314.        * 
  315.        * @since pk-08-03-27
  316.        */
  317.       public function getChildGroups($parentId,$debug=false)
  318.       {
  319.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::getChildGroups(".intval($parentId). ")");
  320.           if (isset($this->myChildTree[$parentId]))
  321.           {
  322.               $arr_ret = array();
  323.               foreach($this->myChildTree[$parentId] as $int_grpId)
  324.               {
  325.                   $arr_ret[$int_grpId] = $this->myGroups[$int_grpId];
  326.               }
  327.               return $arr_ret;
  328.           } else {
  329.               return array();
  330.           }
  331.       }
  332.       
  333.       /**
  334.        * returns an array with all children (including childrens of children) of a group
  335.        *
  336.        * @param int $parentId 
  337.        * @param array $setGroups already set groups to avoid loops on misconfigured groups
  338.        * @param boolean $debug 
  339.        * 
  340.        * @return array 
  341.        * 
  342.        * @since pk-08-06-05
  343.        */
  344.       public function getAllChildGroups($parentId,$setGroups=Null,$debug=False)
  345.       {
  346.           $arr_ret=$this->getChildGroups($parentId,$debug);
  347.           
  348.           foreach($arr_ret as $grp_id => $arr_grps)
  349.           {
  350.               if (!isset($setGroups[$grp_id]))
  351.               {
  352.                   $arr_ret = array_merge($arr_ret,$this->getAllChildGroups($grp_id,$arr_ret,$debug));
  353.               }
  354.           }          
  355.           return $arr_ret;
  356.       }
  357.       
  358.       private function _usrGroupTreeSetShow(&$arr_groups,$grpId,$debug)
  359.       {
  360.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::_usrGroupTreeSetShow();");
  361.           if ($int_parent = intval($this->myGroups[$grpId]['GRP_PARENT']))
  362.           {
  363.               if (!$arr_groups[$int_parent]['SHOW'])
  364.               {
  365.                   $arr_groups[$int_parent]['SHOW']=True;
  366.                   if (($int_parent > _OCSP_GROUP_TERMINATOR_ ) && ($int_parent != _OCSP_GROUP_ADMIN_))
  367.                   {
  368.                       $this->_usrGroupTreeSetShow($arr_groups,$int_parent,$debug); 
  369.                   }
  370.               }
  371.           }
  372.       }
  373.       
  374.       /**
  375.        * returns the group tree with additional informations for the current user
  376.        *
  377.        * the return array looks like:
  378.        *     - GRP_ID
  379.        *         - TREEIDX (0001.0001. ...)
  380.        *         - ROW (the database row of the group)
  381.        *         - MEMBER (the user is member of the group)
  382.        *         - ADMIN (the user is admin of the group)
  383.        *         - SHOW (the group is on the pass to a group the user is member or admin)
  384.        * 
  385.        * @param boolean $debug 
  386.        * 
  387.        * @return array 
  388.        */
  389.       public function getUserGroupTreeArray($debug=false)
  390.       {
  391.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::getUserGroupTreeArray()");
  392.           
  393.           $arr_grps = $this->getGroupTreeArray($debug);
  394.         $arr_ret = array();          
  395.           foreach($arr_grps as $str_key => $arr_row)
  396.           {
  397.               $arr_ret[$arr_row['GRP_ID']]['TREEIDX'] = $str_key;
  398.               $arr_ret[$arr_row['GRP_ID']]['ROW'] = $arr_row;
  399.               if ($this->userIsMember($arr_row['GRP_ID'],OCSP_OBJ::currentUser()->getId(),false,$debug))
  400.               {
  401.                   $arr_ret[$arr_row['GRP_ID']]['MEMBER']=True;
  402.               } else {
  403.                   $arr_ret[$arr_row['GRP_ID']]['MEMBER']=false;
  404.               }
  405.               if ($this->userIsAdmin($arr_row['GRP_ID'],OCSP_OBJ::currentUser()->getId(),false,$debug))
  406.               {
  407.                   $arr_ret[$arr_row['GRP_ID']]['ADMIN']=True;
  408.               } else {
  409.                   $arr_ret[$arr_row['GRP_ID']]['ADMIN']=false;
  410.               }
  411.               
  412.               if ($arr_ret[$arr_row['GRP_ID']]['MEMBER'] || $arr_ret[$arr_row['GRP_ID']]['ADMIN'])
  413.               {              
  414.                   $arr_ret[$arr_row['GRP_ID']]['SHOW']=True;
  415.                   $this->_usrGroupTreeSetShow($arr_ret,$arr_row['GRP_ID'],$debug);
  416.               } else {
  417.                   $arr_ret[$arr_row['GRP_ID']]['SHOW']=false;
  418.               }
  419.           }
  420.           
  421.           return $arr_ret;
  422.       }
  423.       
  424.       // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  425.       // user methods
  426.       // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~      
  427.       
  428.       /**
  429.        * returns if a user is member of a group
  430.        * 
  431.        * - an entry in T_SYS_GROUPMEMBER is found
  432.        * - the user is member of a parent group
  433.        * - GRP_PASSDOWN_RIGHTS = 1 and user is member of a direct children
  434.        *
  435.        * @param int $grpId 
  436.        * @param int $usrId 
  437.        * @param boolean $withAdmin (include group admins)
  438.        * @param boolean $debug 
  439.         * 
  440.        * @global $OCSP_OBJ 
  441.        * 
  442.        * @return boolean 
  443.        * 
  444.        * @version pk-08-03-29
  445.        */
  446.       public function userIsMember($grpId,$usrId,$withAdmin=false,$debug=false)
  447.       {                   
  448.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::userIsMember(".$grpId.",".$usrId."," . ($withAdmin ? "True" : "False") . ")");
  449.                 
  450.           if (!($grpId = intval($grpId)))
  451.           {
  452.               return True; // everybody is member of puplic
  453.           }
  454.           
  455.           if (!($usrId)) // <pk-08-03-29>
  456.           {
  457.             if ($grpId == _OCSP_GROUP_NOTLOGGEDIN_) {
  458.                   return True;
  459.               } else {
  460.                   if ($debug) echoDebugLine(__FILE__,__LINE__,"return false");
  461.                   return False;
  462.               }
  463.           }
  464.           
  465.           
  466.           
  467.           if (isset($this->checkedgroups['M'][$usrId][$grpId][intval($withAdmin)]))
  468.           {
  469.               if ($debug) echoDebugLine(__FILE__,__LINE__,"group {$grpId} already checked");
  470.               if ($withAdmin)
  471.               {
  472.                   if (isset($this->myGroupMembers[$grpId]) && is_array($this->myGroupMembers[$grpId]))
  473.                   {
  474.                        if (in_array($usrId,$this->myGroupMembers[$grpId]))
  475.                       {
  476.                           return True;
  477.                       }    
  478.                   } else if (isset($this->myGroupAdmins[$grpId]) && is_array($this->myGroupAdmins[$grpId])) {
  479.                       return (in_array($usrId,$this->myGroupAdmins[$grpId]));                      
  480.                   } else {
  481.                       if ($debug) echoDebugLine(__FILE__,__LINE__,"return false");
  482.                       return False;
  483.                   }
  484.               } else {
  485.                   if (isset($this->myGroupMembers[$grpId]) && is_array($this->myGroupMembers[$grpId]))
  486.                   {
  487.                       return (in_array($usrId,$this->myGroupMembers[$grpId]));
  488.                   } else {
  489.                       if ($debug) echoDebugLine(__FILE__,__LINE__,"return false");
  490.                       return False;
  491.                   }
  492.               }
  493.           }
  494.           
  495.           $this->checkedgroups['M'][$usrId][$grpId][intval($withAdmin)] = True;
  496.           
  497.           if ($grpId < 0)
  498.           {
  499.               if (OCSP_OBJ::currentUser()->getId() == $usrId)
  500.               {
  501.                   $obj_user = OCSP_OBJ::currentUser();
  502.               } else if (!($obj_user = OCSP_USER::factoryFromId($usrId,$debug))) {
  503.                   throw new Exception(_OCSP_EXCEP_NOUSER_);
  504.               }
  505.  
  506.               switch($grpId)
  507.               {
  508.                   case _OCSP_GROUP_LOGGEDIN_:
  509.                       return (intval(OCSP_OBJ::currentUser()->getId()) ? True : false);
  510.                   case _OCSP_GROUP_NOTLOGGEDIN_:
  511.                       return (intval(OCSP_OBJ::currentUser()->getId()) ? false : True);                  
  512.               }
  513.               
  514.               if ($debug) echoDebugLine(__FILE__,__LINE__,"return false");
  515.               return False;
  516.           }
  517.                     
  518.           if (isset($this->myGroupMembers[$grpId]) && is_array($this->myGroupMembers[$grpId]) && in_array($usrId,$this->myGroupMembers[$grpId]))
  519.           {              
  520.               return True;
  521.           }
  522.           
  523.           if ($withAdmin && isset($this->myGroupAdmins[$grpId]) && is_array($this->myGroupAdmins[$grpId]) && in_array($usrId,$this->myGroupAdmins[$grpId]))
  524.           {
  525.               return True;    
  526.           }                    
  527.           
  528.           // nothing cached here ask the user for direct assignment
  529.           if (OCSP_OBJ::currentUser()->getId() == $usrId)
  530.           {
  531.               $obj_user = OCSP_OBJ::currentUser();
  532.           } else if (!($obj_user = OCSP_USER::factoryFromId($usrId,$debug))) {
  533.               throw new Exception(_OCSP_EXCEP_NOUSER_);
  534.           }
  535.           
  536.           if ($withAdmin && ($grpId != _OCSP_GROUP_ADMIN_) && $obj_user->isAdmin())
  537.           {
  538.               $this->myGroupAdmins[$grpId][] = $obj_user->getId();
  539.               return True;
  540.           }
  541.                     
  542.           try {
  543.               $arr_usrGrps = $obj_user->getDirectAssignedGroups(false,$debug);
  544.           } catch (Exception $e) {
  545.             if ($debug) echoDebugLine(__FILE__,__LINE__,"Exception: " . $e->getMessage());
  546.           }
  547.  
  548.         if (is_array($arr_usrGrps))
  549.         {
  550.               $b_found = false;
  551.               foreach($arr_usrGrps as $int_grpId)
  552.               {
  553.                 if ($int_grpId == $grpId) 
  554.                 {
  555.                     $b_found=True;
  556.                 }
  557.                 if (!isset($this->myGroupMembers[$int_grpId]) || !is_array($this->myGroupMembers[$int_grpId]))
  558.                 {
  559.                     $this->myGroupMembers[$int_grpId]     = array();
  560.                     $this->myGroupMembers[$int_grpId][] = $obj_user->getId();
  561.                 }
  562.                 else if (!in_array($obj_user->getId(),$this->myGroupMembers[$int_grpId]))
  563.                 {                
  564.                     $this->myGroupMembers[$int_grpId][] = $obj_user->getId();
  565.                 }
  566.               }
  567.               $this->hasChanged = True;
  568.               if ($b_found) 
  569.               {
  570.                   return True;
  571.               }
  572.         }
  573.  
  574.         if ($withAdmin)
  575.         {
  576.                 try {
  577.                   $arr_adminGrps = $obj_user->getDirectAssignedAdminGroups(false,$debug);
  578.               } catch (Exception $e) {
  579.                 if ($debug) echoDebugLine(__FILE__,__LINE__,"Exception: " . $e->getMessage());
  580.               }
  581.               
  582.             if (is_array($arr_adminGrps))
  583.             {
  584.                   $b_found = false;
  585.                   foreach($arr_adminGrps as $int_grpId)
  586.                   {
  587.                     if ($int_grpId == $grpId) 
  588.                     {
  589.                         $b_found=True;
  590.                     }
  591.                     if (!isset($this->myGroupAdmins[$int_grpId]) || !is_array($this->myGroupAdmins[$int_grpId]) || !in_array($obj_user->getId(),$this->myGroupAdmins[$int_grpId]))
  592.                     {
  593.                         $this->myGroupAdmins[$int_grpId][] = $obj_user->getId();
  594.                     }
  595.                   }
  596.                   $this->hasChanged = True;
  597.                   if ($b_found) 
  598.                   {
  599.                       return True;
  600.                   }
  601.             }              
  602.         }        
  603.         
  604.         // no direct assignment -> check children
  605.         
  606.         if (intval($this->myGroups[$grpId]['GRP_PASSDOWN_RIGHTS']))
  607.         {
  608.             if (isset($this->myChildTree[$grpId]))
  609.             {
  610.                 foreach($this->myChildTree[$grpId] as $int_grpId)
  611.                 {
  612.                     if (!isset($this->checkedgroups['M'][$usrId][$grpId][intval($withAdmin)]))
  613.                     {
  614.                         if ($this->userIsMember($int_grpId,$usrId,$withAdmin,$debug))
  615.                         {
  616.                             $this->myGroupMembers[$grpId]=$usrId;
  617.                             $this->hasChanged = True;
  618.                             return True;
  619.                         }
  620.                         $checkedGroups[$int_grpId] = True;
  621.                     }
  622.                 }
  623.             }
  624.         }
  625.         
  626.         // no direct assignment -> check parents
  627.         
  628.         if (($int_parentId = intval($this->myGroups[$grpId]['GRP_PARENT'])) && ($int_parentId > 0))
  629.         {
  630.             if ($debug) echoDebugLine(__FILE__,__LINE__,"checking parent group: {$int_parentId}");
  631.             if ($this->userIsMember($int_parentId,$usrId,$withAdmin,$debug))
  632.             {
  633.                 $this->myGroupMembers[$grpId][] = $usrId;
  634.                 $this->hasChanged = True;
  635.                 return True;
  636.             }
  637.         }
  638.                           
  639.         // finaly check for admin
  640.         
  641.         if ($withAdmin && $int_admGrp = intval($this->myGroups[$grpId]['GRP_PARENT']))
  642.         {
  643.             if ($this->userIsMember($int_admGrp,$usrId,True,$debug))
  644.             {
  645.                 $this->myGroupAdmins[$grpId][]=$usrId;
  646.                 $this->hasChanged = True;
  647.                 return True;
  648.             }
  649.         }
  650.         
  651.         return false;
  652.       }
  653.       
  654.     /**
  655.      * returns if a user is admin of $grpId
  656.      *
  657.      * @param int $grpId 
  658.      * @param int $usrId 
  659.      * @param boolean $debug 
  660.      * 
  661.      * @global array $OCSP_OBJ 
  662.      * 
  663.      * @return boolean 
  664.      * 
  665.      * @version pk-08-03-29
  666.      */
  667.       public function userIsAdmin($grpId,$usrId,$debug=false)
  668.       {                    
  669.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::userIsAdmin(". $grpId . "," . $usrId . ")");
  670.           
  671.             if (!($usrId)) // <pk-08-03-29>
  672.           {
  673.               return False;
  674.           }          
  675.           
  676.           $this->checkedgroups['A'][$usrId][$grpId]=True;
  677.           
  678.           if (isset($this->myGroupAdmins[$grpId]) && is_array($this->myGroupAdmins[$grpId]) && in_array($usrId,$this->myGroupAdmins[$grpId]))
  679.           {
  680.               if ($debug) echoDebugLine(__FILE__,__LINE__,"returning True");
  681.               return True;
  682.           }
  683.           
  684.           // nothing cached here ask the user for direct assignment
  685.           if (OCSP_OBJ::currentUser()->getId() == $usrId)
  686.           {
  687.               $obj_user = OCSP_OBJ::currentUser();
  688.           } else if (!($obj_user = OCSP_USER::factoryFromId($usrId,$debug))) {
  689.               throw new Exception(_OCSP_EXCEP_NOUSER_);
  690.               if ($debug) echoDebugLine(__FILE__,__LINE__,"returning FALSE");
  691.               return false;
  692.           }          
  693.           
  694.           try {
  695.               $arr_adminGrps = $obj_user->getDirectAssignedAdminGroups(false,$debug);
  696.           } catch (Exception $e) {
  697.             if ($debug) echoDebugLine(__FILE__,__LINE__,"Exception: " . $e->getMessage());
  698.             $arr_adminGrps = NULL;
  699.           }
  700.               
  701.         if (is_array($arr_adminGrps))
  702.         {
  703.               $b_found = false;
  704.               foreach($arr_adminGrps as $int_grpId)
  705.               {
  706.                 if ($int_grpId == $grpId) 
  707.                 {
  708.                     $b_found=True;
  709.                 }
  710.                 if (!isset($this->myGroupAdmins[$int_grpId]) || !is_array($this->myGroupAdmins[$int_grpId]) || !in_array($obj_user->getId(),$this->myGroupAdmins[$int_grpId]))
  711.                 {
  712.                     $this->myGroupAdmins[$int_grpId][] = $obj_user->getId();
  713.                 }
  714.               }
  715.               if ($debug) echoDebugLine(__FILE__,__LINE__,"cached: <pre>" . print_r($this->myGroupAdmins,True) . "</pre>");
  716.               $this->hasChanged = True;
  717.               if ($b_found) 
  718.               {
  719.                   if ($debug) echoDebugLine(__FILE__,__LINE__,"returning True");
  720.                   return True;
  721.               }
  722.         }  
  723.  
  724.         if ($int_admGrp = intval($this->myGroups[$grpId]['GRP_ADMINGRP']))
  725.         {
  726.             if ($debug) echo "<p>checking admingroup " . $int_admGrp . " for " . $grpId . "</p>";                
  727.             if ($this->userIsMember($int_admGrp,$usrId,True,$debug))
  728.             {
  729.                 $this->hasChanged = True;
  730.                 $this->myGroupAdmins[$grpId][] = $usrId;
  731.                 return True;
  732.             }
  733.         }
  734.         
  735.           if ($int_parentId = intval($this->myGroups[$grpId]['GRP_PARENT']))
  736.         {
  737.             if ($this->userIsAdmin($int_parentId,$usrId,$debug))
  738.             {
  739.                 $this->myGroupAdmins[$grpId][] = $usrId;
  740.                 $this->hasChanged = True;
  741.                 return True;
  742.             }
  743.         }        
  744.         
  745.         return $this->userIsMember(1,$usrId); // <pk-08-06-12 />
  746.  
  747.         //return false;
  748.       }
  749.                   
  750.       // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  751.       // db methods
  752.       // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  753.       
  754.       /**
  755.        * adds a user to a group
  756.        *
  757.        * @param int $usrId 
  758.        * @param int $grpId 
  759.        * @param boolean $readOnlay 
  760.        * @param boolean $asAdmin 
  761.        * @param boolean $debug 
  762.        * 
  763.        * @version pk-08-06-12
  764.        */
  765.       public function addUserToGroup($usrId,$grpId,$readOnlay=False,$asAdmin=False,$debug=False)
  766.       {
  767.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::addUserToGroup();");
  768.               
  769.           $bol_canChange = False;
  770.           if ($arr_grpRow = $this->getGroupRow($grpId))
  771.           {
  772.               if ($this->userIsAdmin($grpId,OCSP_OBJ::currentUser()->getId()))
  773.               {
  774.                   $bol_canChange=True;
  775.               } else {
  776.                   if (($arr_grpRow['GRP_SELFSELECT']) && (OCSP_OBJ::currentUser(True)->getId() == $usrId)) 
  777.                   {
  778.                       $bol_canChange=True;
  779.                   }
  780.               }
  781.               
  782.               if ($bol_canChange)
  783.               {
  784.                   $this->myGroupMembers[$grpId][]=$usrId;
  785.                   $arr_row = array(
  786.                           'GRP_ID'         => $grpId,
  787.                           'USR_ID'         => $usrId,
  788.                           'GRP_ISADMIN'     => ($asAdmin ? 1 : 0),
  789.                           'GRP_READONLY'     => ($readOnly ? 1 : 0)
  790.                       );
  791.                   $obj_db = OCSP_OBJ::currentUser()->getMyDBObj();
  792.                 return $obj_db->replaceArray('T_SYS_GROUPMEMBER',$arr_row);
  793.               } else {
  794.                   throw new Exception('_OCSP_EXCEP_NORIGHTS_');
  795.               }
  796.           }          
  797.       }
  798.       
  799.       /**
  800.        * removes a user from a group
  801.        *
  802.        * @param int $usrId 
  803.        * @param int $grpId 
  804.        */
  805.       public function removeUserFromGroup($usrId,$grpId)
  806.       {
  807.           if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::addUserToGroup();");
  808.           
  809.           $bol_canChange = False;
  810.           if ($arr_grpRow = $this->getGroupRow($grpId))
  811.           {
  812.               if ($this->userIsAdmin($grpId,OCSP_OBJ::currentUser()->getId()))
  813.               {
  814.                   $bol_canChange=True;
  815.               } else {
  816.                   if (($arr_grpRow['GRP_SELFSELECT']) && (OCSP_OBJ::currentUser(True)->getId() == $usrId)) 
  817.                   {
  818.                       $bol_canChange=True;
  819.                   }
  820.               }
  821.               
  822.               if ($bol_canChange)
  823.               {
  824.                   $str_cmd = "DELETE FROM T_SYS_GROUPMEMBER ";
  825.                   $str_cmd .= " WHERE GRP_ID=" . intval($grpId);
  826.                   $str_cmd .= "   AND USR_ID=" . intval($usrId);
  827.                   $obj_db = OCSP_OBJ::currentUser()->getMyDBObj();
  828.                   $obj_db->executeCmd($str_cmd);
  829.               }
  830.           } else {
  831.               throw new Exception('_OCSP_EXCEP_NORIGHTS_');
  832.           }          
  833.       }      
  834.       
  835.  
  836.     /**
  837.      * sets a users admin flag
  838.      *
  839.      * @param int $usrId 
  840.      * @param int $grpId 
  841.      * @param boolean $asAdmin 
  842.      * @param boolean $debug 
  843.      *
  844.      * @since pk-08-06-12
  845.      *
  846.      */
  847.     public function setUsersAdminFlag($usrId,$grpId,$asAdmin,$debug=False)
  848.     {
  849.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::setUsersAdminFlag({$usrId},{$grpId}," . ($asAdimn ? "True" : "False"). ")");
  850.           $bol_canChange = False;
  851.           if ((intval($grpId) > 0) && ($arr_grpRow = $this->getGroupRow($grpId)))
  852.           {
  853.               if ($this->userIsAdmin($grpId,OCSP_OBJ::currentUser()->getId()))
  854.               {
  855.                   $bol_canChange=True;
  856.               } else {
  857.                   if (($arr_grpRow['GRP_SELFSELECT']) && (OCSP_OBJ::currentUser(True)->getId() == $usrId)) 
  858.                   {
  859.                       $bol_canChange=True;
  860.                   }
  861.               }
  862.               
  863.               if ($bol_canChange)
  864.               {        
  865.                   $str_cmd = "UPDATE T_SYS_GROUPMEMBER ";
  866.                 $str_cmd .= " SET GRP_ISADMIN=" . ($asAdmin ? "1" : "0");
  867.                   $str_cmd .= " WHERE GRP_ID=" . intval($grpId);
  868.                   $str_cmd .= "   AND USR_ID=" . intval($usrId);
  869.                   $obj_db = OCSP_OBJ::currentUser()->getMyDBObj();
  870.                   $obj_db->executeCmd($str_cmd);
  871.                 if ($debug) echoDebugLine(__FILE__,__LINE__,"Command: " . $str_cmd);
  872.  
  873.                 if ($asAdmin)
  874.                 {
  875.                     $this->myGroupAdmins[$grpId][]= $usrId;
  876.                 } else if(isset($this->myGroupAdmins[$grpId])) {
  877.                     $arr_keys = array_flip($this->myGroupAdmins[$grpId]);
  878.                     if (isset($arr_keys[$usrId]))
  879.                     {
  880.                         unset($this->myGroupAdmins[$grpId][$arr_keys[$usrId]]);
  881.                     }
  882.                 }
  883.               } else {
  884.                   throw new Exception('_OCSP_EXCEP_NORIGHTS_');
  885.               }          
  886.           } else {
  887.               throw new Exception('_OCSP_EXCEP_NORIGHTS_');
  888.           }          
  889.       }      
  890.  
  891.     /**
  892.      * sets a users read only flag
  893.      *
  894.      * @param int $usrId 
  895.      * @param int $grpId 
  896.      * @param boolean $asAdmin 
  897.      * @param boolean $debug 
  898.      *
  899.      * @since pk-08-06-12
  900.      *
  901.      */
  902.     public function setUsersROFlag($usrId,$grpId,$readOnly,$debug=False)
  903.     {
  904.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"OCSP_GROUPTREE::setUsersAdminFlag({$usrId},{$grpId}," . ($readOnly ? "True" : "False"). ")");
  905.           $bol_canChange = False;
  906.           if ((intval($grpId) > 0) && ($arr_grpRow = $this->getGroupRow($grpId)))
  907.           {
  908.               if ($this->userIsAdmin($grpId,OCSP_OBJ::currentUser()->getId()))
  909.               {
  910.                   $bol_canChange=True;
  911.               } else {
  912.                   if (($arr_grpRow['GRP_SELFSELECT']) && (OCSP_OBJ::currentUser(True)->getId() == $usrId)) 
  913.                   {
  914.                       $bol_canChange=True;
  915.                   }
  916.               }
  917.               
  918.               if ($bol_canChange)
  919.               {        
  920.                   $str_cmd = "UPDATE T_SYS_GROUPMEMBER ";
  921.                 $str_cmd .= " SET GRP_READONLY=" . ($readOnly ? "1" : "0");
  922.                   $str_cmd .= " WHERE GRP_ID=" . intval($grpId);
  923.                   $str_cmd .= "   AND USR_ID=" . intval($usrId);
  924.                   $obj_db = OCSP_OBJ::currentUser()->getMyDBObj();
  925.                   $obj_db->executeCmd($str_cmd);
  926.                 if ($debug) echoDebugLine(__FILE__,__LINE__,"Command: " . $str_cmd);
  927.  
  928.               } else {
  929.                   throw new Exception('_OCSP_EXCEP_NORIGHTS_');
  930.               }          
  931.           } else {
  932.               throw new Exception('_OCSP_EXCEP_NORIGHTS_');
  933.           }          
  934.       }      
  935.  
  936.  
  937. }
  938. ?>

Documentation generated on Thu, 08 Jan 2009 17:46:49 +0100 by phpDocumentor 1.4.0a2