ilCustomUserFieldsGUI Class Reference

Class ilCustomUserFieldsGUI. More...

Collaboration diagram for ilCustomUserFieldsGUI:

Public Member Functions
	__construct ()
&	executeCommand ()
	listUserDefinedFields ()
	List all custom user fields. More...
	addField ($a_form=null)
	Add field. More...
	getAccessOptions ()
	Get all access options, order is kept in forms. More...
	initForm ($a_mode="create")
	Init field form. More...
	create ()
	edit ($a_form=null)
	Edit field. More...
	update ()
	askDeleteField ()
	deleteField ()
	updateFields ($action="")
	Update custom fields properties (from table gui) More...

Static Public Member Functions
static	getAccessPermissions ()

Protected Member Functions
	getPermissions ()
	validateForm ($form, $user_field_definitions, array &$access, array $a_field_permissions=null)
	Validate field form. More...

Protected Attributes
	$confirm_change
	$field_id
	$field_definition
	$permissions

Detailed Description

Class ilCustomUserFieldsGUI.

Author

Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version

Id

class.ilObjUserFolderGUI.php 30361 2011-08-25 11:05:41Z jluetzen

ilCustomUserFieldsGUI:

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

Constructor & Destructor Documentation

__construct()

ilCustomUserFieldsGUI::__construct

(

)

Definition at line 24 of file class.ilCustomUserFieldsGUI.php.

References $_REQUEST, $ilCtrl, $lng, ilUserDefinedFields\_getInstance(), and ilClaimingPermissionHelper\getInstance().

        {
                global $lng, $ilCtrl;
                
                $lng->loadLanguageModule("user");               
                $lng->loadLanguageModule("administration");             
                
                $this->field_id = $_REQUEST["field_id"];
                $ilCtrl->saveParameter($this, "field_id", $this->field_id);
                
                if($this->field_id)
                {                       
                        $user_field_definitions = ilUserDefinedFields::_getInstance();
                        $this->field_definition = $user_field_definitions->getDefinition($this->field_id);
                }
                
                $this->permissions = ilUDFPermissionHelper::getInstance();
        }

Here is the call graph for this function:

Member Function Documentation

addField()

ilCustomUserFieldsGUI::addField

(

$a_form = null

)

Add field.

Parameters

ilPropertyFormGUI

$a_form

Definition at line 96 of file class.ilCustomUserFieldsGUI.php.

References $tpl, and initForm().

Referenced by create().

        {
                global $tpl;            
                
                if(!$a_form)
                {
                        $a_form = $this->initForm();
                }
                
                $tpl->setContent($a_form->getHTML());
        }

Here is the call graph for this function:

Here is the caller graph for this function:

askDeleteField()

ilCustomUserFieldsGUI::askDeleteField

(

)

Definition at line 540 of file class.ilCustomUserFieldsGUI.php.

References $_POST, $ilCtrl, $lng, $tpl, ilUserDefinedFields\_getInstance(), listUserDefinedFields(), and ilUtil\sendFailure().

        {
                global $ilCtrl, $lng, $tpl;
                
                if(!$_POST["fields"])
                {
                        ilUtil::sendFailure($lng->txt("select_one"));
                        return $this->listUserDefinedFields();
                }
        
                include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
                $confirmation_gui = new ilConfirmationGUI();
                $confirmation_gui->setFormAction($ilCtrl->getFormAction($this));
                $confirmation_gui->setHeaderText($lng->txt("udf_delete_sure"));
                $confirmation_gui->setCancel($lng->txt("cancel"), "listUserDefinedFields");
                $confirmation_gui->setConfirm($lng->txt("delete"), "deleteField");
                
                $user_field_definitions = ilUserDefinedFields::_getInstance();
                foreach($_POST["fields"] as $id)
                {                       
                        $definition = $user_field_definitions->getDefinition($id);
                        $confirmation_gui->addItem("fields[]", $id, $definition["field_name"]);
                }

                $tpl->setContent($confirmation_gui->getHTML());

                return true;
        }

Here is the call graph for this function:

create()

ilCustomUserFieldsGUI::create

(

)

Definition at line 374 of file class.ilCustomUserFieldsGUI.php.

References $_POST, $ilCtrl, $lng, ilUserDefinedFields\_getInstance(), ilMemberAgreement\_reset(), addField(), initForm(), ilUtil\sendSuccess(), and validateForm().

        {
                global $lng, $ilCtrl;
                
                $user_field_definitions = ilUserDefinedFields::_getInstance();
                $user_field_definitions->setFieldType($_POST["field_type"]);
                
                $access = array();
                $form = $this->initForm();                              
                if($this->validateForm($form, $user_field_definitions, $access))
                {
                        $user_field_definitions->setFieldName($form->getInput("name"));                                         
                        $user_field_definitions->enableVisible($access['visible']);
                        $user_field_definitions->enableVisibleRegistration((int)$access['visib_reg']);
                        $user_field_definitions->enableVisibleLocalUserAdministration($access['visib_lua']);
                        $user_field_definitions->enableCourseExport($access['course_export']);
                        $user_field_definitions->enableGroupExport($access['group_export']);
                        $user_field_definitions->enableChangeable($access['changeable']);                               
                        $user_field_definitions->enableChangeableLocalUserAdministration($access['changeable_lua']);
                        $user_field_definitions->enableRequired($access['required']);                                   
                        $user_field_definitions->enableExport($access['export']);
                        $user_field_definitions->enableSearchable($access['searchable']);
                        $user_field_definitions->enableCertificate($access['certificate']);
                        $user_field_definitions->add();

                        if ($access['course_export'])
                        {
                                include_once('Services/Membership/classes/class.ilMemberAgreement.php');
                                ilMemberAgreement::_reset();                    
                        }

                        ilUtil::sendSuccess($lng->txt('udf_added_field'), true);
                        $ilCtrl->redirect($this);
                }
                
                $form->setValuesByPost();
                $this->addField($form); 
        }

Here is the call graph for this function:

deleteField()

ilCustomUserFieldsGUI::deleteField

(

)

Definition at line 569 of file class.ilCustomUserFieldsGUI.php.

References $_POST, $ilCtrl, $lng, ilUserDefinedFields\_getInstance(), ilUDFPermissionHelper\ACTION_FIELD_DELETE, ilUDFPermissionHelper\CONTEXT_FIELD, getPermissions(), ilUtil\sendFailure(), and ilUtil\sendSuccess().

        {
                global $lng, $ilCtrl;
                
                $user_field_definitions = ilUserDefinedFields::_getInstance();
                
                // all fields have to be deletable
                $fail = array();
                foreach($_POST["fields"] as $id)
                {
                        if(!$this->getPermissions()->hasPermission(
                                ilUDFPermissionHelper::CONTEXT_FIELD,
                                $id,
                                ilUDFPermissionHelper::ACTION_FIELD_DELETE))
                        {               
                                $field = $user_field_definitions->getDefinition($id);                                                           
                                $fail[] = $field["field_name"]; 
                        }
                }
                if($fail)
                {
                        ilUtil::sendFailure($lng->txt('msg_no_perm_delete')." ".implode(", ", $fail), true);
                        $ilCtrl->redirect($this, "listUserDefinedFields");      
                }
                
                foreach($_POST["fields"] as $id)
                {
                        $user_field_definitions->delete($id);
                }

                ilUtil::sendSuccess($lng->txt('udf_field_deleted'), true);
                $ilCtrl->redirect($this);
        }

Here is the call graph for this function:

edit()

ilCustomUserFieldsGUI::edit

(

$a_form = null

)

Edit field.

Parameters

ilPropertyFormGUI

$a_form

Definition at line 418 of file class.ilCustomUserFieldsGUI.php.

References $tpl, and initForm().

Referenced by update().

        {
                global $tpl;            
                
                if(!$a_form)
                {
                        $a_form = $this->initForm("edit");
                }
                
                $tpl->setContent($a_form->getHTML());
        }               

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

& ilCustomUserFieldsGUI::executeCommand

(

)

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

References $cmd, and $ilCtrl.

        {
                global $ilCtrl;
                
                $next_class = $ilCtrl->getNextClass($this);
                $cmd = $ilCtrl->getCmd();
                
                switch($next_class)
                {
                        default:
                                if(!$cmd)
                                {
                                        $cmd = "listUserDefinedFields";
                                }                               
                                $this->$cmd();
                                break;
                }
                return true;
        }

getAccessOptions()

ilCustomUserFieldsGUI::getAccessOptions

(

)

Get all access options, order is kept in forms.

Returns

array

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

References $lng.

Referenced by initForm(), and validateForm().

        {       
                global $lng;
                
                $opts = array();
                $opts["visible"] = $lng->txt("user_visible_in_profile");
                $opts["visib_reg"] = $lng->txt("visible_registration");
                $opts["visib_lua"] = $lng->txt("usr_settings_visib_lua");
                $opts["course_export"] = $lng->txt("course_export");
                $opts["group_export"] = $lng->txt("group_export");
                $opts["changeable"] = $lng->txt("changeable");
                $opts["changeable_lua"] = $lng->txt("usr_settings_changeable_lua");
                $opts["required"] = $lng->txt("required_field");
                $opts["export"] = $lng->txt("export");
                $opts["searchable"] = $lng->txt("header_searchable");
                $opts["certificate"] = $lng->txt("certificate");                
                return $opts;           
        }

Here is the caller graph for this function:

getAccessPermissions()

static ilCustomUserFieldsGUI::getAccessPermissions ( )

static

Definition at line 132 of file class.ilCustomUserFieldsGUI.php.

References ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CERTIFICATE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_EXPORT, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_REQUIRED, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_SEARCHABLE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_COURSES, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL, and ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION.

Referenced by ilCustomUserFieldSettingsTableGUI\__construct().

        {
                return array("visible" => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL,
                        "changeable" => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL,
                        "searchable" => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_SEARCHABLE,
                        "required"  => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_REQUIRED,
                        "export" => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_EXPORT,
                        "course_export" => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_COURSES,
                        'group_export' => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS,
                        "visib_reg" => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION,
                        'visib_lua' => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL,
                        'changeable_lua' => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL,
                        'certificate' => ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CERTIFICATE
                );
        }

Here is the caller graph for this function:

getPermissions()

ilCustomUserFieldsGUI::getPermissions ( )

protected

Definition at line 43 of file class.ilCustomUserFieldsGUI.php.

References $permissions.

Referenced by deleteField(), and listUserDefinedFields().

        {
                return $this->permissions;
        }

Here is the caller graph for this function:

initForm()

ilCustomUserFieldsGUI::initForm

(

$a_mode = "create"

)

Init field form.

Parameters

string

$a_mode

Returns

ilPropertyFormGUI

Definition at line 154 of file class.ilCustomUserFieldsGUI.php.

References $ilCtrl, $lng, ilMemberAgreement\_hasAgreements(), ilUDFPermissionHelper\ACTION_FIELD_EDIT_ACCESS, ilUDFPermissionHelper\ACTION_FIELD_EDIT_PROPERTY, ilUDFPermissionHelper\CONTEXT_FIELD, getAccessOptions(), ilUtil\sendInfo(), ilFormPropertyGUI\setDisabled(), ilFormPropertyGUI\setRequired(), ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CERTIFICATE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_EXPORT, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_REQUIRED, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_SEARCHABLE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_COURSES, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION, ilUDFPermissionHelper\SUBACTION_FIELD_PROPERTIES, ilUDFPermissionHelper\SUBACTION_FIELD_TITLE, UDF_TYPE_SELECT, UDF_TYPE_TEXT, and UDF_TYPE_WYSIWYG.

Referenced by addField(), create(), edit(), and update().

        {
                global $ilCtrl, $lng;
                                
                include_once("Services/Membership/classes/class.ilMemberAgreement.php");
                if (ilMemberAgreement::_hasAgreements())
                {
                        $lng->loadLanguageModule("ps");
                        ilUtil::sendInfo($lng->txt("ps_warning_modify"));
                }
                
                if($this->field_definition)
                {
                        $perms = $this->permissions->hasPermissions(ilUDFPermissionHelper::CONTEXT_FIELD,
                                $this->field_definition["field_id"], array(
                                        array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_TITLE)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_PROPERTIES)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_COURSES)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_REQUIRED)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_EXPORT)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_SEARCHABLE)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CERTIFICATE)
                        ));
                        
                        $perm_map = self::getAccessPermissions();
                }
                
                include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
                $form = new ilPropertyFormGUI();
                $form->setFormAction($ilCtrl->getFormAction($this));
                
                $name = new ilTextInputGUI($lng->txt("field_name"), "name");
                $name->setRequired(true);
                $form->addItem($name);
                
                if($perms && !$perms[ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilUDFPermissionHelper::SUBACTION_FIELD_TITLE])
                {
                        $name->setDisabled(true);
                }
                
                // type
                $radg = new ilRadioGroupInputGUI($lng->txt("field_type"), "field_type");
                $radg->setRequired(true);               
                        $op1 = new ilRadioOption($lng->txt("udf_type_text"), UDF_TYPE_TEXT);
                        $radg->addOption($op1);
                        $op2 = new ilRadioOption($lng->txt("udf_type_select"), UDF_TYPE_SELECT);
                        $radg->addOption($op2);
                        $op3 = new ilRadioOption($lng->txt("udf_type_wysiwyg"), UDF_TYPE_WYSIWYG);
                        $radg->addOption($op3);
                $form->addItem($radg);
                
                // select values
                $se_mu = new ilTextWizardInputGUI($lng->txt("value"), "selvalue");
                $se_mu->setRequired(true);
                $se_mu->setSize(32);
                $se_mu->setMaxLength(128);
                $se_mu->setValues(array(''));           
                $op2->addSubItem($se_mu);
                
                if($perms && !$perms[ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilUDFPermissionHelper::SUBACTION_FIELD_PROPERTIES])
                {
                        $se_mu->setDisabled(true);
                        $se_mu->setRequired(false);
                }
                                                
                // access
                $acc = new ilCheckboxGroupInputGUI($lng->txt("access"), "access");
                        
                        $acc_values = array();
                        foreach($this->getAccessOptions() as $id => $caption)
                        {
                                $opt = new ilCheckboxOption($caption, $id);
                                $acc->addOption($opt);
                                
                                if($this->field_definition && $this->field_definition[$id])
                                {
                                        $acc_values[] = $id;
                                }
                                
                                if($perms && !$perms[ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS][$perm_map[$id]])
                                {
                                        $opt->setDisabled(true);
                                }
                        }
                
                $form->addItem($acc);
                                
                if($a_mode == "create")
                {
                        $radg->setValue(UDF_TYPE_TEXT);                 
                        
                        $form->setTitle($lng->txt('add_new_user_defined_field'));
                                                                        
                        $form->addCommandButton("create", $lng->txt("save"));
                        $form->addCommandButton("listUserDefinedFields", $lng->txt("cancel"));
                }
                else
                {                       
                        $name->setValue($this->field_definition["field_name"]);
                        $radg->setValue($this->field_definition["field_type"]);
                        $radg->setDisabled(true);
                        $acc->setValue($acc_values);
                        
                        switch($this->field_definition["field_type"])
                        {
                                case UDF_TYPE_SELECT:
                                        $se_mu->setValue($this->field_definition["field_values"]);
                                        $form->setTitle($lng->txt("udf_update_select_field"));
                                        break;
                                
                                case UDF_TYPE_TEXT:
                                        $form->setTitle($lng->txt("udf_update_text_field"));
                                        break;
                                
                                case UDF_TYPE_WYSIWYG:
                                        $form->setTitle($lng->txt("udf_update_wysiwyg_field"));
                                        break;
                        }
                        
                        $form->addCommandButton("update", $lng->txt("save"));
                        $form->addCommandButton("listUserDefinedFields", $lng->txt("cancel"));
                }
                
                return $form;           
        }

Here is the call graph for this function:

Here is the caller graph for this function:

listUserDefinedFields()

ilCustomUserFieldsGUI::listUserDefinedFields

(

)

List all custom user fields.

Definition at line 71 of file class.ilCustomUserFieldsGUI.php.

References $_GET, $ilCtrl, $lng, $tab, $tpl, ilUDFPermissionHelper\ACTION_UDF_CREATE_FIELD, ilUDFPermissionHelper\CONTEXT_UDF, and getPermissions().

Referenced by askDeleteField(), and updateFields().

        {
                global $lng, $tpl, $ilToolbar, $ilCtrl;
                                
                if($this->getPermissions()->hasPermission(ilUDFPermissionHelper::CONTEXT_UDF, 
                        (int)$_GET["ref_id"], ilUDFPermissionHelper::ACTION_UDF_CREATE_FIELD))
                {
                        $ilToolbar->addButton($lng->txt("add_user_defined_field"),
                                $ilCtrl->getLinkTarget($this, "addField")); 
                }
                
                include_once("./Services/User/classes/class.ilCustomUserFieldSettingsTableGUI.php");
                $tab = new ilCustomUserFieldSettingsTableGUI($this, "listUserDefinedFields", $this->getPermissions());
                if($this->confirm_change) 
                {
                        $tab->setConfirmChange();
                }
                $tpl->setContent($tab->getHTML());
        }

Here is the call graph for this function:

Here is the caller graph for this function:

update()

ilCustomUserFieldsGUI::update

(

)

Definition at line 430 of file class.ilCustomUserFieldsGUI.php.

References $ilCtrl, $lng, ilUserDefinedFields\_getInstance(), ilMemberAgreement\_reset(), ilUDFPermissionHelper\ACTION_FIELD_EDIT_ACCESS, ilUDFPermissionHelper\ACTION_FIELD_EDIT_PROPERTY, ilUDFPermissionHelper\CONTEXT_FIELD, ilUserDefinedData\deleteFieldValue(), edit(), initForm(), ilUtil\sendSuccess(), ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CERTIFICATE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_EXPORT, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_REQUIRED, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_SEARCHABLE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_COURSES, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION, ilUDFPermissionHelper\SUBACTION_FIELD_PROPERTIES, ilUDFPermissionHelper\SUBACTION_FIELD_TITLE, UDF_TYPE_SELECT, and validateForm().

        {
                global $lng, $ilCtrl;
                
                $user_field_definitions = ilUserDefinedFields::_getInstance();
                $user_field_definitions->setFieldType($this->field_definition["field_type"]);
                
                // gather old select options 
                $old_options = null;
                if($this->field_id)
                {                       
                        $old_values = $user_field_definitions->getDefinition($this->field_id);
                        if($old_values["field_type"] == UDF_TYPE_SELECT)
                        {
                                $old_options = $old_values["field_values"];
                        }
                        
                        $perms = $this->permissions->hasPermissions(ilUDFPermissionHelper::CONTEXT_FIELD,
                                $this->field_id, array(
                                        array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_TITLE)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_PROPERTIES)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_COURSES)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_REQUIRED)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_EXPORT)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_SEARCHABLE)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CERTIFICATE)
                        ));                                             
                }
                
                $access = array();
                $form = $this->initForm("edit");                                
                if($this->validateForm($form, $user_field_definitions, $access, $perms) && $this->field_id)
                {
                        // field values are set in validateForm()...
                        
                        if(!$perms || $perms[ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilUDFPermissionHelper::SUBACTION_FIELD_PROPERTIES])
                        {
                                // diff old select options against new to handle deleted values properly
                                if(is_array($old_options))
                                {
                                        foreach($old_options as $old_option)
                                        {
                                                if(!in_array($old_option, $user_field_definitions->getFieldValues()))
                                                {
                                                         ilUserDefinedData::deleteFieldValue($this->field_id, $old_option);                                             
                                                }
                                        }
                                }                       
                        }
                        // disabled fields
                        else if(is_array($old_options))
                        {
                                $user_field_definitions->setFieldValues($old_options);
                        }
                                                
                        if(!$perms || $perms[ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilUDFPermissionHelper::SUBACTION_FIELD_TITLE])
                        {
                                $user_field_definitions->setFieldName($form->getInput("name"));                                                         
                        }
                        else
                        {
                                $user_field_definitions->setFieldName($this->field_definition["field_name"]);                   
                        }
                
                        $user_field_definitions->enableVisible($access['visible']);
                        $user_field_definitions->enableVisibleRegistration((int)$access['visib_reg']);
                        $user_field_definitions->enableVisibleLocalUserAdministration($access['visib_lua']);
                        $user_field_definitions->enableCourseExport($access['course_export']);
                        $user_field_definitions->enableGroupExport($access['group_export']);
                        $user_field_definitions->enableChangeable($access['changeable']);                               
                        $user_field_definitions->enableChangeableLocalUserAdministration($access['changeable_lua']);
                        $user_field_definitions->enableRequired($access['required']);                                   
                        $user_field_definitions->enableExport($access['export']);
                        $user_field_definitions->enableSearchable($access['searchable']);
                        $user_field_definitions->enableCertificate($access['certificate']);
                        $user_field_definitions->update($this->field_id);

                        if ($access['course_export'])
                        {
                                include_once('Services/Membership/classes/class.ilMemberAgreement.php');
                                ilMemberAgreement::_reset();                    
                        }

                        ilUtil::sendSuccess($lng->txt('udf_added_field'), true);
                        $ilCtrl->redirect($this);
                }
                
                $form->setValuesByPost();
                $this->edit($form);     
        }

Here is the call graph for this function:

updateFields()

ilCustomUserFieldsGUI::updateFields

(

$action = ""

)

Update custom fields properties (from table gui)

Definition at line 606 of file class.ilCustomUserFieldsGUI.php.

References $_POST, $field_id, $ilCtrl, $lng, ilUserDefinedFields\_getInstance(), ilUDFPermissionHelper\ACTION_FIELD_EDIT_ACCESS, ilUDFPermissionHelper\CONTEXT_FIELD, listUserDefinedFields(), ilUtil\sendFailure(), ilUtil\sendSuccess(), ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CERTIFICATE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_EXPORT, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_REQUIRED, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_SEARCHABLE, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_COURSES, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL, ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL, and ilUDFPermissionHelper\SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION.

        {
                global $lng, $ilCtrl;
                
                $user_field_definitions = ilUserDefinedFields::_getInstance();
                $a_fields = $user_field_definitions->getDefinitions();
                
                $perm_map =     self::getAccessPermissions();
                
                foreach($a_fields as $field_id => $definition)
                {
                        $perms = $this->permissions->hasPermissions(ilUDFPermissionHelper::CONTEXT_FIELD,
                                $field_id, array(
                                        array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_PERSONAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_REGISTRATION)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_LOCAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_COURSES)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_VISIBLE_GROUPS)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_PERSONAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CHANGEABLE_LOCAL)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_REQUIRED)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_EXPORT)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_SEARCHABLE)
                                        ,array(ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS,
                                                ilUDFPermissionHelper::SUBACTION_FIELD_ACCESS_CERTIFICATE)
                        ));
                        
                        // disabled field
                        foreach($perm_map as $prop => $perm)
                        {
                                if (!$perms[ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS][$perm])
                                {
                                        $_POST['chb'][$prop.'_'.$field_id] = $definition[$prop];
                                }
                        }                               
                }
                
                foreach($a_fields as $field_id => $definition)
                {
                        if( isset($_POST['chb']['required_'.$field_id]) && (int)$_POST['chb']['required_'.$field_id] &&
                                (!isset($_POST['chb']['visib_reg_'.$field_id]) || !(int)$_POST['chb']['visib_reg_'.$field_id]))
                        {
                                $this->confirm_change = true;
        
                                ilUtil::sendFailure($lng->txt('invalid_visible_required_options_selected'));
                                $this->listUserDefinedFields();
                                return false;
                        }               
                }
                
                foreach($a_fields as $field_id => $definition)
                {                       
                        $user_field_definitions->setFieldName($definition['field_name']);
                        $user_field_definitions->setFieldType($definition['field_type']);
                        $user_field_definitions->setFieldValues($definition['field_values']);
                        $user_field_definitions->enableVisible((int)$_POST['chb']['visible_'.$field_id]);
                        $user_field_definitions->enableChangeable((int)$_POST['chb']['changeable_'.$field_id]);
                        $user_field_definitions->enableRequired((int)$_POST['chb']['required_'.$field_id]);
                        $user_field_definitions->enableSearchable((int)$_POST['chb']['searchable_'.$field_id]);
                        $user_field_definitions->enableExport((int)$_POST['chb']['export_'.$field_id]);
                        $user_field_definitions->enableCourseExport((int)$_POST['chb']['course_export_'.$field_id]);
                        $user_field_definitions->enableVisibleLocalUserAdministration((int)$_POST['chb']['visib_lua_'.$field_id]);
                        $user_field_definitions->enableChangeableLocalUserAdministration((int)$_POST['chb']['changeable_lua_'.$field_id]);
                        $user_field_definitions->enableGroupExport((int)$_POST['chb']['group_export_'.$field_id]);
                        $user_field_definitions->enableVisibleRegistration((int)$_POST['chb']['visib_reg_'.$field_id]);
                        $user_field_definitions->enableCertificate((int)$_POST['chb']['certificate_'.$field_id]);

                        $user_field_definitions->update($field_id);
                }

                ilUtil::sendSuccess($lng->txt('settings_saved'), true);
                $ilCtrl->redirect($this);
        }

Here is the call graph for this function:

validateForm()

ilCustomUserFieldsGUI::validateForm (   $form,   $user_field_definitions, array &  $access, array  $a_field_permissions = null  )

protected

Validate field form.

Parameters

ilPropertyFormGUI	$form
ilUserDefinedFields	$user_field_definitions
array	$access
array	$a_field_permissions

Returns

bool

Definition at line 308 of file class.ilCustomUserFieldsGUI.php.

References $lng, $valid, ilUDFPermissionHelper\ACTION_FIELD_EDIT_ACCESS, ilUDFPermissionHelper\ACTION_FIELD_EDIT_PROPERTY, getAccessOptions(), ilUtil\sendFailure(), ilUDFPermissionHelper\SUBACTION_FIELD_PROPERTIES, UDF_DUPLICATE_VALUES, and UDF_TYPE_SELECT.

Referenced by create(), and update().

        {
                global $lng;
                
                if($form->checkInput())
                {
                        $valid = true;  
                                                        
                        $incoming = (array)$form->getInput("access");
                                                
                        if($a_field_permissions)
                        {
                                $perm_map = self::getAccessPermissions();                       
                        }
                                                                                                                                                
                        $access = array();
                        foreach(array_keys($this->getAccessOptions()) as $id)
                        {
                                $access[$id] = in_array($id, $incoming);
                                
                                // disabled fields
                                if($a_field_permissions && !$a_field_permissions[ilUDFPermissionHelper::ACTION_FIELD_EDIT_ACCESS][$perm_map[$id]])
                                {
                                        $access[$id] = $this->field_definition[$id];
                                }
                        }
                        
                        if($access['required'] && !$access['visib_reg'])
                        {
                                $this->confirm_change = true;                           
                                $form->getItemByPostVar("access")->setAlert($lng->txt('udf_required_requires_visib_reg'));      
                                $valid = false;
                        }

                        if(!$this->field_id && $user_field_definitions->nameExists($form->getInput("name")))
                        {
                                $form->getItemByPostVar("name")->setAlert($lng->txt('udf_name_already_exists'));        
                                $valid = false;
                        }
        
                        if($form->getInput("field_type") == UDF_TYPE_SELECT &&
                                (!$a_field_permissions || $a_field_permissions[ilUDFPermissionHelper::ACTION_FIELD_EDIT_PROPERTY][ilUDFPermissionHelper::SUBACTION_FIELD_PROPERTIES]))
                        {
                                $user_field_definitions->setFieldValues($form->getInput("selvalue"));
                                if($error = $user_field_definitions->validateValues())
                                {
                                        switch($error)
                                        {
                                                case UDF_DUPLICATE_VALUES:
                                                        $form->getItemByPostVar("selvalue")->setAlert($lng->txt('udf_duplicate_entries'));      
                                                        $valid = false;
                                                        break;
                                        }
                                }
                        }               
                        
                        if(!$valid)
                        {
                                ilUtil::sendFailure($lng->txt("form_input_not_valid"));
                        }
                        return $valid;
                }
                
                return false;
        }       

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$confirm_change

ilCustomUserFieldsGUI::$confirm_change

protected

Definition at line 19 of file class.ilCustomUserFieldsGUI.php.

$field_definition

ilCustomUserFieldsGUI::$field_definition

protected

Definition at line 21 of file class.ilCustomUserFieldsGUI.php.

$field_id

ilCustomUserFieldsGUI::$field_id

protected

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

Referenced by updateFields().

$permissions

ilCustomUserFieldsGUI::$permissions

protected

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

Referenced by getPermissions().

---

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

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