ilObjectCustomUserFieldsGUI Class Reference

Collaboration diagram for ilObjectCustomUserFieldsGUI:

Public Member Functions
	__construct ($a_obj_id)
	Constructor. More...
	executeCommand ()
	Execute Command. More...
	getObjId ()
	Get obj_id of container. More...

Data Fields
const	MODE_CREATE = 1
const	MODE_UPDATE = 2

Protected Member Functions
	show ()
	Show list of custom fields. More...
	listFields ()
	List existing custom fields. More...
	saveFields ()
	Save Field settings (currently only required status) More...
	confirmDeleteFields ()
	Show delete confirmation screen. More...
	deleteFields ()
	Delete selected fields. More...
	addField ()
	Show field creation form. More...
	saveField ()
	Save field. More...
	editField ()
	Edit one field. More...
	updateField ()
	Update field definition. More...
	initFieldForm ($a_mode)
	Init/create property form for fields. More...
	editMember (ilPropertyFormGUI $form=null)
	Edit Member. More...
	cancelEditMember ()
	Cancel editing. More...
	initMemberForm ()
	Init member form. More...
	saveMember ()

Private Attributes
	$form = null
	$lng
	$tpl
	$ctrl
	$tabs_gui
	$obj_id
	$ref_id
	$cdf

Detailed Description

Author

Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version

$Id$

ilObjectCustomUserFieldsGUI

Definition at line 35 of file class.ilObjectCustomUserFieldsGUI.php.

Constructor & Destructor Documentation

__construct()

ilObjectCustomUserFieldsGUI::__construct

(

$a_obj_id

)

Constructor.

public

Parameters

Definition at line 59 of file class.ilObjectCustomUserFieldsGUI.php.

References $DIC, $ilCtrl, $lng, $tpl, ilObject\_getAllReferences(), and ilObject\_lookupType().

    {
        global $DIC;

        $lng = $DIC['lng'];
        $tpl = $DIC['tpl'];
        $ilCtrl = $DIC['ilCtrl'];
        $ilTabs = $DIC['ilTabs'];
        
        $this->lng = $lng;
        $this->lng->loadLanguageModule('ps');
        $this->lng->loadLanguageModule(ilObject::_lookupType($a_obj_id));
        
        $this->tpl = $tpl;
        $this->ctrl = $ilCtrl;
        $this->tabs_gui = $ilTabs;
        
        $this->obj_id = $a_obj_id;

        // Currently only supported for container objects
        $refs = ilObject::_getAllReferences($this->obj_id);
        $this->ref_id = end($refs);
    }

Here is the call graph for this function:

Member Function Documentation

addField()

ilObjectCustomUserFieldsGUI::addField ( )

protected

Show field creation form.

Returns

Definition at line 222 of file class.ilObjectCustomUserFieldsGUI.php.

References initFieldForm().

    {
        $this->initFieldForm(self::MODE_CREATE);
        
        $this->form->getItemByPostVar('va')->setValues(array(''));
        
        $this->tpl->setContent($this->form->getHTML());
    }

Here is the call graph for this function:

cancelEditMember()

ilObjectCustomUserFieldsGUI::cancelEditMember ( )

protected

Cancel editing.

Definition at line 411 of file class.ilObjectCustomUserFieldsGUI.php.

References $GLOBALS.

    {
        $GLOBALS['DIC']['ilCtrl']->returnToParent($this);
    }

confirmDeleteFields()

ilObjectCustomUserFieldsGUI::confirmDeleteFields ( )

protected

Show delete confirmation screen.

Returns

Definition at line 177 of file class.ilObjectCustomUserFieldsGUI.php.

References $_POST, getObjId(), listFields(), and ilUtil\sendFailure().

    {
        if (!count($_POST['field_ids'])) {
            ilUtil::sendFailure($this->lng->txt('ps_cdf_select_one'));
            $this->listFields();
            return false;
        }
        include_once './Services/Utilities/classes/class.ilConfirmationGUI.php';
        $confirm = new ilConfirmationGUI();
        $confirm->setFormAction($this->ctrl->getFormAction($this));
        $confirm->setHeaderText($this->lng->txt('ps_cdf_delete_sure'));
        
        foreach ($_POST['field_ids'] as $field_id) {
            $tmp_field = new ilCourseDefinedFieldDefinition($this->getObjId(), $field_id);
            
            $confirm->addItem('field_ids[]', $field_id, $tmp_field->getName());
        }
        
        $confirm->setConfirm($this->lng->txt('delete'), 'deleteFields');
        $confirm->setCancel($this->lng->txt('cancel'), 'listFields');
        $this->tpl->setContent($confirm->getHTML());
    }

Here is the call graph for this function:

deleteFields()

ilObjectCustomUserFieldsGUI::deleteFields ( )

protected

Delete selected fields.

Returns

Definition at line 204 of file class.ilObjectCustomUserFieldsGUI.php.

References $_POST, ilMemberAgreement\_deleteByObjId(), and listFields().

    {
        foreach ((array) $_POST['field_ids'] as $field_id) {
            $tmp_field = new ilCourseDefinedFieldDefinition($this->obj_id, $field_id);
            $tmp_field->delete();
        }
        
        ilMemberAgreement::_deleteByObjId($this->obj_id);
        
        ilUtil::sendSuccess($this->lng->txt('ps_cdf_deleted'));
        $this->listFields();
        return true;
    }

Here is the call graph for this function:

editField()

ilObjectCustomUserFieldsGUI::editField ( )

protected

Edit one field.

Parameters

object

$a_mode

Returns

Definition at line 266 of file class.ilObjectCustomUserFieldsGUI.php.

References getObjId(), initFieldForm(), and listFields().

    {
        if (!$_REQUEST['field_id']) {
            $this->listFields();
            return false;
        }
        
        $this->initFieldForm(self::MODE_UPDATE);
        
        $udf = new ilCourseDefinedFieldDefinition($this->getObjId(), (int) $_REQUEST['field_id']);
        $this->form->getItemByPostVar('na')->setValue($udf->getName());
        $this->form->getItemByPostVar('ty')->setValue($udf->getType());
        $this->form->getItemByPostVar('re')->setChecked($udf->isRequired());
        $this->form->getItemByPostVar('va')->setValues($udf->getValues());
        $this->form->getItemByPostVar('va')->setOpenAnswerIndexes($udf->getValueOptions());
        
        $this->tpl->setContent($this->form->getHTML());
    }

Here is the call graph for this function:

editMember()

ilObjectCustomUserFieldsGUI::editMember ( ilPropertyFormGUI  $form = null )

protected

Edit Member.

Parameters

ilPropertyFormGUI

$form

Definition at line 388 of file class.ilObjectCustomUserFieldsGUI.php.

References $form, $GLOBALS, getObjId(), initMemberForm(), and ilMemberAgreementGUI\setCourseDefinedFieldValues().

Referenced by saveMember().

    {
        $GLOBALS['DIC']['ilCtrl']->saveParameter($this, 'member_id');

        $GLOBALS['DIC']['ilTabs']->clearTargets();
        $GLOBALS['DIC']['ilTabs']->clearSubTabs();
        $GLOBALS['DIC']['ilTabs']->setBackTarget($this->lng->txt('back'), $this->ctrl->getLinkTarget($this, 'cancelEditMember'));
        
        
        if ($form instanceof ilPropertyFormGUI) {
            $GLOBALS['DIC']['tpl']->setContent($form->getHTML());
        } else {
            $form = $this->initMemberForm();
            ilMemberAgreementGUI::setCourseDefinedFieldValues($form, $this->getObjId(), (int) $_REQUEST['member_id']);
        }
        
        $GLOBALS['DIC']['tpl']->setContent($form->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilObjectCustomUserFieldsGUI::executeCommand

(

)

Execute Command.

public

Definition at line 89 of file class.ilObjectCustomUserFieldsGUI.php.

References $DIC, $ilErr, and $lng.

    {
        global $DIC;

        $ilErr = $DIC['ilErr'];
        $ilAccess = $DIC['ilAccess'];
        $lng = $DIC['lng'];

        if (!$ilAccess->checkAccess('write', '', $this->ref_id)) {
            $ilErr->raiseError($lng->txt('permission_denied'), $ilErr->WARNING);
        }

        $cmd = $this->ctrl->getCmd();
        
        switch ($next_class = $this->ctrl->getNextClass($this)) {
            default:
                if (!$cmd) {
                    $cmd = 'show';
                }
                $this->$cmd();
                break;
        }
    }

getObjId()

ilObjectCustomUserFieldsGUI::getObjId

(

)

Get obj_id of container.

Returns

Definition at line 117 of file class.ilObjectCustomUserFieldsGUI.php.

References $obj_id.

Referenced by confirmDeleteFields(), editField(), editMember(), initMemberForm(), listFields(), saveField(), saveFields(), saveMember(), show(), and updateField().

    {
        return $this->obj_id;
    }

Here is the caller graph for this function:

initFieldForm()

ilObjectCustomUserFieldsGUI::initFieldForm (   $a_mode )

protected

Init/create property form for fields.

Returns

Definition at line 320 of file class.ilObjectCustomUserFieldsGUI.php.

References IL_CDF_TYPE_SELECT, IL_CDF_TYPE_TEXT, ilTextWizardInputGUI\setAllowMove(), ilFormPropertyGUI\setRequired(), ilTextInputGUI\setSize(), and ilCheckboxInputGUI\setValue().

Referenced by addField(), editField(), saveField(), and updateField().

    {
        if ($this->form instanceof ilPropertyFormGUI) {
            return true;
        }
        include_once './Services/Form/classes/class.ilPropertyFormGUI.php';
        $this->form = new ilPropertyFormGUI();

        switch ($a_mode) {
            case self::MODE_CREATE:
                $this->form->setFormAction($this->ctrl->getFormAction($this));
                $this->form->setTitle($this->lng->txt('ps_cdf_add_field'));
                $this->form->addCommandButton('saveField', $this->lng->txt('save'));
                $this->form->addCommandButton('listFields', $this->lng->txt('cancel'));
                break;
                
            case self::MODE_UPDATE:
                $this->ctrl->setParameter($this, 'field_id', (int) $_REQUEST['field_id']);
                $this->form->setFormAction($this->ctrl->getFormAction($this));
                $this->form->setTitle($this->lng->txt('ps_cdf_edit_field'));
                $this->form->addCommandButton('updateField', $this->lng->txt('save'));
                $this->form->addCommandButton('listFields', $this->lng->txt('cancel'));
                break;
        }
        
        // Name
        $na = new ilTextInputGUI($this->lng->txt('ps_cdf_name'), 'na');
        $na->setSize(32);
        $na->setMaxLength(255);
        $na->setRequired(true);
        $this->form->addItem($na);
        
        // Type
        $ty = new ilRadioGroupInputGUI($this->lng->txt('ps_field_type'), 'ty');
        $ty->setRequired(true);
        $this->form->addItem($ty);
        
        if ($a_mode == self::MODE_UPDATE) {
            $ty->setDisabled(true); // #14888
        }
        
        //              Text type
        $ty_te = new ilRadioOption($this->lng->txt('ps_type_txt_long'), IL_CDF_TYPE_TEXT);
        $ty->addOption($ty_te);

        //              Select Type
        $ty_se = new ilRadioOption($this->lng->txt('ps_type_select_long'), IL_CDF_TYPE_SELECT);
        $ty->addOption($ty_se);
        
        // Select Type Values
        include_once './Services/Form/classes/class.ilSelectBuilderInputGUI.php';
        $ty_se_mu = new ilSelectBuilderInputGUI($this->lng->txt('ps_cdf_value'), 'va');
        $ty_se_mu->setAllowMove(true);
        $ty_se_mu->setRequired(true);
        $ty_se_mu->setSize(32);
        $ty_se_mu->setMaxLength(128);
        $ty_se->addSubItem($ty_se_mu);
        
        // Required
        $re = new ilCheckboxInputGUI($this->lng->txt('ps_cdf_required'), 're');
        $re->setValue(1);
        $this->form->addItem($re);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initMemberForm()

ilObjectCustomUserFieldsGUI::initMemberForm ( )

protected

Init member form.

Returns

Definition at line 420 of file class.ilObjectCustomUserFieldsGUI.php.

References $form, $GLOBALS, $name, $title, ilObjUser\_lookupName(), ilObject\_lookupType(), ilMemberAgreementGUI\addCustomFields(), and getObjId().

Referenced by editMember(), and saveMember().

    {
        include_once './Services/Form/classes/class.ilPropertyFormGUI.php';
        $form = new ilPropertyFormGUI();
        $form->setFormAction($GLOBALS['DIC']['ilCtrl']->getFormAction($this));
        $title = $this->lng->txt(ilObject::_lookupType($this->getObjId()) . '_cdf_edit_member');
        $name = ilObjUser::_lookupName((int) $_REQUEST['member_id']);
        $title .= (': ' . $name['lastname'] . ', ' . $name['firstname']);
        $form->setTitle($title);
        
        include_once './Services/Membership/classes/class.ilMemberAgreementGUI.php';
        ilMemberAgreementGUI::addCustomFields($form, $this->getObjId(), ilObject::_lookupType($this->getObjId()), 'edit');
        
        $form->addCommandButton('saveMember', $this->lng->txt('save'));
        $form->addCommandButton('cancelEditMember', $this->lng->txt('cancel'));
        
        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

listFields()

ilObjectCustomUserFieldsGUI::listFields ( )

protected

List existing custom fields.

Returns

Definition at line 138 of file class.ilObjectCustomUserFieldsGUI.php.

References $DIC, $table, ilCourseDefinedFieldDefinition\_getFields(), and getObjId().

Referenced by confirmDeleteFields(), deleteFields(), editField(), saveField(), saveFields(), show(), and updateField().

    {
        global $DIC;

        $ilToolbar = $DIC['ilToolbar'];
        
        $ilToolbar->addButton(
            $this->lng->txt('ps_cdf_add_field'),
            $this->ctrl->getLinkTarget($this, 'addField')
        );
        
        include_once './Services/Membership/classes/class.ilObjectCustomUserFieldsTableGUI.php';
        $table = new ilObjectCustomUserFieldsTableGUI($this, 'listFields');
        $table->parse(ilCourseDefinedFieldDefinition::_getFields($this->getObjId()));
        $this->tpl->setContent($table->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveField()

ilObjectCustomUserFieldsGUI::saveField ( )

protected

Save field.

Returns

Definition at line 235 of file class.ilObjectCustomUserFieldsGUI.php.

References $_POST, $GLOBALS, ilMemberAgreement\_deleteByObjId(), getObjId(), initFieldForm(), listFields(), and ilUtil\sendFailure().

    {
        $GLOBALS['DIC']->logger()->mmbr()->dump($_POST);
        $this->initFieldForm(self::MODE_CREATE);
        if ($this->form->checkInput()) {
            $udf = new ilCourseDefinedFieldDefinition($this->getObjId());
            $udf->setName($this->form->getInput('na'));
            $udf->setType($this->form->getInput('ty'));
            $udf->setValues($udf->prepareValues($this->form->getInput('va')));
            $udf->setValueOptions($this->form->getItemByPostVar('va')->getOpenAnswerIndexes()); // #14720
            $udf->enableRequired($this->form->getInput('re'));
            $udf->save();
    
            ilUtil::sendSuccess($this->lng->txt('ps_cdf_added_field'));
            // reset agreements
            ilMemberAgreement::_deleteByObjId($this->getObjId());
            $this->listFields();
            return true;
        }
        // not valid
        ilUtil::sendFailure($this->lng->txt('err_check_input'));
        $this->form->setValuesByPost();
        $this->tpl->setContent($this->form->getHTML());
        return false;
    }

Here is the call graph for this function:

saveFields()

ilObjectCustomUserFieldsGUI::saveFields ( )

protected

Save Field settings (currently only required status)

Returns

Definition at line 159 of file class.ilObjectCustomUserFieldsGUI.php.

References $_POST, ilMemberAgreement\_deleteByObjId(), ilCourseDefinedFieldDefinition\_getFields(), getObjId(), and listFields().

    {
        $fields = ilCourseDefinedFieldDefinition::_getFields($this->getObjId());
        foreach ($fields as $field_obj) {
            $field_obj->enableRequired((bool) isset($_POST['required'][$field_obj->getId()]));
            $field_obj->update();
        }
        
        ilMemberAgreement::_deleteByObjId($this->getObjId());
        ilUtil::sendSuccess($this->lng->txt('settings_saved'));
        $this->listFields();
        return true;
    }

Here is the call graph for this function:

saveMember()

ilObjectCustomUserFieldsGUI::saveMember ( )

protected

Definition at line 439 of file class.ilObjectCustomUserFieldsGUI.php.

References $DIC, $form, $GLOBALS, $ilUser, editMember(), getObjId(), IL_CAL_UNIX, initMemberForm(), ilMemberAgreementGUI\saveCourseDefinedFields(), and ilUtil\sendFailure().

    {
        global $DIC;

        $ilUser = $DIC['ilUser'];
        
        $GLOBALS['DIC']['ilCtrl']->saveParameter($this, 'member_id');
        
        $form = $this->initMemberForm();
        if ($form->checkInput()) {
            // save history
            include_once './Services/Membership/classes/class.ilObjectCustomUserFieldHistory.php';
            $history = new ilObjectCustomUserFieldHistory($this->getObjId(), (int) $_REQUEST['member_id']);
            $history->setEditingTime(new ilDateTime(time(), IL_CAL_UNIX));
            $history->setUpdateUser($ilUser->getId());
            $history->save();
            
            ilMemberAgreementGUI::saveCourseDefinedFields($form, $this->getObjId(), (int) $_REQUEST['member_id']);
            ilUtil::sendSuccess($this->lng->txt('settings_saved'), true);
            $GLOBALS['DIC']['ilCtrl']->returnToParent($this);
            return true;
        }
        
        $form->setValuesByPost();
        ilUtil::sendFailure($this->lng->txt('err_check_input'));
        return $this->editMember($form);
    }

Here is the call graph for this function:

show()

ilObjectCustomUserFieldsGUI::show ( )

protected

Show list of custom fields.

Returns

Definition at line 126 of file class.ilObjectCustomUserFieldsGUI.php.

References ilMemberAgreement\_hasAgreementsByObjId(), getObjId(), listFields(), and ilUtil\sendInfo().

    {
        if (ilMemberAgreement::_hasAgreementsByObjId($this->getObjId())) {
            ilUtil::sendInfo($this->lng->txt('ps_cdf_warning_modify'));
        }
        $this->listFields();
    }

Here is the call graph for this function:

updateField()

ilObjectCustomUserFieldsGUI::updateField ( )

protected

Update field definition.

Returns

Definition at line 289 of file class.ilObjectCustomUserFieldsGUI.php.

References ilMemberAgreement\_deleteByObjId(), getObjId(), initFieldForm(), listFields(), and ilUtil\sendFailure().

    {
        $this->initFieldForm(self::MODE_UPDATE);
        
        if ($this->form->checkInput()) {
            $udf = new ilCourseDefinedFieldDefinition($this->getObjId(), (int) $_REQUEST['field_id']);
            $udf->setName($this->form->getInput('na'));
            $udf->setType($this->form->getInput('ty'));
            $prepared = $udf->prepareValues($this->form->getInput('va'));
            $udf->setValues($prepared);
            $udf->setValueOptions($this->form->getItemByPostVar('va')->getOpenAnswerIndexes());
            $udf->enableRequired($this->form->getInput('re'));
            $udf->update();

            // Finally reset member agreements
            ilMemberAgreement::_deleteByObjId($this->getObjId());
            ilUtil::sendSuccess($this->lng->txt('settings_saved'));
            $this->listFields();
            return true;
        }
        
        ilUtil::sendFailure($this->lng->txt('err_check_input'));
        $this->form->setValuesByPost();
        $this->tpl->setContent($this->form->getHTML());
        return false;
    }

Here is the call graph for this function:

Field Documentation

$cdf

ilObjectCustomUserFieldsGUI::$cdf

private

Definition at line 50 of file class.ilObjectCustomUserFieldsGUI.php.

$ctrl

ilObjectCustomUserFieldsGUI::$ctrl

private

Definition at line 44 of file class.ilObjectCustomUserFieldsGUI.php.

$form

ilObjectCustomUserFieldsGUI::$form = null

private

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

Referenced by editMember(), initMemberForm(), and saveMember().

$lng

ilObjectCustomUserFieldsGUI::$lng

private

Definition at line 42 of file class.ilObjectCustomUserFieldsGUI.php.

Referenced by __construct(), and executeCommand().

$obj_id

ilObjectCustomUserFieldsGUI::$obj_id

private

Definition at line 47 of file class.ilObjectCustomUserFieldsGUI.php.

Referenced by getObjId().

$ref_id

ilObjectCustomUserFieldsGUI::$ref_id

private

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

$tabs_gui

ilObjectCustomUserFieldsGUI::$tabs_gui

private

Definition at line 45 of file class.ilObjectCustomUserFieldsGUI.php.

$tpl

ilObjectCustomUserFieldsGUI::$tpl

private

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

Referenced by __construct().

MODE_CREATE

const ilObjectCustomUserFieldsGUI::MODE_CREATE = 1

Definition at line 37 of file class.ilObjectCustomUserFieldsGUI.php.

MODE_UPDATE

const ilObjectCustomUserFieldsGUI::MODE_UPDATE = 2

Definition at line 38 of file class.ilObjectCustomUserFieldsGUI.php.

---

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

• Services/Membership/classes/class.ilObjectCustomUserFieldsGUI.php