class.ilObjOrgUnit.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */
require_once "./Services/Container/classes/class.ilContainer.php";
require_once("./Modules/OrgUnit/classes/class.ilOrgUnitImporter.php");
class ilObjOrgUnit extends ilContainer {

        protected static $root_ref_id;
        protected static $root_id;

        protected $employee_role;
        protected $superior_role;

        public function __construct($a_id = 0,$a_call_by_reference = true){
                $this->type = "orgu";
                $this->ilContainer($a_id,$a_call_by_reference);
        }

        public static function getRootOrgRefId(){
                self::loadRootOrgRefIdAndId();
                return self::$root_ref_id;
        }

        public static function getRootOrgId(){
                self::loadRootOrgRefIdAndId();
                return self::$root_id;
        }

        private static function loadRootOrgRefIdAndId(){
                if(self::$root_ref_id === Null || self::$root_id === null){
                        global $ilDB;
                        $q = "SELECT o.obj_id, r.ref_id FROM object_data o
                        INNER JOIN object_reference r ON r.obj_id = o.obj_id
                        WHERE title = ".$ilDB->quote('__OrgUnitAdministration', 'text')."";
                        $set = $ilDB->query($q);
                        $res = $ilDB->fetchAssoc($set);
                        self::$root_id = $res["obj_id"];
                        self::$root_ref_id= $res["ref_id"];
                }
        }

        private function loadRoles(){
                global $ilLog;
                        if(!$this->employee_role || !$this->superior_role){
                                $this->doLoadRoles();
                        }

                        if(!$this->employee_role || !$this->superior_role){
                                $this->initDefaultRoles();
                                $this->doLoadRoles();
                                if(!$this->employee_role || !$this->superior_role)
                                        throw new Exception("The standard roles the orgu object with id: ".$this->getId()." aren't initialized or have been deleted, newly creating them didn't work!");
                                else
                                        $ilLog->write("[".__FILE__.":".__LINE__."] The standard roles for the orgu obj with id: ".$this->getId()." were newly created as they couldnt be found.");
                        }
        }

        private function doLoadRoles(){
                global $ilDB;
                if(!$this->employee_role || !$this->superior_role){
                $q = "SELECT obj_id, title FROM object_data WHERE title LIKE 'il_orgu_employee_".$ilDB->quote($this->getRefId(),"integer")."' OR title LIKE 'il_orgu_superior_".$ilDB->quote($this->getRefId(),"integer")."'";
                $set = $ilDB->query($q);
                while($res = $ilDB->fetchAssoc($set)){
                        if($res["title"] == "il_orgu_employee_".$this->getRefId())
                                $this->employee_role = $res["obj_id"];
                        elseif($res["title"] == "il_orgu_superior_".$this->getRefId())
                                $this->superior_role = $res["obj_id"];
                }

                        if(!$this->employee_role || !$this->superior_role)
                                throw new Exception("The standard roles the orgu object with id: ".$this->getId()." aren't initialized or have been deleted!");
        }
        }

        public function assignUsersToEmployeeRole($user_ids){
                global $rbacadmin, $ilAppEventHandler;
                foreach($user_ids as $user_id)
        {
            $rbacadmin->assignUser($this->getEmployeeRole(), $user_id);

            $ilAppEventHandler->raise('Modules/OrgUnit',
                'assignUsersToEmployeeRole',
                array('object' => $this,
                    'obj_id' => $this->getId(),
                    'ref_id' =>  $this->getRefId(),
                    'role_id' => $this->getEmployeeRole(),
                    'user_id' => $user_id));
        }
        }

        public function assignUsersToSuperiorRole($user_ids){
                global $rbacadmin, $ilAppEventHandler;
                foreach($user_ids as $user_id)
        {
            $rbacadmin->assignUser($this->getSuperiorRole(), $user_id);

            $ilAppEventHandler->raise('Modules/OrgUnit',
                'assignUsersToSuperiorRole',
                array('object' => $this,
                    'obj_id' => $this->getId(),
                    'ref_id' =>  $this->getRefId(),
                    'role_id' => $this->getSuperiorRole(),
                    'user_id' => $user_id));
        }

        }

        public function deassignUserFromEmployeeRole($user_id){
                global $rbacadmin, $ilAppEventHandler;
                $rbacadmin->deassignUser($this->getEmployeeRole(), $user_id);

        $ilAppEventHandler->raise('Modules/OrgUnit',
            'deassignUserFromEmployeeRole',
            array('object' => $this,
                'obj_id' => $this->getId(),
                'ref_id' =>  $this->getRefId(),
                'role_id' => $this->getEmployeeRole(),
                'user_id' => $user_id));
        }

        public function deassignUserFromSuperiorRole($user_id){
                global $rbacadmin, $ilAppEventHandler;
                $rbacadmin->deassignUser($this->getSuperiorRole(), $user_id);


        $ilAppEventHandler->raise('Modules/OrgUnit',
            'deassignUserFromSuperiorRole',
            array('object' => $this,
                'obj_id' => $this->getId(),
                'ref_id' =>  $this->getRefId(),
                'role_id' => $this->getSuperiorRole(),
                'user_id' => $user_id));
        }

        public function setEmployeeRole($employee_role)
        {
                $this->employee_role = $employee_role;
        }

        public static function _exists($a_id, $a_reference = false){
                return parent::_exists($a_id, $a_reference, "orgu");
        }

        public function getEmployeeRole()
        {
                $this->loadRoles();
                return $this->employee_role;
        }

        public function setSuperiorRole($superior_role)
        {
                $this->superior_role = $superior_role;
        }

        public function getSuperiorRole()
        {
                $this->loadRoles();
                return $this->superior_role;
        }

        public function initDefaultRoles(){
                global $rbacadmin,$rbacreview, $ilAppEventHandler;

                $rolf_obj = $this->createRoleFolder();

                // CREATE Employee ROLE
                $role_obj = $rolf_obj->createRole("il_orgu_employee_".$this->getRefId(),"Emplyee of org unit obj_no.".$this->getId());
// = $
// EMPLOYEE DOES NOT YET NEED A ROLE TEMPLATE.
//              // SET PERMISSION TEMPLATE OF NEW LOCAL ADMIN ROLE
//              $query = "SELECT obj_id FROM object_data ".
//                      " WHERE type='rolt' AND title='il_orgu_employee'";
//
//              $res = $this->ilias->db->getRow($query, DB_FETCHMODE_OBJECT);
//              $rbacadmin->copyRoleTemplatePermissions($res->obj_id,ROLE_FOLDER_ID,$rolf_obj->getRefId(),$role_obj->getId());
//
//              // SET OBJECT PERMISSIONS OF COURSE OBJECT
//              $ops = $rbacreview->getOperationsOfRole($role_obj->getId(),"orgu",$rolf_obj->getRefId());
//              $rbacadmin->grantPermission($role_obj->getId(),$ops,$this->getRefId());

                // CREATE Superior ROLE
                $role_obj = $rolf_obj->createRole("il_orgu_superior_".$this->getRefId(),"Superior of org unit obj_no.".$this->getId());

                // SET PERMISSION TEMPLATE OF NEW LOCAL ADMIN ROLE
                $query = "SELECT obj_id FROM object_data ".
                        " WHERE type='rolt' AND title='il_orgu_superior'";

                $res = $this->ilias->db->getRow($query, DB_FETCHMODE_OBJECT);
                $rbacadmin->copyRoleTemplatePermissions($res->obj_id,ROLE_FOLDER_ID,$rolf_obj->getRefId(),$role_obj->getId());

                // SET OBJECT PERMISSIONS OF COURSE OBJECT
                $ops = $rbacreview->getOperationsOfRole($role_obj->getId(),"orgu",$rolf_obj->getRefId());
                $rbacadmin->grantPermission($role_obj->getId(),$ops,$this->getRefId());


        $ilAppEventHandler->raise('Modules/OrgUnit',
            'initDefaultRoles',
            array('object' => $this,
                  'obj_id' => $this->getId(),
                  'ref_id' =>  $this->getRefId(),
                  'role_superior_id' => $role_obj->getId(),
                  'role_employee_id' => $role_obj->getId()));

        }

        public function getTitle(){
                if(parent::getTitle() != "__OrgUnitAdministration")
                        return parent::getTitle();
                else
                        return $this->lng->txt("objs_orgu");
        }

        public function getTranslations(){
                global $lng, $ilDB;

        $translations = array();

                $q = "SELECT * FROM object_translation WHERE obj_id = ".
            $ilDB->quote($this->getId(),'integer')." ORDER BY lang_default DESC";
                $r = $this->ilias->db->query($q);

                $num = 0;

                while ($row = $r->fetchRow(DB_FETCHMODE_OBJECT))
        {
            $data["Fobject"][$num]= array("title"       => $row->title,
                "desc"  => $row->description,
                "lang"  => $row->lang_code
            );
            $num++;
        }

                $translations = $data;

                if(!count($translations["Fobject"])){
                        $this->addTranslation($this->getTitle(), "", $lng->getDefaultLanguage(), true);
                        $translations["Fobject"][] = array("title"      => $this->getTitle(),
                                "desc"  => "",
                                "lang"  => $lng->getDefaultLanguage());
                }
                return $translations;
        }


    function delete()
    {
        global $ilDB,$ilAppEventHandler;

        // always call parent delete function first!!
        if (!parent::delete())
        {
            return false;
        }

        // put here category specific stuff
        include_once('./Services/User/classes/class.ilObjUserFolder.php');
        ilObjUserFolder::_updateUserFolderAssignment($this->ref_id,USER_FOLDER_ID);

        $query = "DELETE FROM object_translation WHERE obj_id = ".$ilDB->quote($this->getId(),'integer');
        $res = $ilDB->manipulate($query);

        $ilAppEventHandler->raise('Modules/OrgUnit',
            'delete',
            array('object' => $this,
                'obj_id' => $this->getId()));

        return true;
    }


    // remove all Translations of current OrgUnit
    function removeTranslations()
    {
        global $ilDB;

        $query = "DELETE FROM object_translation WHERE obj_id= ".
            $ilDB->quote($this->getId(),'integer');
        $res = $ilDB->manipulate($query);
    }

    // remove translations of current OrgUnit
    function deleteTranslation($a_lang)
    {
        global $ilDB;

        $query = "DELETE FROM object_translation WHERE obj_id= ".
            $ilDB->quote($this->getId(),'integer')." AND lang_code = ".
            $ilDB->quote($a_lang, 'text');
        $res = $ilDB->manipulate($query);
    }

    // add a new translation to current OrgUnit
    function addTranslation($a_title,$a_desc,$a_lang,$a_lang_default)
    {
        global $ilDB;

        if (empty($a_title))
        {
            $a_title = "NO TITLE";
        }

        $query = "INSERT INTO object_translation ".
            "(obj_id,title,description,lang_code,lang_default) ".
            "VALUES ".
            "(".$ilDB->quote($this->getId(),'integer').",".
            $ilDB->quote($a_title,'text').",".$ilDB->quote($a_desc,'text').",".
            $ilDB->quote($a_lang,'text').",".$ilDB->quote($a_lang_default,'integer').")";
        $res = $ilDB->manipulate($query);

        return true;
    }

    // update a translation to current OrgUnit
    function updateTranslation($a_title,$a_desc,$a_lang,$a_lang_default)
    {
        global $ilDB, $ilLog;

        if (empty($a_title))
        {
            $a_title = "NO TITLE";
        }

        $query = "UPDATE object_translation SET ";


            $query .= " title = ". $ilDB->quote($a_title,'text');


            if($a_desc != "") {
                    $query .= ", description = ".$ilDB->quote($a_desc,'text')." ";
            }

            if($a_lang_default) {
                    $query .= ", lang_default = ".$ilDB->quote($a_lang_default,'integer')." ";
            }

            $query .=  " WHERE obj_id = ".$ilDB->quote($this->getId(),'integer')." AND lang_code = ".$ilDB->quote($a_lang,'text');
        $res = $ilDB->manipulate($query);

        return true;
    }


}
?>