This class represents a property in a property form. More...

Inheritance diagram for ilCheckboxGroupInputGUI:

Collaboration diagram for ilCheckboxGroupInputGUI:

Public Member Functions
	__construct ($a_title="", $a_postvar="")
	Constructor. More...

	setUseValuesAsKeys ($a_val)
	Set use values as keys. More...

	getUseValuesAsKeys ()
	Get use values as keys. More...

	addOption ($a_option)
	Add Option. More...

	setOptions ($a_options)
	Set Options. More...

	getOptions ()
	Get Options. More...

	setValue ($a_value)
	Set Value. More...

	getValue ()
	Get Value. More...

	setValueByArray ($a_values)
	Set value by array. More...

	checkInput ()
	Check input, strip slashes etc. More...

	insert ($a_tpl)
	Insert property html. More...

	getItemByPostVar ($a_post_var)
	Get item by post var. More...

	getTableFilterHTML ()
	Get input item HTML to be inserted into table filters. More...

	getToolbarHTML ()
	Get input item HTML to be inserted into ilToolbarGUI. More...

Public Member Functions inherited from ilSubEnabledFormPropertyGUI
	addSubItem ($a_item)
	Add Subitem. More...

	getSubItems ()
	Get Subitems. More...

	getSubInputItemsRecursive ()
	returns a flat array of possibly existing subitems recursively More...

	checkSubItemsInput ()
	Check SubItems. More...

	getSubForm ()
	Get sub form html. More...

	getItemByPostVar ($a_post_var)
	Get item by post var. More...

Public Member Functions inherited from ilFormPropertyGUI
	__construct ($a_title="", $a_postvar="")
	Constructor. More...

	executeCommand ()
	Execute command. More...

	getType ()
	Get Type. More...

	setTitle ($a_title)
	Set Title. More...

	getTitle ()
	Get Title. More...

	setPostVar ($a_postvar)
	Set Post Variable. More...

	getPostVar ()
	Get Post Variable. More...

	getFieldId ()
	Get Post Variable. More...

	setInfo ($a_info)
	Set Information Text. More...

	getInfo ()
	Get Information Text. More...

	setAlert ($a_alert)
	Set Alert Text. More...

	getAlert ()
	Get Alert Text. More...

	setRequired ($a_required)
	Set Required. More...

	getRequired ()
	Get Required. More...

	setDisabled ($a_disabled)
	Set Disabled. More...

	getDisabled ()
	Get Disabled. More...

	checkInput ()
	Check input, strip slashes etc. More...

	setParentForm ($a_parentform)
	Set Parent Form. More...

	getParentForm ()
	Get Parent Form. More...

	setParent ($a_val)
	Set Parent GUI object. More...

	getParent ()
	Get Parent GUI object. More...

	getSubForm ()
	Get sub form html. More...

	hideSubForm ()
	Sub form hidden on init? More...

	setHiddenTitle ($a_val)
	Set hidden title (for screenreaders) More...

	getHiddenTitle ()
	Get hidden title. More...

	getItemByPostVar ($a_post_var)
	Get item by post var. More...

	serializeData ()
	serialize data More...

	unserializeData ($a_data)
	unserialize data More...

	writeToSession ()
	Write to session. More...

	clearFromSession ()
	Clear session value. More...

	readFromSession ()
	Read from session. More...

	getHiddenTag ($a_post_var, $a_value)
	Get hidden tag (used for disabled properties) More...

	setMulti ($a_multi, $a_sortable=false, $a_addremove=true)
	Set Multi. More...

	getMulti ()
	Get Multi. More...

	setMultiValues (array $a_values)
	Set multi values. More...

	getMultiValues ()
	Get multi values. More...

	getContentOutsideFormTag ()
	Get content that has to reside outside of the parent form tag, e.g. More...

	stripSlashesAddSpaceFallback ($a_str)
	Strip slashes with add space fallback, see https://www.ilias.de/mantis/view.php?id=19727. More...

Protected Member Functions
	render ($a_mode='')

Protected Member Functions inherited from ilFormPropertyGUI
	setType ($a_type)
	Set Type. More...

	getMultiIconsHTML ()
	Get HTML for multiple value icons. More...

Protected Attributes
	$lng

	$options = array()

	$value

	$use_values_as_keys = false

Protected Attributes inherited from ilSubEnabledFormPropertyGUI
	$sub_items = array()

Protected Attributes inherited from ilFormPropertyGUI
	$ctrl

	$lng

	$type

	$title

	$postvar

	$info

	$alert

	$required = false

	$parentgui

	$parentform

	$hidden_title = ""

	$multi = false

	$multi_sortable = false

	$multi_addremove = true

	$multi_values

Additional Inherited Members
Static Public Member Functions inherited from ilFormPropertyGUI
static	removeProhibitedCharacters ($a_text)
	Remove prohibited characters see #19159. More...

Detailed Description

This class represents a property in a property form.

Author: Helmut Schottmüller ilias.nosp@m.@aur.nosp@m.ealis.nosp@m..de

Version: $Id$

Definition at line 33 of file class.ilCheckboxGroupInputGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilCheckboxGroupInputGUI::__construct	(	$a_title = `""`,
		$a_postvar = `""`
	)

Constructor.

Parameters

string	$a_title	Title
string	$a_postvar	Post Variable

Definition at line 51 of file class.ilCheckboxGroupInputGUI.php.

References $DIC, and ilFormPropertyGUI\setType().

     {
         global $DIC;
 
         $this->lng = $DIC->language();
         parent::__construct($a_title, $a_postvar);
         $this->setType("checkboxgroup");
     }

Here is the call graph for this function:

Member Function Documentation

◆ addOption()

ilCheckboxGroupInputGUI::addOption ( $a_option )

Add Option.

Parameters

object $a_option CheckboxOption object

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

Referenced by ilObjTestSettingsScoringResultsGUI\addMiscSettingsFormSection(), ilObjTestSettingsGeneralGUI\addQuestionBehaviourProperties(), ilObjTestSettingsGeneralGUI\addTestRunProperties(), ilMemberExportGUI\initSettingsForm(), ilObjUserTrackingGUI\initSettingsForm(), and ilSettingsTemplateGUI\initSettingsTemplateForm().

     {
         $this->options[] = $a_option;
     }

Here is the caller graph for this function:

◆ checkInput()

ilCheckboxGroupInputGUI::checkInput ( )

Check input, strip slashes etc.

set alert, if input is not ok.

Returns: boolean Input ok, true/false

Definition at line 157 of file class.ilCheckboxGroupInputGUI.php.

References $_POST, $lng, $ok, getOptions(), ilFormPropertyGUI\getPostVar(), ilFormPropertyGUI\getRequired(), and ilFormPropertyGUI\setAlert().

     {
         $lng = $this->lng;
 
         if ($this->getRequired() && (!is_array($_POST[$this->getPostVar()]) || count($_POST[$this->getPostVar()]) === 0)) {
             $this->setAlert($lng->txt('msg_input_is_required'));
             return false;
         }
 
         $ok = true;
         foreach ($this->getOptions() as $option) {
             foreach ($option->getSubItems() as $item) {
                 $item_ok = $item->checkInput();
                 if (!$item_ok && in_array($option->getValue(), $_POST[$this->getPostVar()])) {
                     $ok = false;
                 }
             }
         }
         return $ok;
     }

Here is the call graph for this function:

◆ getItemByPostVar()

ilCheckboxGroupInputGUI::getItemByPostVar ( $a_post_var )

Get item by post var.

Returns: mixed false or item object

Definition at line 195 of file class.ilCheckboxGroupInputGUI.php.

References $ret, getOptions(), and ilFormPropertyGUI\getPostVar().

     {
         if ($this->getPostVar() == $a_post_var) {
             return $this;
         }
 
         foreach ($this->getOptions() as $option) {
             foreach ($option->getSubItems() as $item) {
                 if ($item->getType() != "section_header") {
                     $ret = $item->getItemByPostVar($a_post_var);
                     if (is_object($ret)) {
                         return $ret;
                     }
                 }
             }
         }
 
         return false;
     }

Here is the call graph for this function:

◆ getOptions()

ilCheckboxGroupInputGUI::getOptions ( )

Get Options.

Returns: array Array of CheckboxOption objects

Definition at line 112 of file class.ilCheckboxGroupInputGUI.php.

References $options.

Referenced by checkInput(), getItemByPostVar(), render(), and setValueByArray().

     {
         return $this->options;
     }

Here is the caller graph for this function:

◆ getTableFilterHTML()

ilCheckboxGroupInputGUI::getTableFilterHTML ( )

Get input item HTML to be inserted into table filters.

Returns: string

Implements ilTableFilterItem.

Definition at line 215 of file class.ilCheckboxGroupInputGUI.php.

References render().

     {
         return $this->render();
     }

Here is the call graph for this function:

◆ getToolbarHTML()

ilCheckboxGroupInputGUI::getToolbarHTML ( )

Get input item HTML to be inserted into ilToolbarGUI.

public

Returns: string

Implements ilToolbarItem.

Definition at line 220 of file class.ilCheckboxGroupInputGUI.php.

References render().

     {
         return $this->render('toolbar');
     }

Here is the call graph for this function:

◆ getUseValuesAsKeys()

ilCheckboxGroupInputGUI::getUseValuesAsKeys ( )

Get use values as keys.

Returns: bool use values as keys

Definition at line 75 of file class.ilCheckboxGroupInputGUI.php.

References $use_values_as_keys.

Referenced by render().

     {
         return $this->use_values_as_keys;
     }

Here is the caller graph for this function:

◆ getValue()

ilCheckboxGroupInputGUI::getValue ( )

Get Value.

Returns: array Value

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

References $value.

Referenced by render().

     {
         return $this->value;
     }

Here is the caller graph for this function:

◆ insert()

ilCheckboxGroupInputGUI::insert ( $a_tpl )

Insert property html.

Returns: int Size

Definition at line 183 of file class.ilCheckboxGroupInputGUI.php.

References render().

     {
         $a_tpl->setCurrentBlock("prop_generic");
         $a_tpl->setVariable("PROP_GENERIC", $this->render());
         $a_tpl->parseCurrentBlock();
     }

Here is the call graph for this function:

◆ render()

ilCheckboxGroupInputGUI::render ( $a_mode = '' )

protected

Definition at line 225 of file class.ilCheckboxGroupInputGUI.php.

References $tpl, ilFormPropertyGUI\getDisabled(), ilFormPropertyGUI\getFieldId(), getOptions(), ilFormPropertyGUI\getParentForm(), ilFormPropertyGUI\getPostVar(), ilSubEnabledFormPropertyGUI\getSubInputItemsRecursive(), getUseValuesAsKeys(), and getValue().

Referenced by getTableFilterHTML(), getToolbarHTML(), and insert().

     {
         $tpl = new ilTemplate("tpl.prop_checkbox_group.html", true, true, "Services/Form");
 
         foreach ($this->getOptions() as $option) {
             // information text for option
             if ($option->getInfo() != "") {
                 $tpl->setCurrentBlock("checkbox_option_desc");
                 $tpl->setVariable("CHECKBOX_OPTION_DESC", $option->getInfo());
                 $tpl->parseCurrentBlock();
             }
 
 
             if (count($option->getSubItems()) > 0) {
                 $tpl->setCurrentBlock("checkbox_option_subform");
                 $pf = new ilPropertyFormGUI();
                 $pf->setMode("subform");
                 $pf->setItems($option->getSubItems());
                 $tpl->setVariable("SUB_FORM", $pf->getContent());
                 $tpl->setVariable("SOP_ID", $this->getFieldId() . "_" . $option->getValue());
                 if ($pf->getMultipart()) {
                     $this->getParentForm()->setMultipart(true);
                 }
                 $tpl->parseCurrentBlock();
                 if ($pf->getMultipart()) {
                     $this->getParentForm()->setMultipart(true);
                 }
             }
 
             $tpl->setCurrentBlock("prop_checkbox_option");
             
             if (!$this->getUseValuesAsKeys()) {
                 $tpl->setVariable("POST_VAR", $this->getPostVar() . '[]');
                 $tpl->setVariable("VAL_CHECKBOX_OPTION", $option->getValue());
             } else {
                 $tpl->setVariable("POST_VAR", $this->getPostVar() . '[' . $option->getValue() . ']');
                 $tpl->setVariable("VAL_CHECKBOX_OPTION", "1");
             }
             
             $tpl->setVariable("OP_ID", $this->getFieldId() . "_" . $option->getValue());
             $tpl->setVariable("FID", $this->getFieldId());
             
             if ($this->getDisabled() or $option->getDisabled()) {
                 $tpl->setVariable('DISABLED', 'disabled="disabled" ');
             }
 
             if (is_array($this->getValue())) {
                 if (!$this->getUseValuesAsKeys()) {
                     if (in_array($option->getValue(), $this->getValue())) {
                         $tpl->setVariable(
                             "CHK_CHECKBOX_OPTION",
                             'checked="checked"'
                         );
                     }
                 } else {
                     $cval = $this->getValue();
                     if ($cval[$option->getValue()] == 1) {
                         $tpl->setVariable(
                             "CHK_CHECKBOX_OPTION",
                             'checked="checked"'
                         );
                     }
                 }
             }
             $tpl->setVariable("TXT_CHECKBOX_OPTION", $option->getTitle());
 
 
             $tpl->parseCurrentBlock();
         }
         $tpl->setVariable("ID", $this->getFieldId());
 
         return $tpl->get();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setOptions()

ilCheckboxGroupInputGUI::setOptions ( $a_options )

Set Options.

Parameters

array $a_options Options. Array ("value" => "option_text")

Definition at line 95 of file class.ilCheckboxGroupInputGUI.php.

References $key.

     {
         foreach ($a_options as $key => $label) {
             if (is_string($label)) {
                 $chb = new ilCheckboxInputGUI($label, $key);
                 $this->options[] = $chb;
             } elseif ($label instanceof ilCheckboxInputGUI) {
                 $this->options[] = $label;
             }
         }
     }

◆ setUseValuesAsKeys()

ilCheckboxGroupInputGUI::setUseValuesAsKeys ( $a_val )

Set use values as keys.

Parameters

bool $a_val use values as keys

Definition at line 65 of file class.ilCheckboxGroupInputGUI.php.

     {
         $this->use_values_as_keys = $a_val;
     }

◆ setValue()

ilCheckboxGroupInputGUI::setValue ( $a_value )

Set Value.

Parameters

array $a_value Value

Definition at line 122 of file class.ilCheckboxGroupInputGUI.php.

Referenced by ilECSObjectSettings\addSettingsToForm(), ilPageLayoutGUI\initForm(), ilObjAssessmentFolderGUI\settingsObject(), setValueByArray(), and ilObjPrivacySecurityGUI\showPrivacy().

     {
         $this->value = $a_value;
     }

Here is the caller graph for this function:

◆ setValueByArray()

ilCheckboxGroupInputGUI::setValueByArray ( $a_values )

Set value by array.

Parameters

array $a_values value array

Definition at line 142 of file class.ilCheckboxGroupInputGUI.php.

References getOptions(), ilFormPropertyGUI\getPostVar(), and setValue().

     {
         $this->setValue($a_values[$this->getPostVar()]);
         foreach ($this->getOptions() as $option) {
             foreach ($option->getSubItems() as $item) {
                 $item->setValueByArray($a_values);
             }
         }
     }

Here is the call graph for this function:

Field Documentation

◆ $lng

ilCheckboxGroupInputGUI::$lng

protected

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

Referenced by checkInput().

◆ $options

ilCheckboxGroupInputGUI::$options = array()

protected

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

Referenced by getOptions().

◆ $use_values_as_keys

ilCheckboxGroupInputGUI::$use_values_as_keys = false

protected

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

Referenced by getUseValuesAsKeys().

◆ $value

ilCheckboxGroupInputGUI::$value

protected

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

Referenced by getValue().

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

Services/Form/classes/class.ilCheckboxGroupInputGUI.php

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addOption()

◆ checkInput()

◆ getItemByPostVar()

◆ getOptions()

◆ getTableFilterHTML()

◆ getToolbarHTML()

◆ getUseValuesAsKeys()

◆ getValue()

◆ insert()

◆ render()

◆ setOptions()

◆ setUseValuesAsKeys()

◆ setValue()

◆ setValueByArray()

Field Documentation

◆ $lng

◆ $options

◆ $use_values_as_keys

◆ $value