Handles shared calendars. More...

Collaboration diagram for ilCalendarShared:

Public Member Functions
	__construct ($a_calendar_id)
	constructor More...

	getCalendarId ()
	get calendar id More...

	getShared ()
	get shared More...

	getUsers ()
	get users More...

	getRoles ()
	get roles More...

	isShared ($a_obj_id)
	Check if calendar is already shared with specific user or role. More...

	isEditableForUser ($a_user_id)
	Check if calendar is editable for user. More...

	share ($a_obj_id, $a_type, $a_writable=false)
	share calendar More...

	stopSharing ($a_obj_id)
	stop sharing More...

Static Public Member Functions
static	deleteByCalendar ($a_cal_id)
	Delete all entries for a specific calendar id. More...

static	deleteByUser ($a_user_id)
	Delete all entries for a specific user. More...

static	isSharedWithUser ($a_usr_id, $a_calendar_id)
	is shared with user More...

static	getSharedCalendarsForUser ($a_usr_id=0)
	get shared calendars of user More...

Data Fields
const	TYPE_USR = 1

const	TYPE_ROLE = 2

Protected Member Functions
	read ()
	read shared calendars More...

Protected Attributes
	$db

Private Attributes
	$calendar_id

	$shared = array()

	$shared_users = array()

	$shared_roles = array()

Detailed Description

Handles shared calendars.

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

Definition at line 33 of file class.ilCalendarShared.php.

Constructor & Destructor Documentation

◆ __construct()

ilCalendarShared::__construct ( $a_calendar_id )

constructor

@access public

Parameters

int	calendar id

Definition at line 53 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        $this->calendar_id = $a_calendar_id;
        $this->db = $ilDB;
        $this->read();
    }

References $DIC, $ilDB, and read().

Here is the call graph for this function:

Member Function Documentation

◆ deleteByCalendar()

static ilCalendarShared::deleteByCalendar ( $a_cal_id )

static

Delete all entries for a specific calendar id.

@access public

Parameters

return

Definition at line 72 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        $query = "DELETE FROM cal_shared WHERE cal_id = " . $ilDB->quote($a_cal_id, 'integer') . " ";
        $res = $ilDB->manipulate($query);
        return true;
    }

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

◆ deleteByUser()

static ilCalendarShared::deleteByUser ( $a_user_id )

static

Delete all entries for a specific user.

@access public

Parameters

int usr_id

Returns

Definition at line 91 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        $query = "DELETE FROM cal_shared WHERE obj_id = " . $ilDB->quote($a_user_id, 'integer') . " ";
        $res = $ilDB->manipulate($query);
        return true;
        
        // TODO: delete also cal_shared_user_status
    }

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

◆ getCalendarId()

ilCalendarShared::getCalendarId ( )

get calendar id

@access public

Returns: int calendar id

Definition at line 210 of file class.ilCalendarShared.php.

    {
        return $this->calendar_id;
    }

References $calendar_id.

Referenced by read(), share(), and stopSharing().

Here is the caller graph for this function:

◆ getRoles()

ilCalendarShared::getRoles ( )

get roles

@access public

Returns: array

Definition at line 243 of file class.ilCalendarShared.php.

    {
        return $this->shared_roles ? $this->shared_roles : array();
    }

◆ getShared()

ilCalendarShared::getShared ( )

get shared

@access public

Returns: array

Definition at line 221 of file class.ilCalendarShared.php.

    {
        return $this->shared ? $this->shared : array();
    }

◆ getSharedCalendarsForUser()

static ilCalendarShared::getSharedCalendarsForUser ( $a_usr_id = 0 )

static

get shared calendars of user

@access public

Parameters

int user id

Returns: array shared calendar info

Definition at line 152 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $ilUser = $DIC['ilUser'];
        $rbacreview = $DIC['rbacreview'];
        
        if (!$a_usr_id) {
            $a_usr_id = $ilUser->getId();
        }
 
        $query = "SELECT * FROM cal_shared " .
            "WHERE obj_type = " . $ilDB->quote(self::TYPE_USR, 'integer') . " " .
            "AND obj_id = " . $ilDB->quote($a_usr_id, 'integer') . " " .
            "ORDER BY create_date";
        $res = $ilDB->query($query);
        $calendars = array();
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $calendars[] = $row->cal_id;
            
            $shared[$row->cal_id]['cal_id'] = $row->cal_id;
            $shared[$row->cal_id]['create_date'] = $row->create_date;
            $shared[$row->cal_id]['obj_type'] = $row->obj_type;
        }
        
        $assigned_roles = $rbacreview->assignedRoles($ilUser->getId());
        
        $query = "SELECT * FROM cal_shared " .
            "WHERE obj_type = " . $ilDB->quote(self::TYPE_ROLE, 'integer') . " " .
            "AND " . $ilDB->in('obj_id', $assigned_roles, false, 'integer');
 
        $res = $ilDB->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            if (in_array($row->cal_id, $calendars)) {
                continue;
            }
            if (ilCalendarCategories::_isOwner($ilUser->getId(), $row->cal_id)) {
                continue;
            }
            
            $shared[$row->cal_id]['cal_id'] = $row->cal_id;
            $shared[$row->cal_id]['create_date'] = $row->create_date;
            $shared[$row->cal_id]['obj_type'] = $row->obj_type;
        }
        
            
        
        return $shared ? $shared : array();
        // TODO: return also role calendars
    }

References $DIC, $ilDB, $ilUser, $query, $res, $shared, ilCalendarCategories\_isOwner(), and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilCalendarSharedStatus\getOpenInvitations(), ilCalendarCategoryGUI\invitations(), and ilCalendarCategoryGUI\readPermissions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getUsers()

ilCalendarShared::getUsers ( )

get users

@access public

Returns: array

Definition at line 232 of file class.ilCalendarShared.php.

    {
        return $this->shared_users ? $this->shared_users : array();
    }

◆ isEditableForUser()

ilCalendarShared::isEditableForUser ( $a_user_id )

Check if calendar is editable for user.

Parameters

type $a_user_id

Definition at line 264 of file class.ilCalendarShared.php.

    {
        foreach ((array) $this->shared as $info) {
            if (!$info['writable']) {
                continue;
            }
            
            switch ($info['obj_type']) {
                case self::TYPE_USR:
                    if ($info['obj_id'] == $a_user_id) {
                        return true;
                    }
                    break;
                    
                case self::TYPE_ROLE:
                    if ($GLOBALS['DIC']['rbacreview']->isAssigned($a_user_id, $info['obj_id'])) {
                        return true;
                    }
                    break;
            }
        }
        return false;
    }

References $GLOBALS, TYPE_ROLE, and TYPE_USR.

◆ isShared()

ilCalendarShared::isShared ( $a_obj_id )

Check if calendar is already shared with specific user or role.

@access public

Parameters

int obj_id

Returns: bool

Definition at line 255 of file class.ilCalendarShared.php.

    {
        return isset($this->shared[$a_obj_id]);
    }

Referenced by share(), and stopSharing().

Here is the caller graph for this function:

◆ isSharedWithUser()

static ilCalendarShared::isSharedWithUser	(	$a_usr_id,
		$a_calendar_id
	)

static

is shared with user

@access public

Parameters

int	usr_id
int	calendar id

Returns: bool

Definition at line 113 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $rbacreview = $DIC['rbacreview'];
        
        $query = 'SELECT * FROM cal_shared ' .
            "WHERE cal_id = " . $ilDB->quote($a_calendar_id, 'integer') . " ";
        $res = $ilDB->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $obj_ids[$row->obj_id] = $row->obj_type;
        }
        $assigned_roles = $rbacreview->assignedRoles($a_usr_id);
        foreach ($obj_ids as $id => $type) {
            switch ($type) {
                case self::TYPE_USR:
                    if ($a_usr_id == $id) {
                        return true;
                    }
                    break;
                case self::TYPE_ROLE:
                    if (in_array($id, $assigned_roles)) {
                        return true;
                    }
                    break;
            }
        }
        return false;
    }

References $DIC, $ilDB, $query, $res, $type, ilDBConstants\FETCHMODE_OBJECT, TYPE_ROLE, and TYPE_USR.

Referenced by ilCalendarCategoryGUI\acceptShared(), ilCalendarCategoryGUI\declineShared(), and ilCalendarCategoryGUI\unshare().

Here is the caller graph for this function:

◆ read()

ilCalendarShared::read ( )

protected

read shared calendars

@access protected

Returns

Definition at line 354 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        $this->shared = $this->shared_users = $this->shared_roles = array();
        
        $query = "SELECT * FROM cal_shared WHERE cal_id = " . $this->db->quote($this->getCalendarId(), 'integer');
        $res = $this->db->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            switch ($row->obj_type) {
                case self::TYPE_USR:
                    $this->shared_users[$row->obj_id]['obj_id'] = $row->obj_id;
                    $this->shared_users[$row->obj_id]['obj_type'] = $row->obj_type;
                    $this->shared_users[$row->obj_id]['create_date'] = $row->create_date;
                    $this->shared_users[$row->obj_id]['writable'] = $row->writable;
                    break;
                
                
                case self::TYPE_ROLE:
                    $this->shared_roles[$row->obj_id]['obj_id'] = $row->obj_id;
                    $this->shared_roles[$row->obj_id]['obj_type'] = $row->obj_type;
                    $this->shared_roles[$row->obj_id]['create_date'] = $row->create_date;
                    $this->shared_role[$row->obj_id]['writable'] = $row->writable;
                    break;
                    
            }
            
            $this->shared[$row->obj_id]['obj_id'] = $row->obj_id;
            $this->shared[$row->obj_id]['obj_type'] = $row->obj_type;
            $this->shared[$row->obj_id]['create_date'] = $row->create_date;
            $this->shared[$row->obj_id]['writable'] = $row->writable;
        }
        return true;
    }

References $DIC, $ilDB, $query, $res, ilDBConstants\FETCHMODE_OBJECT, getCalendarId(), TYPE_ROLE, and TYPE_USR.

Referenced by __construct(), share(), and stopSharing().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ share()

ilCalendarShared::share	(	$a_obj_id,
		$a_type,
		$a_writable = `false`
	)

share calendar

@access public

Parameters

int	obj_id
int	type

Returns: bool

Definition at line 296 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        if ($this->isShared($a_obj_id)) {
            return false;
        }
        $query = "INSERT INTO cal_shared (cal_id,obj_id,obj_type,create_date,writable) " .
            "VALUES ( " .
            $this->db->quote($this->getCalendarId(), 'integer') . ", " .
            $this->db->quote($a_obj_id, 'integer') . ", " .
            $this->db->quote($a_type, 'integer') . ", " .
            $ilDB->now() . ", " .
            $this->db->quote((int) $a_writable, 'integer') . ' ' .
            ")";
        
        $res = $ilDB->manipulate($query);
        
        $this->read();
        return true;
    }

References $DIC, $ilDB, $query, $res, getCalendarId(), isShared(), and read().

Here is the call graph for this function:

◆ stopSharing()

ilCalendarShared::stopSharing ( $a_obj_id )

stop sharing

@access public

Parameters

int obj_id

Returns: bool

Definition at line 327 of file class.ilCalendarShared.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        
        if (!$this->isShared($a_obj_id)) {
            return false;
        }
        $query = "DELETE FROM cal_shared WHERE cal_id = " . $this->db->quote($this->getCalendarId(), 'integer') . " " .
            "AND obj_id = " . $this->db->quote($a_obj_id, 'integer') . " ";
        $res = $ilDB->manipulate($query);
        
        include_once('./Services/Calendar/classes/class.ilCalendarSharedStatus.php');
        ilCalendarSharedStatus::deleteStatus($a_obj_id, $this->getCalendarId());
        
        
        $this->read();
        return true;
    }

References $DIC, $ilDB, $query, $res, ilCalendarSharedStatus\deleteStatus(), getCalendarId(), isShared(), and read().

Here is the call graph for this function:

Field Documentation

◆ $calendar_id

ilCalendarShared::$calendar_id

private

Definition at line 38 of file class.ilCalendarShared.php.

Referenced by getCalendarId().

◆ $db

ilCalendarShared::$db

protected

Definition at line 44 of file class.ilCalendarShared.php.

◆ $shared

ilCalendarShared::$shared = array()

private

Definition at line 40 of file class.ilCalendarShared.php.

Referenced by getSharedCalendarsForUser().

◆ $shared_roles

ilCalendarShared::$shared_roles = array()

private

Definition at line 42 of file class.ilCalendarShared.php.

◆ $shared_users

ilCalendarShared::$shared_users = array()

private

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

◆ TYPE_ROLE

const ilCalendarShared::TYPE_ROLE = 2

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

Referenced by isEditableForUser(), isSharedWithUser(), ilCalendarSharedListTableGUI\parse(), read(), and ilCalendarCategoryGUI\shareAssignRoles().

◆ TYPE_USR

const ilCalendarShared::TYPE_USR = 1

Definition at line 35 of file class.ilCalendarShared.php.

Referenced by isEditableForUser(), isSharedWithUser(), ilCalendarSharedListTableGUI\parse(), read(), and ilCalendarCategoryGUI\shareAssign().

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

Services/Calendar/classes/class.ilCalendarShared.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ deleteByCalendar()

◆ deleteByUser()

◆ getCalendarId()

◆ getRoles()

◆ getShared()

◆ getSharedCalendarsForUser()

◆ getUsers()

◆ isEditableForUser()

◆ isShared()

◆ isSharedWithUser()

◆ read()

◆ share()

◆ stopSharing()

Field Documentation

◆ $calendar_id

◆ $db

◆ $shared

◆ $shared_roles

◆ $shared_users

◆ TYPE_ROLE

◆ TYPE_USR