ilUserProfile Class Reference

Class ilUserProfile. More...

Collaboration diagram for ilUserProfile:

Public Member Functions
	__construct ()
	Constructor. More...
	getStandardFields ()
	Get standard user fields array. More...
	getLocalUserAdministrationFields ()
	Get visible fields in local user administration. More...
	skipGroup ($a_group)
	Skip a group. More...
	skipField ($a_field)
	Skip a field. More...
	addStandardFieldsToForm ($a_form, $a_user=null, array $custom_fields=null)
	Add standard fields to form. More...
	setAjaxCallback ($a_href)

Static Public Member Functions
static	userSettingVisible ($a_setting)
	Checks whether user setting is visible. More...
static	setMode ($mode)
static	isProfileIncomplete ($a_user, $a_include_udf=true, $a_personal_data_only=true)
	Check if all required personal data fields are set. More...
static	getIgnorableRequiredSettings ()
	Returns an array of all ignorable profiel fields. More...

Data Fields
const	MODE_DESKTOP = 1
const	MODE_REGISTRATION = 2

Static Protected Member Functions
static	isEditableByUser ($setting)
	Returns whether a profile setting is editable by an user in the profile gui. More...

Static Private Attributes
static	$mode = self::MODE_DESKTOP
static	$user_field

Detailed Description

Class ilUserProfile.

Author

Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

Definition at line 15 of file class.ilUserProfile.php.

Constructor & Destructor Documentation

__construct()

ilUserProfile::__construct

(

)

Constructor.

Definition at line 373 of file class.ilUserProfile.php.

References $lng, and array.

    {
        global $lng;

        $this->skip_groups = array();
        $this->skip_fields = array();

        // for hide me from awareness tool text
        // not nicest workaround, but better than using common block
        $lng->loadLanguageModule("awrn");
        $lng->loadLanguageModule("buddysystem");
    }

Member Function Documentation

addStandardFieldsToForm()

ilUserProfile::addStandardFieldsToForm	(		$a_form,
			$a_user = null,
		array	$custom_fields = null
	)

Add standard fields to form.

Definition at line 444 of file class.ilUserProfile.php.

References $ilSetting, $lng, $m, $options, ilObjRole\_lookupRegisterAllowed(), array, ilUtil\getPasswordRequirementsInfo(), getStandardFields(), IL_CAL_DATE, ilDateTime\setDate(), ilRadioOption\setDisabled(), ilFormPropertyGUI\setDisabled(), ilFormPropertyGUI\setMulti(), ilSelectInputGUI\setOptions(), ilPasswordInputGUI\setUseStripSlashes(), ilTextInputGUI\setValue(), ilSelectInputGUI\setValue(), ilEMailInputGUI\setValue(), ilRadioGroupInputGUI\setValue(), ilNonEditableValueGUI\setValue(), ilTextAreaInputGUI\setValue(), and userSettingVisible().

    {
        global $ilSetting, $lng, $rbacreview, $ilias;

        // custom registration settings
        if (self::$mode == self::MODE_REGISTRATION) {
            include_once 'Services/Registration/classes/class.ilRegistrationSettings.php';
            $registration_settings = new ilRegistrationSettings();

            self::$user_field["username"]["group"] = "login_data";
            self::$user_field["password"]["group"] = "login_data";
            self::$user_field["language"]["default"] = $lng->lang_key;

            // different position for role
            $roles = self::$user_field["roles"];
            unset(self::$user_field["roles"]);
            self::$user_field["roles"] = $roles;
            self::$user_field["roles"]["group"] = "settings";
        }
        
        $fields = $this->getStandardFields();
        $current_group = "";
        $custom_fields_done = false;
        foreach ($fields as $f => $p) {
            // next group? -> diplay subheader
            if (($p["group"] != $current_group) &&
                ilUserProfile::userSettingVisible($f)) {
                if (is_array($custom_fields) && !$custom_fields_done) {
                    // should be appended to "other" or at least before "settings"
                    if ($current_group == "other" || $p["group"] == "settings") {
                        // add "other" subheader
                        if ($current_group != "other") {
                            $sh = new ilFormSectionHeaderGUI();
                            $sh->setTitle($lng->txt("other"));
                            $a_form->addItem($sh);
                        }
                        foreach ($custom_fields as $custom_field) {
                            $a_form->addItem($custom_field);
                        }
                        $custom_fields_done = true;
                    }
                }
                
                $sh = new ilFormSectionHeaderGUI();
                $sh->setTitle($lng->txt($p["group"]));
                $a_form->addItem($sh);
                $current_group = $p["group"];
            }

            $m = "";
            if (isset($p["method"])) {
                $m = $p["method"];
            }
            
            $lv = (isset($p["lang_var"]) && $p["lang_var"] != "")
                ? $p["lang_var"]
                : $f;
            
            switch ($p["input"]) {
                case "login":
                    if ((int) $ilSetting->get('allow_change_loginname') || self::$mode == self::MODE_REGISTRATION) {
                        $val = new ilTextInputGUI($lng->txt('username'), 'username');
                        if ($a_user) {
                            $val->setValue($a_user->getLogin());
                        }
                        $val->setMaxLength($p['maxlength']);
                        $val->setSize(40);
                        $val->setRequired(true);
                    } else {
                        // user account name
                        $val = new ilNonEditableValueGUI($lng->txt("username"), 'ne_un');
                        if ($a_user) {
                            $val->setValue($a_user->getLogin());
                        }
                    }
                    $a_form->addItem($val);
                    break;
                
                case "text":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $ti = new ilTextInputGUI($lng->txt($lv), "usr_" . $f);
                        if ($a_user) {
                            $ti->setValue($a_user->$m());
                        }
                        $ti->setMaxLength($p["maxlength"]);
                        $ti->setSize($p["size"]);
                        $ti->setRequired($ilSetting->get("require_" . $f));
                        if (!$ti->getRequired() || $ti->getValue()) {
                            $ti->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        $a_form->addItem($ti);
                    }
                    break;

                case "sel_country":
                    if (ilUserProfile::userSettingVisible($f)) {
                        include_once("./Services/Form/classes/class.ilCountrySelectInputGUI.php");
                        $ci = new ilCountrySelectInputGUI($lng->txt($lv), "usr_" . $f);
                        if ($a_user) {
                            $ci->setValue($a_user->$m());
                        }
                        $ci->setRequired($ilSetting->get("require_" . $f));
                        if (!$ci->getRequired() || $ci->getValue()) {
                            $ci->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        $a_form->addItem($ci);
                    }
                    break;

                case "birthday":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $bi = new ilBirthdayInputGUI($lng->txt($lv), "usr_" . $f);
                        include_once "./Services/Calendar/classes/class.ilDateTime.php";
                        $date = null;
                        if ($a_user && strlen($a_user->$m())) {
                            $date = new ilDateTime($a_user->$m(), IL_CAL_DATE);
                            $bi->setDate($date);
                        }
                        $bi->setRequired($ilSetting->get("require_" . $f));
                        if (!$bi->getRequired() || $date) {
                            $bi->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        $a_form->addItem($bi);
                    }
                    break;
                    
                case "radio":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $rg = new ilRadioGroupInputGUI($lng->txt($lv), "usr_" . $f);
                        if ($a_user) {
                            $rg->setValue($a_user->$m());
                        }
                        foreach ($p["values"] as $k => $v) {
                            $op = new ilRadioOption($lng->txt($v), $k);
                            $rg->addOption($op);
                        }
                        $rg->setRequired($ilSetting->get("require_" . $f));
                        if (!$rg->getRequired() || $rg->getValue()) {
                            $rg->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        $a_form->addItem($rg);
                    }
                    break;
                    
                case "picture":
                    if (ilUserProfile::userSettingVisible("upload") && $a_user) {
                        $ii = new ilImageFileInputGUI($lng->txt("personal_picture"), "userfile");
                        $ii->setDisabled($ilSetting->get("usr_settings_disable_upload"));
                        
                        $upload = $a_form->getFileUpload("userfile");
                        if ($upload["name"]) {
                            $ii->setPending($upload["name"]);
                        } else {
                            $im = ilObjUser::_getPersonalPicturePath(
                                $a_user->getId(),
                                "small",
                                true,
                                true
                            );
                            if ($im != "") {
                                $ii->setImage($im);
                                $ii->setAlt($lng->txt("personal_picture"));
                            }
                        }
            
                        $a_form->addItem($ii);
                    }
                    break;
                    
                case "roles":
                    if (self::$mode == self::MODE_DESKTOP) {
                        if (ilUserProfile::userSettingVisible("roles")) {
                            $global_roles = $rbacreview->getGlobalRoles();
                            foreach ($global_roles as $role_id) {
                                if (in_array($role_id, $rbacreview->assignedRoles($a_user->getId()))) {
                                    $roleObj = $ilias->obj_factory->getInstanceByObjId($role_id);
                                    $role_names .= $roleObj->getTitle() . ", ";
                                    unset($roleObj);
                                }
                            }
                            $dr = new ilNonEditableValueGUI($lng->txt("default_roles"), "ne_dr");
                            $dr->setValue(substr($role_names, 0, -2));
                            $a_form->addItem($dr);
                        }
                    } elseif (self::$mode == self::MODE_REGISTRATION) {
                        if ($registration_settings->roleSelectionEnabled()) {
                            include_once("./Services/AccessControl/classes/class.ilObjRole.php");
                            $options = array();
                            foreach (ilObjRole::_lookupRegisterAllowed() as $role) {
                                $options[$role["id"]] = $role["title"];
                            }
                            // registration form validation will take care of missing field / value
                            if ($options) {
                                if (sizeof($options) > 1) {
                                    $ta = new ilSelectInputGUI($lng->txt('default_role'), "usr_" . $f);
                                    $ta->setOptions($options);
                                    $ta->setRequired($ilSetting->get("require_" . $f));
                                    if (!$ta->getRequired()) {
                                        $ta->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                                    }
                                }
                                // no need for select if only 1 option
                                else {
                                    $ta = new ilHiddenInputGUI("usr_" . $f);
                                    $ta->setValue(array_shift(array_keys($options)));
                                }
                                $a_form->addItem($ta);
                            }
                        }
                    }
                    break;
                    
                case "email":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $em = new ilEMailInputGUI($lng->txt($lv), "usr_" . $f);
                        if ($a_user) {
                            $em->setValue($a_user->$m());
                        }
                        $em->setRequired($ilSetting->get("require_" . $f));
                        if (!$em->getRequired() || $em->getValue()) {
                            $em->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        if (self::MODE_REGISTRATION == self::$mode) {
                            $em->setRetype(true);
                        }
                        $a_form->addItem($em);
                    }
                    break;
                case "second_email":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $em = new ilEMailInputGUI($lng->txt($lv), "usr_" . $f);
                        if ($a_user) {
                            $em->setValue($a_user->$m());
                        }
                        $em->setRequired($ilSetting->get("require_" . $f));
                        if (!$em->getRequired() || $em->getValue()) {
                            $em->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        if (self::MODE_REGISTRATION == self::$mode) {
                            $em->setRetype(true);
                        }
                        $a_form->addItem($em);
                    }
                    break;
                case "textarea":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $ta = new ilTextAreaInputGUI($lng->txt($lv), "usr_" . $f);
                        if ($a_user) {
                            $ta->setValue($a_user->$m());
                        }
                        $ta->setRows($p["rows"]);
                        $ta->setCols($p["cols"]);
                        $ta->setRequired($ilSetting->get("require_" . $f));
                        if (!$ta->getRequired() || $ta->getValue()) {
                            $ta->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        $a_form->addItem($ta);
                    }
                    break;
                    
                case "password":
                    if (self::$mode == self::MODE_REGISTRATION) {
                        if (!$registration_settings->passwordGenerationEnabled()) {
                            $ta = new ilPasswordInputGUI($lng->txt($lv), "usr_" . $f);
                            $ta->setUseStripSlashes(false);
                            $ta->setRequired(true);
                            $ta->setInfo(ilUtil::getPasswordRequirementsInfo());
                        // $ta->setDisabled($ilSetting->get("usr_settings_disable_".$f));
                        } else {
                            $ta = new ilNonEditableValueGUI($lng->txt($lv));
                            $ta->setValue($lng->txt("reg_passwd_via_mail"));
                        }
                        $a_form->addItem($ta);
                    }
                    break;
                    
                case "language":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $ta = new ilSelectInputGUI($lng->txt($lv), "usr_" . $f);
                        if ($a_user) {
                            $ta->setValue($a_user->$m());
                        }
                        $options = array();
                        $lng->loadLanguageModule("meta");
                        foreach ($lng->getInstalledLanguages() as $lang_key) {
                            $options[$lang_key] = $lng->txt("meta_l_" . $lang_key);
                        }
                        asort($options); // #9728
                        $ta->setOptions($options);
                        $ta->setRequired($ilSetting->get("require_" . $f));
                        if (!$ta->getRequired() || $ta->getValue()) {
                            $ta->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        $a_form->addItem($ta);
                    }
                    break;
                    
                case "multitext":
                    if (ilUserProfile::userSettingVisible($f)) {
                        $ti = new ilTextInputGUI($lng->txt($lv), "usr_" . $f);
                        $ti->setMulti(true);
                        if ($a_user) {
                            $ti->setValue($a_user->$m());
                        }
                        $ti->setMaxLength($p["maxlength"]);
                        $ti->setSize($p["size"]);
                        $ti->setRequired($ilSetting->get("require_" . $f));
                        if (!$ti->getRequired() || $ti->getValue()) {
                            $ti->setDisabled($ilSetting->get("usr_settings_disable_" . $f));
                        }
                        if ($this->ajax_href) {
                            // add field to ajax call
                            $ti->setDataSource($this->ajax_href . "&f=" . $f);
                        }
                        $a_form->addItem($ti);
                    }
                    break;
                case "noneditable":
                    if (self::$mode == self::MODE_DESKTOP && ilUserProfile::userSettingVisible($f)) {
                        $ne = new ilNonEditableValueGUI($lng->txt($lv));
                        $ne->setValue($a_user->$m());
                        $a_form->addItem($ne);
                    }
                    break;
            }
        }
        
        // append custom fields as "other"
        if (is_array($custom_fields) && !$custom_fields_done) {
            // add "other" subheader
            if ($current_group != "other") {
                $sh = new ilFormSectionHeaderGUI();
                $sh->setTitle($lng->txt("other"));
                $a_form->addItem($sh);
            }
            foreach ($custom_fields as $custom_field) {
                $a_form->addItem($custom_field);
            }
        }
    }

Here is the call graph for this function:

getIgnorableRequiredSettings()

static ilUserProfile::getIgnorableRequiredSettings ( )

static

Returns an array of all ignorable profiel fields.

Returns

array public

ilSetting

Definition at line 905 of file class.ilUserProfile.php.

References $ilSetting, and array.

Referenced by ilObjUserGUI\handleIgnoredRequiredFields().

    {
        global $ilSetting;
        
        $ignorableSettings = array();
    
        foreach (self::$user_field as $field => $definition) {
            // !!!username and password must not be ignored!!!
            if ('username' == $field ||
                'password' == $field) {
                continue;
            }
            
            // Field is not required -> continue
            if (!$ilSetting->get('require_' . $field)) {
                continue;
            }
            
            if (self::isEditableByUser($field)) {
                $ignorableSettings[] = $field;
            }
        }
        
        return $ignorableSettings;
    }

Here is the caller graph for this function:

getLocalUserAdministrationFields()

ilUserProfile::getLocalUserAdministrationFields

(

)

Get visible fields in local user administration.

Returns

Definition at line 407 of file class.ilUserProfile.php.

References $ilSetting, $info, array, and getStandardFields().

    {
        global $ilSetting;
        
        $settings = $ilSetting->getAll();
        
        $fields = array();
        foreach ($this->getStandardFields() as $field => $info) {
            if ($ilSetting->get('usr_settings_visib_lua_' . $field, 1)) {
                $fields[$field] = $info;
            } elseif ($info['visib_lua_fix_value']) {
                $fields[$field] = $info;
            }
        }
        return $fields;
    }

Here is the call graph for this function:

getStandardFields()

ilUserProfile::getStandardFields

(

)

Get standard user fields array.

Definition at line 389 of file class.ilUserProfile.php.

References array.

Referenced by addStandardFieldsToForm(), and getLocalUserAdministrationFields().

    {
        $fields = array();
        foreach (self::$user_field as $f => $p) {
            // skip hidden groups
            if (in_array($p["group"], $this->skip_groups) ||
                in_array($f, $this->skip_fields)) {
                continue;
            }
            $fields[$f] = $p;
        }
        return $fields;
    }

Here is the caller graph for this function:

isEditableByUser()

static ilUserProfile::isEditableByUser (   $setting )

staticprotected

Returns whether a profile setting is editable by an user in the profile gui.

Parameters

string

A key of a profile setting

Returns

boolean Determines whether the passed setting can be edited by the user itself protected

ilSetting

Definition at line 877 of file class.ilUserProfile.php.

References $ilSetting.

    {
        global $ilSetting;
        
        // Not visible in personal data or not changeable
        if ($ilSetting->get('usr_settings_hide_' . $setting) == 1 ||
            $ilSetting->get('usr_settings_disable_' . $setting) == 1) {
            // User has no chance to edit this field
            return false;
        }
        
        return true;
    }

isProfileIncomplete()

static ilUserProfile::isProfileIncomplete (   $a_user,   $a_include_udf = true,   $a_personal_data_only = true  )

static

Check if all required personal data fields are set.

Parameters

ilObjUser	$a_user
bool	$a_include_udf	check custom fields, too
bool	$a_personal_data_only	only check fields which are visible in personal data

Returns

bool

Definition at line 826 of file class.ilUserProfile.php.

References $ilSetting, ilUserDefinedFields\_getInstance(), and ilLoggerFactory\getLogger().

Referenced by ilUserImportParser\checkProfileIncomplete(), ilAuthFrontend\handleAuthenticationSuccess(), ilAuthBase\loginObserver(), ilObjUserGUI\saveObject(), and ilObjUserGUI\updateObject().

    {
        global $ilSetting;
        
        // standard fields
        foreach (self::$user_field as $field => $definition) {
            // only if visible in personal data
            if ($a_personal_data_only && $ilSetting->get("usr_settings_hide_" . $field)) {
                continue;
            }
            
            if ($ilSetting->get("require_" . $field) && $definition["method"]) {
                $value = $a_user->{$definition["method"]}();
                if ($value == "") {
                    return true;
                }
            }
        }
        
        // custom fields
        if ($a_include_udf) {
            $user_defined_data = $a_user->getUserDefinedData();
            
            include_once './Services/User/classes/class.ilUserDefinedFields.php';
            $user_defined_fields = ilUserDefinedFields::_getInstance();
            foreach ($user_defined_fields->getRequiredDefinitions() as $field => $definition) {
                // only if visible in personal data
                if ($a_personal_data_only && !$definition["visible"]) {
                    continue;
                }
                
                if (!$user_defined_data["f_" . $field]) {
                    ilLoggerFactory::getLogger('user')->info('Profile is incomplete due to missing required udf.');
                    return true;
                }
            }
        }
        
        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setAjaxCallback()

ilUserProfile::setAjaxCallback

(

$a_href

)

Definition at line 785 of file class.ilUserProfile.php.

    {
        $this->ajax_href = $a_href;
    }

setMode()

static ilUserProfile::setMode (   $mode )

static

Definition at line 807 of file class.ilUserProfile.php.

References $lng, $mode, and array.

    {
        global $lng;

        if (in_array($mode, array(self::MODE_DESKTOP, self::MODE_REGISTRATION))) {
            self::$mode = $mode;
            return true;
        }
        return false;
    }

skipField()

ilUserProfile::skipField

(

$a_field

)

Skip a field.

Definition at line 436 of file class.ilUserProfile.php.

    {
        $this->skip_fields[] = $a_field;
    }

skipGroup()

ilUserProfile::skipGroup

(

$a_group

)

Skip a group.

Definition at line 428 of file class.ilUserProfile.php.

    {
        $this->skip_groups[] = $a_group;
    }

userSettingVisible()

static ilUserProfile::userSettingVisible (   $a_setting )

static

Checks whether user setting is visible.

Definition at line 793 of file class.ilUserProfile.php.

References $ilSetting.

Referenced by addStandardFieldsToForm(), and ilUserDataSet\importRecord().

    {
        global $ilSetting;

        if (self::$mode == self::MODE_DESKTOP) {
            return ($ilSetting->get("usr_settings_hide_" . $a_setting) != 1);
        } else {
            if (isset(self::$user_field[$a_setting]["visib_reg_hide"]) && self::$user_field[$a_setting]["visib_reg_hide"] === true) {
                return true;
            }
            return ($ilSetting->get("usr_settings_visib_reg_" . $a_setting, "1") || $ilSetting->get("require_" . $a_setting, "0"));
        }
    }

Here is the caller graph for this function:

Field Documentation

$mode

ilUserProfile::$mode = self::MODE_DESKTOP

staticprivate

Definition at line 20 of file class.ilUserProfile.php.

Referenced by setMode().

$user_field

ilUserProfile::$user_field

staticprivate

Definition at line 46 of file class.ilUserProfile.php.

MODE_DESKTOP

const ilUserProfile::MODE_DESKTOP = 1

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

MODE_REGISTRATION

const ilUserProfile::MODE_REGISTRATION = 2

Definition at line 18 of file class.ilUserProfile.php.

Referenced by ilAccountRegistrationGUI\__initForm(), and ilAccountRegistrationGUI\saveForm().

---

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

• Services/User/classes/class.ilUserProfile.php