ilUserUtil Class Reference

Class ilUserUtil. More...

Collaboration diagram for ilUserUtil:

Static Public Member Functions
static	getNamePresentation ( $a_user_id, bool $a_user_image=false, bool $a_profile_link=false, string $a_profile_back_link='', bool $a_force_first_lastname=false, bool $a_omit_login=false, bool $a_sortable=true, bool $a_return_data_array=false, $a_ctrl_path='ilpublicuserprofilegui')
	Default behaviour is: More...
static	hasPublicProfile (int $a_user_id)
static	getProfileLink (int $a_usr_id)
	Get link to personal profile Return empty string in case of not public profile. More...

Detailed Description

Class ilUserUtil.

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 26 of file class.ilUserUtil.php.

Member Function Documentation

getNamePresentation()

static ilUserUtil::getNamePresentation (   $a_user_id, bool  $a_user_image = false, bool  $a_profile_link = false, string  $a_profile_back_link = '', bool  $a_force_first_lastname = false, bool  $a_omit_login = false, bool  $a_sortable = true, bool  $a_return_data_array = false,   $a_ctrl_path = 'ilpublicuserprofilegui'  )

static

Default behaviour is:

• lastname, firstname if public profile enabled
• [loginname] (always) modifications by jposselt at databay . de : if $a_user_id is an array of user ids the method returns an array of 'id' => 'NamePresentation' pairs.

  Parameters

  	int|int[]	$a_user_id
  string | array	$a_ctrl_path

  Returns

  array|false|mixed

  Exceptions

  ilWACException

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

References Vendor\Package\$d, $data, $DIC, $id, $ilDB, $lng, ilObjUser\_getPersonalPicturePath(), and ILIAS\Repository\int().

Referenced by ilSurveyAppraiseesTableGUI\__construct(), ilExcDeliveredFilesTableGUI\__construct(), ILIAS\Survey\Mode\AbstractUIModifier\addApprSelectionToToolbar(), ILIAS\Mail\Placeholder\MailSignatureUserFullnamePlaceholder\addPlaceholder(), ILIAS\Portfolio\Notification\SharedNotification\appendObjectInformation(), ILIAS\Test\Logging\AdditionalInformationGenerator\buildListOfUsers(), ilExSubmissionTeamGUI\buildSubmissionPropertiesAndActions(), ilMDCopyrightUsageTableGUI\collectData(), ilSystemNotification\compose(), ilGroupAddToGroupActionGUI\confirmAddUser(), ilSurveyParticipantsGUI\confirmAdminAppraiseesCloseObject(), ilGroupAddToGroupActionGUI\confirmCreateGroupAndAddUser(), ilBadgeManagementGUI\confirmDeassignBadge(), ilExerciseManagementGUI\confirmDeassignMembersObject(), ilSurveyParticipantsGUI\confirmDeleteAppraiseesObject(), ilMailingListsGUI\confirmDeleteMembers(), ilSurveyParticipantsGUI\confirmDeleteRatersObject(), ilConsultationHoursGUI\confirmRejectBooking(), ilCourseParticipantsGroupsGUI\confirmRemove(), ilExSubmissionTeamGUI\confirmRemoveTeamMemberObject(), ilExerciseManagementGUI\createTeamsFromGroupsObject(), ilContSkillAdminGUI\deassignCompetencesConfirm(), ILIAS\Survey\Execution\LaunchGUI\determineMainLink(), ilObjDataCollection\doUpdate(), ilSharedResourceGUI\executeCommand(), ilUserForTagTableGUI\fillRow(), ilHistoryTableGUI\fillRow(), ilPageHistoryTableGUI\fillRow(), ilWikiRecentChangesTableGUI\fillRow(), ilExAssignmentListTextTableGUI\fillRow(), ilWikiPagesTableGUI\fillRow(), ilWorkspaceShareTableGUI\fillRow(), ilBookingReservationsTableGUI\fillRow(), ILIAS\BackgroundTasks\Task\Job\Manager\UI\JobTable\formatResultInfo(), ILIAS\BackgroundTasks\Task\Job\Manager\UI\JobTable\formatStatusInfo(), ilExSubmissionTeamGUI\getAdoptForm(), ILIAS\Skill\Profile\SkillProfileManager\getAssignments(), ILIAS\Bibliographic\Field\Table\ProfileUserAssignmentTable\getAssignmentTitle(), ILIAS\OnScreenChat\Repository\Subscriber\getDataByUserIds(), ilPublicUserProfileGUI\getEmbeddable(), ilContributorTableGUI\getItems(), ilExAssignmentTeamTableGUI\getItems(), ilMessageGUI\getItemTitle(), ilNoteGUI\getItemTitle(), ilPageLinker\getLinkXML(), ilLMPageObjectGUI\getLinkXML(), ilLMPresentationLinker\getLinkXML(), ILIAS\Awareness\WidgetManager\getListData(), ILIAS\Test\Logging\TestAdministrationInteraction\getLogEntryAsDataTableRow(), ILIAS\Test\Logging\TestParticipantInteraction\getLogEntryAsDataTableRow(), ILIAS\Test\Logging\TestQuestionAdministrationInteraction\getLogEntryAsDataTableRow(), ILIAS\Test\Logging\TestScoringInteraction\getLogEntryAsDataTableRow(), ILIAS\Test\Logging\TestAdministrationInteraction\getLogEntryAsExportRow(), ILIAS\Test\Logging\TestQuestionAdministrationInteraction\getLogEntryAsExportRow(), ILIAS\Test\Logging\TestParticipantInteraction\getLogEntryAsExportRow(), ILIAS\Test\Logging\TestScoringInteraction\getLogEntryAsExportRow(), ilLearningModuleNotification\getMailBody(), ILIAS\Repository\Profile\ProfileGUI\getNamePresentation(), ilExSubmissionTeamGUI\getOverviewContent(), ilWikiPagesTableGUI\getPages(), ilExPeerReviewGUI\getPeerReviewReceiverPanel(), ilAbstractUsersGalleryCollectionProvider\getPopulatedGroup(), ilExPeerReviewGUI\getReceivedFeedbackPanel(), ilDclBaseRecordModel\getStandardFieldHTML(), ILIAS\Notifications\Provider\AwarenessToastProvider\getToasts(), ilAppointmentPresentationGUI\getUserName(), ilMailUserHelper\getUsernameMapForIds(), ilInternalLinkGUI\getUserSearchResult(), ilBlogPosting\handleNews(), ilWorkspaceAccessTableGUI\importData(), ilLearningProgressBaseGUI\initEditUserForm(), ilSurveyParticipantsGUI\initExternalRaterForm(), ilBuddySystemRelationsTableGUI\initFilter(), ilCalendarCategoryGUI\initFormCategory(), ilExerciseManagementGUI\initGroupForm(), ilExPeerReviewGUI\initPeerReviewItemForm(), ILIAS\Contact\MailingLists\MailingListsMembersTable\initRecords(), ilBookingPreferencesGUI\listBookingResults(), ilChatroomViewGUI\lostConnection(), ilSurveyExecutionGUI\outSurveyPage(), ilExAssignmentListTextTableGUI\parse(), ilConsultationHourBookingTableGUI\parse(), ilMailingListsGUI\performDeleteMembers(), ilWikiPageGUI\preview(), ilContSkillAdminGUI\publishAssignments(), ilNewsTimelineItemGUI\render(), ilLikeGUI\renderModal(), ilObjBlogGUI\renderNavigationByAuthors(), ilPublicUserProfileGUI\renderTitle(), ilMembershipCronNotifications\run(), ILIAS\Wiki\Notification\NotificationGUI\send(), ilLMMailNotification\send(), ilBuddySystemNotification\send(), ilObjSurvey\send360ReminderToUser(), ilWikiUtil\sendNotification(), ilObjSurvey\sendNotificationMail(), ILIAS\Notes\NotificationsManager\sendNotifications(), ilObjSurvey\sendRaterNotification(), ilMStShowUserGUI\setTitleAndIcon(), ilChatroomBanGUI\show(), ilPageObjectGUI\showEditLockInfo(), ilPageObjectGUI\showPage(), ilExAssignmentPeerReviewOverviewTableGUI\translateUserIds(), and ilPageObject\update().

      {
        global $DIC;
        $lng = $DIC['lng'];
        $ilCtrl = $DIC['ilCtrl'];
        $ilDB = $DIC['ilDB'];

        if (!is_array($a_ctrl_path)) {
            $a_ctrl_path = [$a_ctrl_path];
        }

        if (!($return_as_array = is_array($a_user_id))) {
            $a_user_id = [$a_user_id];
        }

        $sql = 'SELECT
                                        a.usr_id,
                                        firstname,
                                        lastname,
                                        title,
                                        login,
                                        b.value public_profile,
                                        c.value public_title
                                FROM
                                        usr_data a
                                        LEFT JOIN
                                                usr_pref b ON
                                                        (a.usr_id = b.usr_id AND
                                                        b.keyword = %s)
                                        LEFT JOIN
                                                usr_pref c ON
                                                        (a.usr_id = c.usr_id AND
                                                        c.keyword = %s)
                                WHERE ' . $ilDB->in('a.usr_id', $a_user_id, false, 'integer');

        $userrow = $ilDB->queryF($sql, ['text', 'text'], ['public_profile', 'public_title']);

        $names = [];

        $data = [];
        while ($row = $ilDB->fetchObject($userrow)) {
            $pres = '';
            $d = [
                'id' => (int) $row->usr_id,
                'title' => '',
                'lastname' => '',
                'firstname' => '',
                'img' => '',
                'link' => ''
            ];
            $has_public_profile = in_array($row->public_profile, ['y', 'g']);
            if ($a_force_first_lastname || $has_public_profile) {
                $title = '';
                if ($row->public_title == 'y' && $row->title) {
                    $title = $row->title . ' ';
                }
                $d['title'] = $title;
                if ($a_sortable) {
                    $pres = $row->lastname;
                    if (strlen($row->firstname)) {
                        $pres .= (', ' . $row->firstname . ' ');
                    }
                } else {
                    $pres = $title;
                    if (strlen($row->firstname)) {
                        $pres .= $row->firstname . ' ';
                    }
                    $pres .= ($row->lastname . ' ');
                }
                $d['firstname'] = $row->firstname;
                $d['lastname'] = $row->lastname;
            }
            $d['login'] = $row->login;
            $d['public_profile'] = $has_public_profile;


            if (!$a_omit_login) {
                $pres .= '[' . $row->login . ']';
            }

            if ($a_profile_link && $has_public_profile) {
                $ilCtrl->setParameterByClass(end($a_ctrl_path), 'user_id', $row->usr_id);
                if ($a_profile_back_link != '') {
                    $ilCtrl->setParameterByClass(
                        end($a_ctrl_path),
                        'back_url',
                        rawurlencode($a_profile_back_link)
                    );
                }
                $link = $ilCtrl->getLinkTargetByClass($a_ctrl_path, 'getHTML');
                $pres = '<a href="' . $link . '">' . $pres . '</a>';
                $d['link'] = $link;
            }

            if ($a_user_image) {
                $img = ilObjUser::_getPersonalPicturePath($row->usr_id, 'xxsmall');
                $pres = '<img class="ilUserXXSmall" src="' . $img . '" alt="' . $lng->txt('icon') .
                    ' ' . $lng->txt('user_picture') . '" /> ' . $pres;
                $d['img'] = $img;
            }

            $names[$row->usr_id] = $pres;
            $data[$row->usr_id] = $d;
        }

        foreach ($a_user_id as $id) {
            if (!isset($names[$id])) {
                $names[$id] = $lng->txt('deleted_user');
            }
            if ($names[$id] === '') {
                $names[$id] = $lng->txt('usr_name_undisclosed');
            }
        }

        if ($a_return_data_array) {
            if ($return_as_array) {
                return $data;
            } else {
                return current($data);
            }
        }
        return $return_as_array ? $names : $names[$a_user_id[0]];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getProfileLink()

static ilUserUtil::getProfileLink ( int  $a_usr_id )

static

Get link to personal profile Return empty string in case of not public profile.

Definition at line 193 of file class.ilUserUtil.php.

References $DIC, ilObjUser\_lookupPref(), and ilUserStartingPointRepository\getValidAndAccessibleStartingPointAsUrl().

Referenced by ilMDCopyrightUsageTableGUI\collectData(), ilRepositoryUserResultTableGUI\fillRow(), and ILIAS\Calendar\ConsultationHours\BookingDataProvider\read().

                                                        : string
    {
        global $DIC;
        $ctrl = $DIC['ilCtrl'];

        $public_profile = ilObjUser::_lookupPref($a_usr_id, 'public_profile');
        if ($public_profile != 'y' and $public_profile != 'g') {
            return '';
        }

        $ctrl->setParameterByClass('ilpublicuserprofilegui', 'user', $a_usr_id);
        return $ctrl->getLinkTargetByClass('ilpublicuserprofilegui', 'getHTML');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

hasPublicProfile()

static ilUserUtil::hasPublicProfile ( int  $a_user_id )

static

Definition at line 173 of file class.ilUserUtil.php.

References $DIC, and $ilDB.

Referenced by ilPageLinker\getLinkXML(), ilLMPageObjectGUI\getLinkXML(), and ilLMPresentationLinker\getLinkXML().

                                                           : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];

        $set = $ilDB->query(
            'SELECT value FROM usr_pref ' .
            ' WHERE usr_id = ' . $ilDB->quote($a_user_id, 'integer') .
            ' and keyword = ' . $ilDB->quote('public_profile', 'text')
        );
        $rec = $ilDB->fetchAssoc($set);

        return in_array($rec['value'] ?? '', ['y', 'g']);
    }

Here is the caller graph for this function:

---

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

• components/ILIAS/User/classes/class.ilUserUtil.php