Collaboration diagram for ilChatroomUser:

Public Member Functions
	__construct (ilObjUser $user, ilChatroom $chatroom)
	Constructor Requires ilObjUser and sets $this->user and $this->room using given $user and $chatroom. More...

	getUserId ()
	Returns Ilias User ID. More...

	getUsername ()
	Returns username from Object or SESSION. More...

	setUsername ($username)
	Sets and stores given username in SESSION. More...

	getChatNameSuggestions ()
	Returns an array of chat-name suggestions. More...

	buildAnonymousName ()
	Returns an anonymous username containing a random number. More...

	buildFullname ()
	Returns users first & lastname. More...

	buildShortname ()
	Returns first letter of users firstname, followed by dot lastname. More...

	buildLogin ()
	Returns user login. More...

	buildUniqueUsername ($username)

Static Public Member Functions
static	getUserInformation (array $usrIds, int $roomId=null)

Private Attributes
	$user

	$username

	$room

Detailed Description

Class ilChatroomUser.

Author: Andreas Kordosz akord.nosp@m.osz@.nosp@m.datab.nosp@m.ay.d.nosp@m.e

Version: $Id$

Definition at line 12 of file class.ilChatroomUser.php.

Constructor & Destructor Documentation

◆ __construct()

ilChatroomUser::__construct	(	ilObjUser	$user,
		ilChatroom	$chatroom
	)

Constructor Requires ilObjUser and sets $this->user and $this->room using given $user and $chatroom.

Parameters

ilObjUser	$user
ilChatroom	$chatroom

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

    {
        $this->user = $user;
        $this->room = $chatroom;
    }

References $user, and user().

Here is the call graph for this function:

Member Function Documentation

◆ buildAnonymousName()

ilChatroomUser::buildAnonymousName ( )

Returns an anonymous username containing a random number.

Returns: string

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

    {
        $anonymous_name = str_replace(
            '#',
            mt_rand(0, 10000),
            $this->room->getSetting('autogen_usernames')
        );
 
        return $anonymous_name;
    }

Referenced by getChatNameSuggestions().

Here is the caller graph for this function:

◆ buildFullname()

ilChatroomUser::buildFullname ( )

Returns users first & lastname.

Returns: string

Definition at line 129 of file class.ilChatroomUser.php.

    {
        $tmp = $this->user->getPref('public_profile');
        $this->user->setPref('public_profile', 'y');
        $pn = $this->user->getPublicName();
        $this->user->setPref('public_profile', $tmp);
        return $pn;
    }

References user().

Referenced by getChatNameSuggestions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildLogin()

ilChatroomUser::buildLogin ( )

Returns user login.

Returns: string

Definition at line 153 of file class.ilChatroomUser.php.

    {
        return $this->user->getLogin();
    }

References user().

Referenced by getChatNameSuggestions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildShortname()

ilChatroomUser::buildShortname ( )

Returns first letter of users firstname, followed by dot lastname.

Returns: string

Definition at line 142 of file class.ilChatroomUser.php.

    {
        $firstname = $this->user->getFirstname();
 
        return $firstname[0] . '. ' . $this->user->getLastname();
    }

References user().

Referenced by getChatNameSuggestions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildUniqueUsername()

ilChatroomUser::buildUniqueUsername ( $username )

Parameters

string $username

Returns: string

Definition at line 162 of file class.ilChatroomUser.php.

    {
        global $DIC;
 
        $username = htmlspecialchars(trim($username));
        $usernames = array();
        $uniqueName = $username;
 
        $rset = $DIC->database()->query(
            'SELECT * FROM chatroom_users WHERE '
            . $DIC->database()->like('userdata', 'text', '%"login":"' . $username . '%')
            . ' AND room_id = ' . $DIC->database()->quote($this->room->getRoomId(), 'integer')
        );
 
        while (($row = $DIC->database()->fetchAssoc($rset))) {
            $json = json_decode($row['userdata'], true);
            $usernames[] = $json['login'];
        }
 
        for ($index = 1; $index <= \count($usernames); $index++) {
            if (in_array($uniqueName, $usernames)) {
                $uniqueName = sprintf('%s_%d', $username, $index);
            }
        }
 
        return $uniqueName;
    }

References $DIC, $index, and $username.

◆ getChatNameSuggestions()

ilChatroomUser::getChatNameSuggestions ( )

Returns an array of chat-name suggestions.

Returns: array

Definition at line 95 of file class.ilChatroomUser.php.

    {
        $options = array();
 
        if ($this->user->isAnonymous()) {
            $options['anonymousName'] = $this->buildAnonymousName();
        } else {
            $options['fullname'] = $this->buildFullname();
            $options['shortname'] = $this->buildShortname();
            $options['login'] = $this->buildLogin();
        }
 
        return $options;
    }

References buildAnonymousName(), buildFullname(), buildLogin(), buildShortname(), and user().

Referenced by ilChatroomViewGUI\showNameSelection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getUserId()

ilChatroomUser::getUserId ( )

Returns Ilias User ID.

If user is anonymous, a random negative User ID is created, stored in SESSION, and returned.

Parameters

ilObjUser $user

Returns: integer

Definition at line 48 of file class.ilChatroomUser.php.

    {
        $user_id = $this->user->getId();
 
        if ($this->user->isAnonymous()) {
            if (isset($_SESSION['chat'][$this->room->getRoomId()]['user_id'])) {
                return $_SESSION['chat'][$this->room->getRoomId()]['user_id'];
            } else {
                $user_id = mt_rand(-99999, -20);
                $_SESSION['chat'][$this->room->getRoomId()]['user_id'] = $user_id;
                return $user_id;
            }
        } else {
            return $user_id;
        }
    }

References $_SESSION, and user().

Referenced by ilChatroom\addPrivateRoom(), ilChatroom\connectUser(), ilChatroom\getLastSession(), ilObjChatroom\getPersonalInformation(), and ilChatroomViewGUI\showRoom().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getUserInformation()

static ilChatroomUser::getUserInformation	(	array	$usrIds,
		int	$roomId = `null`
	)

static

Parameters

array	$usrIds
int \| null	$roomId

Returns: array

Definition at line 195 of file class.ilChatroomUser.php.

                                                                                 : array
    {
        global $DIC;
 
        $users = [];
 
        $query = '
                        SELECT userdata
                        FROM chatroom_users WHERE ' . $DIC->database()->in('user_id', $usrIds, false, 'integer');
 
        if (null !== $roomId) {
            $query .= ' AND room_id = ' . $DIC->database()->quote($roomId, 'integer');
        }
 
        $res = $DIC->database()->query($query);
        while ($row = $DIC->database()->fetchAssoc($res)) {
            $users[] = json_decode($row['userdata']);
        }
 
        return $users;
    }

References $DIC, $query, and $res.

Referenced by ilChatroomServerHandler\disconnectedUsers().

Here is the caller graph for this function:

◆ getUsername()

ilChatroomUser::getUsername ( )

Returns username from Object or SESSION.

If no Username is set, the login name will be returned.

Returns: string

Definition at line 70 of file class.ilChatroomUser.php.

    {
        if ($this->username) {
            return $this->username;
        } elseif ($_SESSION['chat'][$this->room->getRoomId()]['username']) {
            return $_SESSION['chat'][$this->room->getRoomId()]['username'];
        } else {
            return $this->user->getLogin();
        }
    }

References $_SESSION, $username, and user().

Referenced by ilChatroom\connectUser(), ilObjChatroom\getPersonalInformation(), and ilChatroomViewGUI\showRoom().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setUsername()

ilChatroomUser::setUsername ( $username )

Sets and stores given username in SESSION.

Parameters

string $username

Definition at line 85 of file class.ilChatroomUser.php.

    {
        $this->username = htmlspecialchars($username);
        $_SESSION['chat'][$this->room->getRoomId()]['username'] = $this->username;
    }

References $_SESSION, and $username.

Field Documentation

◆ $room

ilChatroomUser::$room

private

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

◆ $user

ilChatroomUser::$user

private

Definition at line 17 of file class.ilChatroomUser.php.

Referenced by __construct().

◆ $username

ilChatroomUser::$username

private

Definition at line 22 of file class.ilChatroomUser.php.

Referenced by buildUniqueUsername(), getUsername(), and setUsername().

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

Modules/Chatroom/classes/class.ilChatroomUser.php

Public Member Functions

Static Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ buildAnonymousName()

◆ buildFullname()

◆ buildLogin()

◆ buildShortname()

◆ buildUniqueUsername()

◆ getChatNameSuggestions()

◆ getUserId()

◆ getUserInformation()

◆ getUsername()

◆ setUsername()

Field Documentation

◆ $room

◆ $user

◆ $username