Collaboration diagram for ilMemberAgreementGUI:

Public Member Functions
	__construct ($a_ref_id)
	Constructor. More...

	executeCommand ()
	Execute Command. More...

	getPrivacy ()
	Get privycy settings. More...

	getAgreement ()

Static Public Member Functions
static	addExportFieldInfo ($form, $a_obj_id, $a_type)
	Add export field info to form @global type $lng. More...

static	addAgreement ($form, $a_obj_id, $a_type)
	Add agreement to form. More...

static	addCustomFields ($form, $a_obj_id, $a_type, $a_mode='user')
	Add custom course fields. More...

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

static	saveCourseDefinedFields (ilPropertyFormGUI $form, $a_obj_id, $a_usr_id=0)
	Save course defined fields. More...

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

	initFormAgreement ()

Private Member Functions
	save ()
	Save. More...

	checkAgreement ()
	Check Agreement. More...

	init ()
	Read setting. More...

	sendInfoMessage ()
	Send info message. More...

Private Attributes
	$ref_id

	$obj_id

	$type

	$db

	$ctrl

	$lng

	$tpl

	$privacy

	$agreement

	$required_fullfilled = false

	$agrement_required = false

Detailed Description

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

Version: $Id$

@ilCtrl_Calls ilMemberAgreementGUI:

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

Constructor & Destructor Documentation

◆ __construct()

ilMemberAgreementGUI::__construct ( $a_ref_id )

Constructor.

@access public

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

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
        $tpl = $DIC['tpl'];
        $ilUser = $DIC['ilUser'];
        $ilObjDataCache = $DIC['ilObjDataCache'];
        
        $this->ref_id = $a_ref_id;
        $this->obj_id = $ilObjDataCache->lookupObjId($this->ref_id);
        $this->type = ilObject::_lookupType($this->obj_id);
        $this->ctrl = $ilCtrl;
        $this->tpl = $tpl;
        $this->lng = $lng;
        $this->lng->loadLanguageModule('ps');
        
        $this->privacy = ilPrivacySettings::_getInstance();
        $this->agreement = new ilMemberAgreement($ilUser->getId(), $this->obj_id);
        $this->init();
    }

References $DIC, $ilDB, $ilUser, $lng, $tpl, ilPrivacySettings\_getInstance(), ilObject\_lookupType(), and init().

Here is the call graph for this function:

Member Function Documentation

◆ addAgreement()

static ilMemberAgreementGUI::addAgreement	(	$form,
		$a_obj_id,
		$a_type
	)

static

Add agreement to form.

Parameters

type	$form
type	$a_obj_id
type	$a_type

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

    {
        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 $agreement, $DIC, and $lng.

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

Here is the caller graph for this function:

◆ addCustomFields()

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

static

Add custom course fields.

Parameters

type	$form
type	$a_obj_id
type	$a_type

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

    {
        global $DIC;
 
        $lng = $DIC['lng'];
        
        include_once('Modules/Course/classes/Export/class.ilCourseDefinedFieldDefinition.php');
        include_once('Modules/Course/classes/Export/class.ilCourseUserData.php');
 
        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 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 = (array) $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->setValue(ilUtil::stripSlashes($_POST['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 IL_CDF_TYPE_TEXT:
                    $text = new ilTextInputGUI($field_obj->getName(), 'cdf_' . $field_obj->getId());
                    #$text->setValue(ilUtil::stripSlashes($_POST['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;
    }

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addExportFieldInfo()

static ilMemberAgreementGUI::addExportFieldInfo	(	$form,
		$a_obj_id,
		$a_type
	)

static

Add export field info to form @global type $lng.

Parameters

type	$form
type	$a_obj_id
type	$a_type

Returns: type

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

    {
        global $DIC;
 
        $lng = $DIC['lng'];
        
        include_once('Services/PrivacySecurity/classes/class.ilExportFieldsInfo.php');
        $fields_info = ilExportFieldsInfo::_getInstanceByType(ilObject::_lookupType($a_obj_id));
 
        $fields = new ilCustomInputGUI($lng->txt($a_type . '_user_agreement'), '');
        $tpl = new ilTemplate('tpl.agreement_form.html', true, true, 'Services/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()
        include_once('Services/User/classes/class.ilUserDefinedFields.php');
        foreach (ilUserDefinedFields::_getInstance()->getExportableFields($a_obj_id) as $field) {
            $tpl->setCurrentBlock('field_item');
            $tpl->setVariable('FIELD_NAME', $field['field_name']);
            $tpl->parseCurrentBlock();
        }
        
        $fields->setHtml($tpl->get());
        $form->addItem($fields);
        
        return $form;
    }

References $DIC, $lng, $tpl, ilUserDefinedFields\_getInstance(), ilExportFieldsInfo\_getInstanceByType(), and ilObject\_lookupType().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkAgreement()

ilMemberAgreementGUI::checkAgreement ( )

private

Check Agreement.

@access private

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

    {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
        
        if ($_POST['agreement']) {
            return true;
        }
        if ($this->privacy->confirmationRequired($this->type)) {
            return false;
        }
        return true;
    }

References $_POST, $DIC, and $ilUser.

Referenced by save().

Here is the caller graph for this function:

◆ executeCommand()

ilMemberAgreementGUI::executeCommand ( )

Execute Command.

@access public

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

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

◆ getAgreement()

ilMemberAgreementGUI::getAgreement ( )

Returns: ilMemberAgreement

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

    {
        return $this->agreement;
    }

References $agreement.

Referenced by init(), and save().

Here is the caller graph for this function:

◆ getPrivacy()

ilMemberAgreementGUI::getPrivacy ( )

Get privycy settings.

Returns: ilPrivacySettings

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

    {
        return $this->privacy;
    }

References $privacy.

Referenced by initFormAgreement().

Here is the caller graph for this function:

◆ init()

ilMemberAgreementGUI::init ( )

private

Read setting.

@access private

Returns: void

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

    {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
        
        $this->required_fullfilled = ilCourseUserData::_checkRequired($ilUser->getId(), $this->obj_id);
        $this->agreement_required = $this->getAgreement()->agreementRequired();
    }

References $DIC, $ilUser, ilCourseUserData\_checkRequired(), and getAgreement().

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 125 of file class.ilMemberAgreementGUI.php.

    {
        include_once './Services/Form/classes/class.ilPropertyFormGUI.php';
        $form = new ilPropertyFormGUI();
        $form->setTitle($this->lng->txt($this->type . '_agreement_header'));
        $form->setFormAction($GLOBALS['DIC']['ilCtrl']->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 $GLOBALS, addAgreement(), addCustomFields(), addExportFieldInfo(), and getPrivacy().

Referenced by save(), and showAgreement().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilMemberAgreementGUI::save ( )

private

Save.

@access private

Parameters

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

    {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
        
        $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();
            
            include_once './Services/Membership/classes/class.ilObjectCustomUserFieldHistory.php';
            $history = new ilObjectCustomUserFieldHistory($this->obj_id, $ilUser->getId());
            $history->setUpdateUser($ilUser->getId());
            $history->setEditingTime(new ilDateTime(time(), IL_CAL_UNIX));
            $history->save();
            
            $this->ctrl->returnToParent($this);
        } elseif (!$this->checkAgreement()) {
            ilUtil::sendFailure($this->lng->txt($this->type . '_agreement_required'));
            $form->setValuesByPost();
            $this->showAgreement($form);
            return false;
        } else {
            ilUtil::sendFailure($this->lng->txt('fill_out_all_required_fields'));
            $form->setValuesByPost();
            $this->showAgreement($form);
            return false;
        }
    }

References $DIC, $ilUser, checkAgreement(), getAgreement(), IL_CAL_UNIX, initFormAgreement(), saveCourseDefinedFields(), ilUtil\sendFailure(), and showAgreement().

Here is the call graph for this function:

◆ saveCourseDefinedFields()

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

static

Save course defined fields.

Parameters

ilPropertyFormGUI $form

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

    {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
        
        if (!$a_usr_id) {
            $a_usr_id = $ilUser->getId();
        }
        
        foreach (ilCourseDefinedFieldDefinition::_getFields($a_obj_id) as $field_obj) {
            switch ($field_obj->getType()) {
                case IL_CDF_TYPE_SELECT:
                    
                    // Split value id from post
                    list($field_id, $option_id) = explode('_', $form->getInput('cdf_' . $field_obj->getId()));
                    $open_answer_indexes = (array) $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($option_id);
                    }
                    break;
                    
                case 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, $ilUser, ilCourseDefinedFieldDefinition\_getFields(), ilPropertyFormGUI\getInput(), IL_CDF_TYPE_SELECT, and IL_CDF_TYPE_TEXT.

Referenced by save(), and ilObjectCustomUserFieldsGUI\saveMember().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sendInfoMessage()

ilMemberAgreementGUI::sendInfoMessage ( )

private

Send info message.

@access private

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

    {
        $message = '';
        if ($this->agreement_required) {
            $message = $this->lng->txt($this->type . '_ps_agreement_req_info');
        }
        if (!$this->required_fullfilled) {
            if (strlen($message)) {
                $message .= '<br />';
            }
            $message .= $this->lng->txt($this->type . '_ps_required_info');
        }
        
        if (strlen($message)) {
            ilUtil::sendFailure($message);
        }
    }

References $message, and ilUtil\sendFailure().

Here is the call graph for this function:

◆ setCourseDefinedFieldValues()

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

static

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

    {
        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 = $ud[$a_usr_id][$field_obj->getId()];
            if (!$current_value) {
                continue;
            }
            
            switch ($field_obj->getType()) {
                case 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 IL_CDF_TYPE_TEXT:
                    $item = $form->getItemByPostVar('cdf_' . $field_obj->getId());
                    $item->setValue($current_value);
                    break;
            }
        }
    }

References $DIC, $ilUser, ilCourseDefinedFieldDefinition\_getFields(), ilCourseUserData\_getValuesByObjId(), ilPropertyFormGUI\getItemByPostVar(), IL_CDF_TYPE_SELECT, and IL_CDF_TYPE_TEXT.

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showAgreement()

ilMemberAgreementGUI::showAgreement ( ilPropertyFormGUI $form = null )

protected

Show agreement form.

Parameters

ilPropertyFormGUI $form

Returns: bool

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

    {
        global $DIC;
 
        $ilUser = $DIC['ilUser'];
        
        if (!$form instanceof ilPropertyFormGUI) {
            $form = $this->initFormAgreement($form);
            self::setCourseDefinedFieldValues($form, $this->obj_id, $ilUser->getId());
        }
        
        $this->tpl->setContent($form->getHTML());
        return true;
    }