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 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$

ilMemberAgreementGUI:

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

Constructor & Destructor Documentation

◆ __construct()

ilMemberAgreementGUI::__construct ( $a_ref_id )

Constructor.

public

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

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

         {
                 global $ilDB,$ilCtrl,$lng,$tpl,$ilUser,$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();
         }

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

References $a_type, $agreement, and $lng.

Referenced by ilRegistrationGUI\fillAgreement().

         {
                 global $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;
         }

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

References $a_type, $lng, $text, ilCourseDefinedFieldDefinition\_getFields(), array, IL_CDF_TYPE_SELECT, IL_CDF_TYPE_TEXT, ilSelectInputGUI\setOptions(), ilFormPropertyGUI\setRequired(), and ilNonEditableValueGUI\setValue().

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

         {
                 global $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;
                 
         }

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 type $lng.

Parameters

type	$form
type	$a_obj_id
type	$a_type

Returns: type

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

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

Referenced by ilRegistrationGUI\fillAgreement().

         {
                 global $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;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkAgreement()

ilMemberAgreementGUI::checkAgreement ( )

private

Check Agreement.

private

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

References $_POST, and $ilUser.

Referenced by save().

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

Here is the caller graph for this function:

◆ executeCommand()

ilMemberAgreementGUI::executeCommand ( )

Execute Command.

public

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

References $cmd.

         {
                 $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 93 of file class.ilMemberAgreementGUI.php.

References $agreement.

Referenced by init(), and save().

         {
                 return $this->agreement;
         }

Here is the caller graph for this function:

◆ getPrivacy()

ilMemberAgreementGUI::getPrivacy ( )

Get privycy settings.

Returns: ilPrivacySettings

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

References $privacy.

Referenced by initFormAgreement().

         {
                 return $this->privacy;
         }

Here is the caller graph for this function:

◆ init()

ilMemberAgreementGUI::init ( )

private

Read setting.

private

Returns: void

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

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

Referenced by __construct().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFormAgreement()

ilMemberAgreementGUI::initFormAgreement ( )

protected

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

References $GLOBALS, and getPrivacy().

Referenced by save(), and showAgreement().

         {
                 include_once './Services/Form/classes/class.ilPropertyFormGUI.php';
                 $form = new ilPropertyFormGUI();
                 $form->setTitle($this->lng->txt($this->type.'_agreement_header'));
                 $form->setFormAction($GLOBALS['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;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilMemberAgreementGUI::save ( )

private

Save.

private

Parameters

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

References $ilUser, checkAgreement(), getAgreement(), IL_CAL_UNIX, initFormAgreement(), ilUtil\sendFailure(), ilObjectCustomUserFieldHistory\setUpdateUser(), showAgreement(), and time.

         {
                 global $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;
                 }
         }

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

References $ilUser, ilCourseDefinedFieldDefinition\_getFields(), array, ilPropertyFormGUI\getInput(), IL_CDF_TYPE_SELECT, IL_CDF_TYPE_TEXT, and ilCourseUserData\setValue().

Referenced by ilObjectCustomUserFieldsGUI\saveMember().

         {
                 global $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();
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sendInfoMessage()

ilMemberAgreementGUI::sendInfoMessage ( )

private

Send info message.

private

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

References ilUtil\sendFailure().

         {
                 $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);
                 }
         }

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

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

Referenced by ilObjectCustomUserFieldsGUI\editMember().

         {
                 global $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;
                         }
                 }
         }

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

References $ilUser, and initFormAgreement().

Referenced by save().

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