Collaboration diagram for ilMemberAgreementGUI:

Public Member Functions
	__construct (int $a_ref_id)

	executeCommand ()

	getPrivacy ()

	getAgreement ()

Static Public Member Functions
static	addExportFieldInfo (ilPropertyFormGUI $form, int $a_obj_id, string $a_type)

static	addAgreement (ilPropertyFormGUI $form, int $a_obj_id, string $a_type)

static	addCustomFields (ilPropertyFormGUI $form, int $a_obj_id, string $a_type, string $a_mode='user')

static	setCourseDefinedFieldValues (ilPropertyFormGUI $form, int $a_obj_id, int $a_usr_id=0)

static	saveCourseDefinedFields (ilPropertyFormGUI $form, int $a_obj_id, int $a_usr_id=0)

Protected Member Functions
	showAgreement (?ilPropertyFormGUI $form=null)
	Show agreement form. More...

	initFormAgreement ()

Protected Attributes
GlobalHttpState	$http

Factory	$refinery

Private Member Functions
	save ()

	checkAgreement ()

	init ()

	sendInfoMessage ()

Private Attributes
int	$ref_id

int	$obj_id

string	$type

ilCtrlInterface	$ctrl

ilLanguage	$lng

ilGlobalTemplateInterface	$tpl

ilObjUser	$user

ilPrivacySettings	$privacy

ilMemberAgreement	$agreement

bool	$required_fullfilled = false

bool	$agreement_required = false

Detailed Description

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om @ilCtrl_Calls ilMemberAgreementGUI: \

Definition at line 31 of file class.ilMemberAgreementGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilMemberAgreementGUI::__construct ( int $a_ref_id )

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

    {
        global $DIC;
 
        $this->http = $DIC->http();
        $this->refinery = $DIC->refinery();
 
        $this->ref_id = $a_ref_id;
        $this->obj_id = ilObject::_lookupObjId($this->ref_id);
        $this->type = ilObject::_lookupType($this->obj_id);
        $this->ctrl = $DIC->ctrl();
        $this->tpl = $DIC->ui()->mainTemplate();
        $this->lng = $DIC->language();
        $this->lng->loadLanguageModule('ps');
        $this->user = $DIC->user();
 
        $this->privacy = ilPrivacySettings::getInstance();
        $this->agreement = new ilMemberAgreement($DIC->user()->getId(), $this->obj_id);
        $this->init();
    }

References $DIC, ilObject\_lookupObjId(), ilObject\_lookupType(), ILIAS\Repository\ctrl(), ilPrivacySettings\getInstance(), ILIAS\FileDelivery\http(), init(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ addAgreement()

static ilMemberAgreementGUI::addAgreement	(	ilPropertyFormGUI	$form,
		int	$a_obj_id,
		string	$a_type
	)

static

Definition at line 155 of file class.ilMemberAgreementGUI.php.

                                                                                               : ilPropertyFormGUI
    {
        global $DIC;
 
        $lng = $DIC['lng'];
 
        $agreement = new ilCheckboxInputGUI($lng->txt($a_type . '_agree'), 'agreement');
        $agreement->setRequired(true);
        $agreement->setOptionTitle($lng->txt($a_type . '_info_agree'));
        $agreement->setValue('1');
        $form->addItem($agreement);
 
        return $form;
    }

References $DIC, $lng, and ilPropertyFormGUI\addItem().

Referenced by ilRegistrationGUI\fillAgreement(), and initFormAgreement().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addCustomFields()

static ilMemberAgreementGUI::addCustomFields	(	ilPropertyFormGUI	$form,
		int	$a_obj_id,
		string	$a_type,
		string	$a_mode = `'user'`
	)

static

Definition at line 170 of file class.ilMemberAgreementGUI.php.

     : ilPropertyFormGUI {
        global $DIC;
 
        $lng = $DIC['lng'];
 
        if (!count($cdf_fields = ilCourseDefinedFieldDefinition::_getFields($a_obj_id))) {
            return $form;
        }
 
        if ($a_mode === 'user') {
            $cdf = new ilNonEditableValueGUI($lng->txt('ps_' . $a_type . '_user_fields'));
            $cdf->setValue($lng->txt($a_type . '_ps_cdf_info'));
            $cdf->setRequired(true);
        }
 
        foreach ($cdf_fields as $field_obj) {
            switch ($field_obj->getType()) {
                case ilCourseDefinedFieldDefinition::IL_CDF_TYPE_SELECT:
 
                    if ($field_obj->getValueOptions()) {
                        // Show as radio group
                        $option_radios = new ilRadioGroupInputGUI($field_obj->getName(), 'cdf_' . $field_obj->getId());
                        if ($field_obj->isRequired()) {
                            $option_radios->setRequired(true);
                        }
 
                        $open_answer_indexes = $field_obj->getValueOptions();
                        foreach ($field_obj->getValues() as $key => $val) {
                            $option_radio = new ilRadioOption($val, $field_obj->getId() . '_' . $key);
 
                            // open answers
                            if (in_array($key, $open_answer_indexes)) {
                                $open_answer = new ilTextInputGUI(
                                    $lng->txt("form_open_answer"),
                                    'cdf_oa_' . $field_obj->getId() . '_' . $key
                                );
                                $open_answer->setRequired(true);
                                $option_radio->addSubItem($open_answer);
                            }
 
                            $option_radios->addOption($option_radio);
                        }
                        if ($a_mode === 'user') {
                            $cdf->addSubItem($option_radios);
                        } else {
                            $form->addItem($option_radios);
                        }
                    } else {
                        $select = new ilSelectInputGUI($field_obj->getName(), 'cdf_' . $field_obj->getId());
                        $select->setOptions($field_obj->prepareSelectBox());
                        if ($field_obj->isRequired()) {
                            $select->setRequired(true);
                        }
                        if ($a_mode === 'user') {
                            $cdf->addSubItem($select);
                        } else {
                            $form->addItem($select);
                        }
                    }
                    break;
 
                case ilCourseDefinedFieldDefinition::IL_CDF_TYPE_TEXT:
                    $text = new ilTextInputGUI($field_obj->getName(), 'cdf_' . $field_obj->getId());
                    $text->setSize(32);
                    $text->setMaxLength(255);
                    if ($field_obj->isRequired()) {
                        $text->setRequired(true);
                    }
                    if ($a_mode === 'user') {
                        $cdf->addSubItem($text);
                    } else {
                        $form->addItem($text);
                    }
                    break;
            }
        }
        if ($a_mode === 'user') {
            $form->addItem($cdf);
        }
        return $form;
    }

Referenced by ilRegistrationGUI\fillAgreement(), initFormAgreement(), and ilObjectCustomUserFieldsGUI\initMemberForm().

Here is the caller graph for this function:

◆ addExportFieldInfo()

static ilMemberAgreementGUI::addExportFieldInfo	(	ilPropertyFormGUI	$form,
		int	$a_obj_id,
		string	$a_type
	)

static

Definition at line 121 of file class.ilMemberAgreementGUI.php.

     : ilPropertyFormGUI {
        global $DIC;
 
        $lng = $DIC->language();
        $profile = $DIC['user']->getProfile();
 
        $type = ilObject::_lookupType($a_obj_id);
        $fields_info = ilExportFieldsInfo::_getInstanceByType($type);
 
        $fields = new ilCustomInputGUI($lng->txt($a_type . '_user_agreement'), '');
        $tpl = new ilTemplate('tpl.agreement_form.html', true, true, 'components/ILIAS/Membership');
        $tpl->setVariable('TXT_INFO_AGREEMENT', $lng->txt($a_type . '_info_agreement'));
        foreach ($fields_info->getExportableFields() as $field) {
            $tpl->setCurrentBlock('field_item');
            $tpl->setVariable('FIELD_NAME', $lng->txt($field));
            $tpl->parseCurrentBlock();
        }
 
        // #17609 - not part of ilExportFieldsInfo::getExportableFields()
        // see ilExportFieldsInfo::getSelectableFieldsInfo()
        foreach ($profile->getVisibleUserDefinedFields(Context::buildFromObjectType($type)) as $field) {
            $tpl->setCurrentBlock('field_item');
            $tpl->setVariable('FIELD_NAME', $field->getLabel($lng));
            $tpl->parseCurrentBlock();
        }
        $fields->setHtml($tpl->get());
        $form->addItem($fields);
        return $form;
    }

Referenced by ilRegistrationGUI\fillAgreement(), and initFormAgreement().

Here is the caller graph for this function:

◆ checkAgreement()

ilMemberAgreementGUI::checkAgreement ( )

private

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

                                     : bool
    {
        $agreement = false;
        if ($this->http->wrapper()->post()->has('agreement')) {
            $agreement = $this->http->wrapper()->post()->retrieve(
                'agreement',
                $this->refinery->kindlyTo()->bool()
            );
        }
        if ($agreement) {
            return true;
        }
        if ($this->privacy->confirmationRequired($this->type)) {
            return false;
        }
        return true;
    }

References ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Here is the call graph for this function:

◆ executeCommand()

ilMemberAgreementGUI::executeCommand ( )

Definition at line 68 of file class.ilMemberAgreementGUI.php.

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

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ getAgreement()

ilMemberAgreementGUI::getAgreement ( )

Definition at line 88 of file class.ilMemberAgreementGUI.php.

                                  : ilMemberAgreement
    {
        return $this->agreement;
    }

References $agreement.

◆ getPrivacy()

ilMemberAgreementGUI::getPrivacy ( )

Definition at line 83 of file class.ilMemberAgreementGUI.php.

                                : ilPrivacySettings
    {
        return $this->privacy;
    }

References $privacy.

Referenced by initFormAgreement().

Here is the caller graph for this function:

◆ init()

ilMemberAgreementGUI::init ( )

private

Definition at line 392 of file class.ilMemberAgreementGUI.php.

                           : void
    {
        $this->required_fullfilled = ilCourseUserData::_checkRequired($this->user->getId(), $this->obj_id);
        $this->agreement_required = $this->getAgreement()->agreementRequired();
    }

References ilCourseUserData\_checkRequired(), and ILIAS\Repository\user().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFormAgreement()

ilMemberAgreementGUI::initFormAgreement ( )

protected

Definition at line 105 of file class.ilMemberAgreementGUI.php.

                                          : ilPropertyFormGUI
    {
        $form = new ilPropertyFormGUI();
        $form->setTitle($this->lng->txt($this->type . '_agreement_header'));
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->addCommandButton('save', $this->lng->txt('save'));
 
        $form = self::addExportFieldInfo($form, $this->obj_id, $this->type);
        $form = self::addCustomFields($form, $this->obj_id, $this->type);
 
        if ($this->getPrivacy()->confirmationRequired($this->type)) {
            $form = self::addAgreement($form, $this->obj_id, $this->type);
        }
        return $form;
    }

References addAgreement(), addCustomFields(), addExportFieldInfo(), ILIAS\Repository\ctrl(), getPrivacy(), and ILIAS\Repository\lng().

Referenced by showAgreement().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilMemberAgreementGUI::save ( )

private

Definition at line 257 of file class.ilMemberAgreementGUI.php.

                           : bool
    {
        $form = $this->initFormAgreement();
 
        // #14715 - checkInput() does not work for checkboxes
        if ($this->checkAgreement() && $form->checkInput()) {
            self::saveCourseDefinedFields($form, $this->obj_id);
 
            $this->getAgreement()->setAccepted(true);
            $this->getAgreement()->setAcceptanceTime(time());
            $this->getAgreement()->save();
 
            $history = new ilObjectCustomUserFieldHistory($this->obj_id, $this->user->getId());
            $history->setUpdateUser($this->user->getId());
            $history->setEditingTime(new ilDateTime(time(), IL_CAL_UNIX));
            $history->save();
 
            $this->ctrl->returnToParent($this);
        } elseif (!$this->checkAgreement()) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt($this->type . '_agreement_required'));
            $form->setValuesByPost();
            $this->showAgreement($form);
            return false;
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('fill_out_all_required_fields'));
            $form->setValuesByPost();
            $this->showAgreement($form);
            return false;
        }
        return true;
    }

References ilPropertyFormGUI\checkInput(), ILIAS\Repository\ctrl(), IL_CAL_UNIX, ILIAS\Repository\lng(), ilPropertyFormGUI\setValuesByPost(), and ILIAS\Repository\user().

Here is the call graph for this function:

◆ saveCourseDefinedFields()

static ilMemberAgreementGUI::saveCourseDefinedFields	(	ilPropertyFormGUI	$form,
		int	$a_obj_id,
		int	$a_usr_id = `0`
	)

static

Definition at line 339 of file class.ilMemberAgreementGUI.php.

                                                                                                             : void
    {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
        if (!$a_usr_id) {
            $a_usr_id = $ilUser->getId();
        }
        foreach (ilCourseDefinedFieldDefinition::_getFields($a_obj_id) as $field_obj) {
            $value = '';
            switch ($field_obj->getType()) {
                case ilCourseDefinedFieldDefinition::IL_CDF_TYPE_SELECT:
                    // Split value id from post
                    $exp = explode('_', $form->getInput('cdf_' . $field_obj->getId()));
                    $field_id = $exp[0];
                    $option_id = $exp[1] ?? null;
                    $open_answer_indexes = $field_obj->getValueOptions();
                    if (in_array($option_id, $open_answer_indexes)) {
                        $value = $form->getInput('cdf_oa_' . $field_obj->getId() . '_' . $option_id);
                    } else {
                        $value = $field_obj->getValueById((int) $option_id);
                    }
                    break;
 
                case ilCourseDefinedFieldDefinition::IL_CDF_TYPE_TEXT:
                    $value = $form->getInput('cdf_' . $field_obj->getId());
                    break;
            }
 
            $course_user_data = new ilCourseUserData($a_usr_id, $field_obj->getId());
            $course_user_data->setValue($value);
            $course_user_data->update();
        }
    }

References $DIC, ilCourseDefinedFieldDefinition\_getFields(), ilPropertyFormGUI\getInput(), ilCourseDefinedFieldDefinition\IL_CDF_TYPE_SELECT, and ilCourseDefinedFieldDefinition\IL_CDF_TYPE_TEXT.

Referenced by ilObjectCustomUserFieldsGUI\saveMember().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sendInfoMessage()

ilMemberAgreementGUI::sendInfoMessage ( )

private

Definition at line 398 of file class.ilMemberAgreementGUI.php.

                                      : void
    {
        $message = '';
        if ($this->agreement_required) {
            $message = $this->lng->txt($this->type . '_ps_agreement_req_info');
        }
        if (!$this->required_fullfilled) {
            if ($message !== '') {
                $message .= '<br />';
            }
            $message .= $this->lng->txt($this->type . '_ps_required_info');
        }
        if ($message !== '') {
            $this->tpl->setOnScreenMessage('failure', $message);
        }
    }

References $message, and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ setCourseDefinedFieldValues()

static ilMemberAgreementGUI::setCourseDefinedFieldValues	(	ilPropertyFormGUI	$form,
		int	$a_obj_id,
		int	$a_usr_id = `0`
	)

static

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

     : void {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
 
        if (!$a_usr_id) {
            $a_usr_id = $ilUser->getId();
        }
 
        $ud = ilCourseUserData::_getValuesByObjId($a_obj_id);
 
        foreach (ilCourseDefinedFieldDefinition::_getFields($a_obj_id) as $field_obj) {
            $current_value = (string) ($ud[$a_usr_id][$field_obj->getId()] ?? '');
            if (!$current_value) {
                continue;
            }
 
            switch ($field_obj->getType()) {
                case ilCourseDefinedFieldDefinition::IL_CDF_TYPE_SELECT:
 
                    $id = $field_obj->getIdByValue($current_value);
 
                    if ($id >= 0) {
                        $item = $form->getItemByPostVar('cdf_' . $field_obj->getId());
                        $item->setValue($field_obj->getId() . '_' . $id);
                    } else {
                        // open answer
                        $open_answer_indexes = $field_obj->getValueOptions();
                        $open_answer_index = end($open_answer_indexes);
                        $item = $form->getItemByPostVar('cdf_' . $field_obj->getId());
                        $item->setValue($field_obj->getId() . '_' . $open_answer_index);
                        $item_txt = $form->getItemByPostVar('cdf_oa_' . $field_obj->getId() . '_' . $open_answer_index);
                        if ($item_txt) {
                            $item_txt->setValue($current_value);
                        }
                    }
                    break;
 
                case ilCourseDefinedFieldDefinition::IL_CDF_TYPE_TEXT:
                    $item = $form->getItemByPostVar('cdf_' . $field_obj->getId());
                    $item->setValue($current_value);
                    break;
            }
        }
    }

Referenced by ilObjectCustomUserFieldsGUI\editMember(), and showAgreement().

Here is the caller graph for this function:

◆ showAgreement()

ilMemberAgreementGUI::showAgreement ( ?ilPropertyFormGUI $form = null )

protected

Show agreement form.

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

                                                                     : void
    {
        if ($form === null) {
            $form = $this->initFormAgreement();
            self::setCourseDefinedFieldValues($form, $this->obj_id, $this->user->getId());
        }
        $this->tpl->setContent($form->getHTML());
    }