ilObjChatroomAccess Class Reference

Access class for chatroom objects. More...

Inheritance diagram for ilObjChatroomAccess:

Collaboration diagram for ilObjChatroomAccess:

Public Member Functions
	_checkAccess (string $cmd, string $permission, int $ref_id, int $obj_id, ?int $user_id=null)
	canBeDelivered (ilWACPath $ilWACPath)
Public Member Functions inherited from ilObjectAccess
	_checkAccess (string $cmd, string $permission, int $ref_id, int $obj_id, ?int $user_id=null)
	Checks whether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess) More...
	canBeDelivered (ilWACPath $ilWACPath)

Static Public Member Functions
static	_getCommands ()
static	_checkGoto (string $target)
static	isActivated (int $refId, int $objId, bool &$a_visible_flag=null)
static	lookupOnline (int $a_obj_id)
Static Public Member Functions inherited from ilObjectAccess
static	_getCommands ()
	get commands More...
static	_checkGoto (string $target)
	check whether goto script will succeed More...
static	_isOffline (int $obj_id)
	Type-specific implementation of general status, has to be overwritten if object type does not support centralized offline handling. More...
static	_preloadData (array $obj_ids, array $ref_ids)
	Preload data. More...

Static Private Member Functions
static	checkRoomAccess (string $a_permission, int $a_ref_id, int $a_obj_id, int $a_user_id)

Static Private Attributes
static bool	$chat_enabled = null

Detailed Description

Access class for chatroom objects.

Author

Jan Posselt <jposselt at databay.de>

Version

$Id$

Definition at line 27 of file class.ilObjChatroomAccess.php.

Member Function Documentation

_checkAccess()

ilObjChatroomAccess::_checkAccess	(	string	$cmd,
		string	$permission,
		int	$ref_id,
		int	$obj_id,
		?int	$user_id = null
	)

Definition at line 58 of file class.ilObjChatroomAccess.php.

References $GLOBALS.

                                                                                                                 : bool
    {
        if (!$user_id) {
            $user_id = $GLOBALS['DIC']->user()->getId();
        }

        return self::checkRoomAccess($permission, $ref_id, $obj_id, (int) $user_id);
    }

_checkGoto()

static ilObjChatroomAccess::_checkGoto ( string  $target )

static

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

References ilChatroom\checkUserPermissions().

                                                     : bool
    {
        $t_arr = explode('_', $target);

        if (count($t_arr) < 2 || $t_arr[0] !== 'chtr' || ((int) $t_arr[1]) <= 0) {
            return false;
        }

        if (
            ilChatroom::checkUserPermissions('visible', (int) $t_arr[1], false) ||
            ilChatroom::checkUserPermissions('read', (int) $t_arr[1], false)
        ) {
            return true;
        }

        return false;
    }

Here is the call graph for this function:

_getCommands()

static ilObjChatroomAccess::_getCommands ( )

static

Definition at line 31 of file class.ilObjChatroomAccess.php.

Referenced by ilObjChatroomListGUI\init().

                                         : array
    {
        $commands = [];
        $commands[] = ['permission' => 'read', 'cmd' => 'view', 'lang_var' => 'enter', 'default' => true];
        $commands[] = ['permission' => 'write', 'cmd' => 'settings-general', 'lang_var' => 'settings'];

        return $commands;
    }

Here is the caller graph for this function:

canBeDelivered()

ilObjChatroomAccess::canBeDelivered

(

ilWACPath

$ilWACPath

)

Implements ilWACCheckingClass.

Definition at line 148 of file class.ilObjChatroomAccess.php.

References ilWACPath\getPath().

                                                        : bool
    {
        if (preg_match("/chatroom\\/smilies\\//ui", $ilWACPath->getPath())) {
            return true;
        }

        return false;
    }

Here is the call graph for this function:

checkRoomAccess()

static ilObjChatroomAccess::checkRoomAccess ( string  $a_permission, int  $a_ref_id, int  $a_obj_id, int  $a_user_id  )

staticprivate

Definition at line 67 of file class.ilObjChatroomAccess.php.

References $DIC, and ilAccessInfo\IL_NO_OBJECT_ACCESS.

                                                                                                               : bool
    {
        global $DIC;

        if (self::$chat_enabled === null) {
            $chatSetting = new ilSetting('chatroom');
            self::$chat_enabled = (bool) $chatSetting->get('chat_enabled', '0');
        }

        $hasWriteAccess = $DIC->rbac()->system()->checkAccessOfUser($a_user_id, 'write', $a_ref_id);
        if ($hasWriteAccess) {
            return true;
        }

        switch ($a_permission) {
            case 'visible':
                $visible = null;

                $active = self::isActivated($a_ref_id, $a_obj_id, $visible);

                if (!$active) {
                    $DIC->access()->addInfoItem(
                        ilAccessInfo::IL_NO_OBJECT_ACCESS,
                        $DIC->language()->txt('offline')
                    );
                }

                if ($active === false && $visible === false) {
                    return false;
                }
                break;

            case 'read':
                $active = self::isActivated($a_ref_id, $a_obj_id);
                if (!$active) {
                    $DIC->access()->addInfoItem(
                        ilAccessInfo::IL_NO_OBJECT_ACCESS,
                        $DIC->language()->txt('offline')
                    );
                    return false;
                }
                break;
        }

        return self::$chat_enabled;
    }

isActivated()

static ilObjChatroomAccess::isActivated ( int  $refId, int  $objId, bool &  $a_visible_flag = null  )

static

Definition at line 114 of file class.ilObjChatroomAccess.php.

References ilObjectActivation\getItem(), and ilObjectActivation\TIMINGS_ACTIVATION.

Referenced by ilChatroom\checkPermissions().

                                                                                            : bool
    {
        if (!self::lookupOnline($objId)) {
            $a_visible_flag = false;
            return false;
        }

        $a_visible_flag = true;

        $item = ilObjectActivation::getItem($refId);
        switch ($item['timing_type']) {
            case ilObjectActivation::TIMINGS_ACTIVATION:
                if (time() < $item['timing_start'] || time() > $item['timing_end']) {
                    $a_visible_flag = (bool) $item['visible'];
                    return false;
                }
        }

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

lookupOnline()

static ilObjChatroomAccess::lookupOnline ( int  $a_obj_id )

static

Definition at line 135 of file class.ilObjChatroomAccess.php.

References $DIC, and $res.

                                                      : bool
    {
        global $DIC;

        $res = $DIC->database()->query(
            'SELECT online_status FROM chatroom_settings WHERE object_id = ' .
            $DIC->database()->quote($a_obj_id, 'integer')
        );
        $row = $DIC->database()->fetchAssoc($res);

        return (bool) ($row['online_status'] ?? false);
    }

Field Documentation

$chat_enabled

bool ilObjChatroomAccess::$chat_enabled = null

staticprivate

Definition at line 29 of file class.ilObjChatroomAccess.php.

---

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

• Modules/Chatroom/classes/class.ilObjChatroomAccess.php