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

Inheritance diagram for ilFormPropertyGUI:

Collaboration diagram for ilFormPropertyGUI:

Public Member Functions
	__construct (string $a_title="", string $a_postvar="")

	executeCommand ()

	getType ()

	setTitle (string $a_title)

	getTitle ()

	setPostVar (string $a_postvar)

	getPostVar ()

	getFieldId ()

	setInfo (string $a_info)

	getInfo ()

	setAlert (string $a_alert)

	getAlert ()

	setRequired (bool $a_required)

	getRequired ()

	setDisabled (bool $a_disabled)

	getDisabled ()

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

	setParentForm (ilPropertyFormGUI $a_parentform)

	getParentForm ()

	setParent (ilFormPropertyGUI $a_val)

	getParent ()

	getSubForm ()

	hideSubForm ()

	setHiddenTitle (string $a_val)

	getHiddenTitle ()

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

	serializeData ()

	unserializeData (string $a_data)

	setParentTable ($a_val)
	Set parent table. More...

	getParentTable ()
	Get parent table. More...

	writeToSession ()

	clearFromSession ()

	readFromSession ()

	getHiddenTag (string $a_post_var, string $a_value)

	setMulti (bool $a_multi, bool $a_sortable=false, bool $a_addremove=true)

	getMulti ()

	setMultiValues (array $a_values)

	getMultiValues ()

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

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

	getTableFilterLabelFor ()
	Get label "for" attribute value for filter. More...

	getFormLabelFor ()
	Get label "for" attribute value for form. More...

	setRequestParam (string $key, $val)
	This writes the request (aka post) values. More...

Static Public Member Functions
static	removeProhibitedCharacters (string $a_text)
	Remove prohibited characters see #19159. More...

Protected Member Functions
	symbol ()

	setType (string $a_type)

	checkParentFormTable ()

	getSessionKey ()

	getMultiIconsHTML ()

	int ($key)

	intArray ($key)

	str ($key)

	raw ($key)

	strArray ($key)

	arrayArray ($key)

	isRequestParamArray (string $key)

	getRequestParam (string $key, Refinery\Transformation $t)

Protected Attributes
array	$set_params = []

ilTable2GUI	$parent_table = null

ilFormPropertyGUI	$parent_gui = null

ilCtrl	$ctrl

ilLanguage	$lng

string	$type = ""

string	$title = ""

string	$postvar = ""

string	$info = ""

string	$alert = ""

bool	$required = false

ilPropertyFormGUI	$parentform = null

string	$hidden_title = ""

bool	$multi = false

bool	$multi_sortable = false

bool	$multi_addremove = true

array	$multi_values = []

RequestInterface	$request

HTTP Services	$http

Refinery Factory	$refinery = null

bool	$disabled = false

ilGlobalTemplateInterface	$global_tpl = null

Detailed Description

This class represents a property in a property form.

Author: Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 30 of file class.ilFormPropertyGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilFormPropertyGUI::__construct	(	string	$a_title = `""`,
		string	$a_postvar = `""`
	)

Definition at line 56 of file class.ilFormPropertyGUI.php.

References $DIC, ILIAS\Repository\ctrl(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), setDisabled(), setPostVar(), and setTitle().

       {
         global $DIC;
 
         if (isset($DIC["http"])) {
             $this->http = $DIC->http();
         }
 
         if (isset($DIC["refinery"])) {
             $this->refinery = $DIC->refinery();
         }
 
         $this->ctrl = $DIC->ctrl();
         $this->lng = $DIC->language();
         $this->setTitle($a_title);
         $this->setPostVar($a_postvar);
         $this->setDisabled(false);
         if (isset($DIC["http"])) {      // some unit tests will fail otherwise
             $this->request = $DIC->http()->request();
         }
         if (isset($DIC["tpl"])) {      // some unit tests will fail otherwise
             $this->global_tpl = $DIC['tpl'];
         }
     }

Here is the call graph for this function:

Member Function Documentation

◆ arrayArray()

ilFormPropertyGUI::arrayArray ( $key )

protected

Definition at line 524 of file class.ilFormPropertyGUI.php.

References getRequestParam(), isRequestParamArray(), and ILIAS\Repository\refinery().

Referenced by ilBackgroundPositionInputGUI\getInput(), ilTRBLBorderStyleInputGUI\getInput(), ilMatrixRowWizardInputGUI\getInput(), ilTRBLBorderWidthInputGUI\getInput(), ilTRBLNumericStyleValueInputGUI\getInput(), ilTRBLColorPickerInputGUI\getInput(), ilIdentifiedMultiValuesInputGUI\getInput(), ilCategoryWizardInputGUI\getInput(), and ilImagemapFileInputGUI\getPostBody().

                                        : array
     {
         if (!$this->isRequestParamArray($key)) {
             return [];
         }
         $t = $this->refinery->custom()->transformation(
             function ($arr) {
                 // keep keys(!), transform all values to string
                 return array_column(
                     array_map(
                         function ($k, $v) {
                             return [$k, (array) $v];
                         },
                         array_keys($arr),
                         $arr
                     ),
                     1,
                     0
                 );
             }
         );
         return (array) ($this->getRequestParam($key, $t) ?? []);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkInput()

ilFormPropertyGUI::checkInput ( )

Check input, strip slashes etc.

set alert, if input is not ok.

Definition at line 178 of file class.ilFormPropertyGUI.php.

                                 : bool
     {
         return false;           // please overwrite
     }

◆ checkParentFormTable()

ilFormPropertyGUI::checkParentFormTable ( )

protected

Definition at line 270 of file class.ilFormPropertyGUI.php.

References getParentForm(), and getParentTable().

Referenced by clearFromSession(), readFromSession(), and writeToSession().

                                              : void
     {
         $parent = $this->getParentForm();
         $parent_table = $this->getParentTable();
         if (!is_object($parent) && !isset($parent_table)) {
             throw new Exception("Parent form/table not set for " . get_class($this) . " to use serialize feature.");
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clearFromSession()

ilFormPropertyGUI::clearFromSession ( )

Exceptions

Exception

Definition at line 300 of file class.ilFormPropertyGUI.php.

References checkParentFormTable(), ilSession\clear(), and getSessionKey().

                                       : void
     {
         $this->checkParentFormTable();
         ilSession::clear($this->getSessionKey());
     }

Here is the call graph for this function:

◆ executeCommand()

ilFormPropertyGUI::executeCommand ( )

Returns: mixed

Definition at line 86 of file class.ilFormPropertyGUI.php.

References ILIAS\Repository\ctrl().

     {
         $cmd = $this->ctrl->getCmd();
         return $this->$cmd();
     }

Here is the call graph for this function:

◆ getAlert()

ilFormPropertyGUI::getAlert ( )

Definition at line 150 of file class.ilFormPropertyGUI.php.

References $alert.

                               : string
     {
         return $this->alert;
     }

◆ getContentOutsideFormTag()

ilFormPropertyGUI::getContentOutsideFormTag ( )

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

panels/layers

Definition at line 397 of file class.ilFormPropertyGUI.php.

                                               : string
     {
         return "";
     }

◆ getDisabled()

ilFormPropertyGUI::getDisabled ( )

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

References $disabled.

                                  : bool
     {
         return $this->disabled;
     }

Here is the caller graph for this function:

◆ getFieldId()

ilFormPropertyGUI::getFieldId ( )

Definition at line 128 of file class.ilFormPropertyGUI.php.

References $id, and getPostVar().

                                 : string
     {
         $id = str_replace("[", "__", $this->getPostVar());
         $id = str_replace("]", "__", $id);
         return $id;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFormLabelFor()

ilFormPropertyGUI::getFormLabelFor ( )

Get label "for" attribute value for form.

Definition at line 434 of file class.ilFormPropertyGUI.php.

References getFieldId().

                                      : string
     {
         return $this->getFieldId();
     }

Here is the call graph for this function:

◆ getHiddenTag()

ilFormPropertyGUI::getHiddenTag	(	string	$a_post_var,
		string	$a_value
	)

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

References ilLegacyFormElementsUtil\prepareFormOutput().

Referenced by ilEMailInputGUI\insert(), ilTextAreaInputGUI\insert(), ilRadioGroupInputGUI\render(), ilSelectInputGUI\render(), and ilTextInputGUI\render().

      : string {
         return '<input type="hidden" name="' . $a_post_var . '" value="' . ilLegacyFormElementsUtil::prepareFormOutput(
             $a_value
         ) . '" />';
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHiddenTitle()

ilFormPropertyGUI::getHiddenTitle ( )

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

References $hidden_title.

                                     : string
     {
         return $this->hidden_title;
     }

◆ getInfo()

ilFormPropertyGUI::getInfo ( )

Definition at line 140 of file class.ilFormPropertyGUI.php.

References $info.

Referenced by ilTextAreaInputGUI\insert(), ilCheckboxInputGUI\render(), ilNumberInputGUI\render(), ilTextInputGUI\render(), and ilDclBaseFieldRepresentation\setupInputField().

                              : string
     {
         return $this->info;
     }

Here is the caller graph for this function:

◆ getItemByPostVar()

ilFormPropertyGUI::getItemByPostVar ( string $a_post_var )

Get item by post var.

Definition at line 228 of file class.ilFormPropertyGUI.php.

References getPostVar().

                                                         : ?ilFormPropertyGUI
     {
         if ($this->getPostVar() == $a_post_var) {
             return $this;
         }
         return null;
     }

Here is the call graph for this function:

◆ getMulti()

ilFormPropertyGUI::getMulti ( )

Definition at line 346 of file class.ilFormPropertyGUI.php.

References $multi.

Referenced by ilSelectInputGUI\checkInput(), ilTextInputGUI\checkInput(), ilOrgUnitGenericMultiInputGUI\createInputPostVar(), ilSelectInputGUI\getInput(), ilTextInputGUI\getInput(), ilOrgUnitGenericMultiInputGUI\insert(), ilNonEditableValueGUI\render(), ilSelectInputGUI\render(), ilOrgUnitGenericMultiInputGUI\render(), ilTextInputGUI\render(), ilTaxAssignInputGUI\saveInput(), ilTaxAssignInputGUI\setCurrentValues(), ilTextInputGUI\setValue(), ilSelectInputGUI\setValue(), ilNonEditableValueGUI\setValue(), ilManualPlaceholderInputGUI\setValue(), and ilOrgUnitGenericMultiInputGUI\setValueByArray().

                               : bool
     {
         return $this->multi;
     }

Here is the caller graph for this function:

◆ getMultiIconsHTML()

ilFormPropertyGUI::getMultiIconsHTML ( )

protected

Definition at line 362 of file class.ilFormPropertyGUI.php.

References $id, $lng, getFieldId(), symbol(), and ilLanguage\txt().

Referenced by ilOrgUnitAuthorityInputGUI\getValue(), ilNonEditableValueGUI\render(), ilSelectInputGUI\render(), and ilTextInputGUI\render().

                                           : string
     {
         $lng = $this->lng;
 
         $id = $this->getFieldId();
 
         $tpl = new ilTemplate("tpl.multi_icons.html", true, true, "components/ILIAS/Form");
 
         $html = "";
         if ($this->multi_addremove) {
             $tpl->setCurrentBlock("addremove");
             $tpl->setVariable("ID", $id);
             $tpl->setVariable("TXT_ADD", $lng->txt("add"));
             $tpl->setVariable("TXT_REMOVE", $lng->txt("remove"));
             $tpl->setVariable("SRC_ADD", $this->symbol()->glyph("add")->render());
             $tpl->setVariable("SRC_REMOVE", $this->symbol()->glyph("remove")->render());
             $tpl->parseCurrentBlock();
         }
 
         if ($this->multi_sortable) {
             $tpl->setCurrentBlock("sortable");
             $tpl->setVariable("ID", $id);
             $tpl->setVariable("TXT_DOWN", $lng->txt("down"));
             $tpl->setVariable("TXT_UP", $lng->txt("up"));
             $tpl->setVariable("SRC_UP", $this->symbol()->glyph("up")->render());
             $tpl->setVariable("SRC_DOWN", $this->symbol()->glyph("down")->render());
             $tpl->parseCurrentBlock();
         }
 
         return $tpl->get();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMultiValues()

ilFormPropertyGUI::getMultiValues ( )

Definition at line 356 of file class.ilFormPropertyGUI.php.

References $multi_values.

Referenced by ilOrgUnitAuthorityInputGUI\getValue(), ilSelectInputGUI\render(), and ilTextInputGUI\render().

                                     : array
     {
         return $this->multi_values;
     }

Here is the caller graph for this function:

◆ getParent()

ilFormPropertyGUI::getParent ( )

Definition at line 199 of file class.ilFormPropertyGUI.php.

References $parent_gui.

                                : ?ilFormPropertyGUI
     {
         return $this->parent_gui;
     }

◆ getParentForm()

ilFormPropertyGUI::getParentForm ( )

Definition at line 188 of file class.ilFormPropertyGUI.php.

References $parentform.

Referenced by checkParentFormTable(), getSessionKey(), ilRadioGroupInputGUI\render(), ilCheckboxGroupInputGUI\render(), and ilLinkInputGUI\render().

                                    : ?ilPropertyFormGUI
     {
         return $this->parentform;
     }

Here is the caller graph for this function:

◆ getParentTable()

ilFormPropertyGUI::getParentTable ( )

Get parent table.

Returns: ilTable2GUI table object

Definition at line 265 of file class.ilFormPropertyGUI.php.

References $parent_table.

Referenced by checkParentFormTable(), getSessionKey(), and ilRepositorySelectorInputGUI\render().

                                     : ?ilTable2GUI
     {
         return $this->parent_table;
     }

Here is the caller graph for this function:

◆ getPostVar()

ilFormPropertyGUI::getPostVar ( )

Definition at line 123 of file class.ilFormPropertyGUI.php.

References $postvar.

                                 : string
     {
         return $this->postvar;
     }

Here is the caller graph for this function:

◆ getRequestParam()

ilFormPropertyGUI::getRequestParam	(	string	$key,
		Refinery\Transformation	$t
	)

protected

Returns: mixed|null

Definition at line 574 of file class.ilFormPropertyGUI.php.

References ILIAS\FileDelivery\http().

Referenced by arrayArray(), ilFormulaInputGUI\getInput(), ilLogicalAnswerComparisonExpressionInputGUI\getInput(), int(), intArray(), raw(), ilEMailInputGUI\sanitize(), str(), and strArray().

     {
         if (isset($this->set_params[$key])) {
             return $this->set_params[$key];
         }
         $w = $this->http->wrapper();
         if ($w->post()->has($key)) {
             return $w->post()->retrieve($key, $t);
         }
         if ($w->query()->has($key)) {
             return $w->query()->retrieve($key, $t);
         }
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRequired()

ilFormPropertyGUI::getRequired ( )

Definition at line 160 of file class.ilFormPropertyGUI.php.

References $required.

                                  : bool
     {
         return $this->required;
     }

Here is the caller graph for this function:

◆ getSessionKey()

ilFormPropertyGUI::getSessionKey ( )

protected

Definition at line 288 of file class.ilFormPropertyGUI.php.

References getFieldId(), getParentForm(), and getParentTable().

Referenced by clearFromSession(), readFromSession(), and writeToSession().

                                       : string
     {
         $parent = $this->getParentForm();
         if (!is_object($parent)) {
             $parent = $this->getParentTable();
         }
         return "form_" . $parent->getId() . "_" . $this->getFieldId();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSubForm()

ilFormPropertyGUI::getSubForm ( )

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

                                 : ?ilPropertyFormGUI
     {
         return null;
     }

◆ getTableFilterLabelFor()

ilFormPropertyGUI::getTableFilterLabelFor ( )

Get label "for" attribute value for filter.

Definition at line 426 of file class.ilFormPropertyGUI.php.

References getFieldId().

                                             : string
     {
         return $this->getFieldId();
     }

Here is the call graph for this function:

◆ getTitle()

ilFormPropertyGUI::getTitle ( )

Definition at line 113 of file class.ilFormPropertyGUI.php.

References $title.

Referenced by ilCheckboxInputGUI\render(), ilSelectInputGUI\render(), ilTextInputGUI\render(), and ilMailFormGUI\showForm().

                               : string
     {
         return $this->title;
     }

Here is the caller graph for this function:

◆ getType()

ilFormPropertyGUI::getType ( )

Definition at line 103 of file class.ilFormPropertyGUI.php.

References $type.

                              : string
     {
         return $this->type;
     }

◆ hideSubForm()

ilFormPropertyGUI::hideSubForm ( )

Definition at line 209 of file class.ilFormPropertyGUI.php.

                                  : bool
     {
         return false;
     }

◆ int()

ilFormPropertyGUI::int ( $key )

protected

Definition at line 440 of file class.ilFormPropertyGUI.php.

References getRequestParam(), and ILIAS\Repository\refinery().

Referenced by ilLocationInputGUI\getInput(), ilDurationInputGUI\getPostValueForComparison(), ilWidthHeightInputGUI\insert(), intArray(), ilScheduleInputGUI\parseTime(), ilTaxAssignInputGUI\saveInput(), ilRepositorySelectorInputGUI\setValue(), and ilDurationInputGUI\setValueByArray().

                                 : int
     {
         if (is_null($this->refinery)) {
             return 0;
         }
         $t = $this->refinery->kindlyTo()->int();
         return (int) ($this->getRequestParam($key, $t) ?? 0);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ intArray()

ilFormPropertyGUI::intArray ( $key )

protected

Definition at line 450 of file class.ilFormPropertyGUI.php.

References getRequestParam(), int(), isRequestParamArray(), and ILIAS\Repository\refinery().

                                      : array
     {
         if (!$this->isRequestParamArray($key)) {
             return [];
         }
         $t = $this->refinery->custom()->transformation(
             function ($arr) {
                 // keep keys(!), transform all values to int
                 return array_column(
                     array_map(
                         function ($k, $v) {
                             return [$k, (int) $v];
                         },
                         array_keys($arr),
                         $arr
                     ),
                     1,
                     0
                 );
             }
         );
         return (array) ($this->getRequestParam($key, $t) ?? []);
     }

Here is the call graph for this function:

◆ isRequestParamArray()

ilFormPropertyGUI::isRequestParamArray ( string $key )

protected

Definition at line 548 of file class.ilFormPropertyGUI.php.

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

Referenced by arrayArray(), ilNonEditableValueGUI\getInput(), ilLogicalAnswerComparisonExpressionInputGUI\getInput(), intArray(), and strArray().

                                                        : bool
     {
         $no_transform = $this->refinery->identity();
         $w = $this->http->wrapper();
         if ($w->post()->has($key)) {
             return is_array($w->post()->retrieve($key, $no_transform));
         }
         if ($w->query()->has($key)) {
             return is_array($w->query()->retrieve($key, $no_transform));
         }
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ raw()

ilFormPropertyGUI::raw ( $key )

protected

Definition at line 487 of file class.ilFormPropertyGUI.php.

References getRequestParam(), and ILIAS\Repository\refinery().

     {
         $t = $this->refinery->custom()->transformation(function ($v) {
             return $v;
         });
         return $this->getRequestParam($key, $t);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ readFromSession()

ilFormPropertyGUI::readFromSession ( )

Exceptions

Exception

Definition at line 309 of file class.ilFormPropertyGUI.php.

References checkParentFormTable(), ilSession\get(), getSessionKey(), ilSession\has(), and unserializeData().

Referenced by ilMMSubItemTableGUI\addAndReadFilterItem(), and ILIAS\LegalDocuments\Legacy\Table\setupFilter().

                                      : void
     {
         $this->checkParentFormTable();
         if (ilSession::has($this->getSessionKey())) {
             $this->unserializeData(ilSession::get($this->getSessionKey()));
         } else {
             $this->unserializeData("");
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeProhibitedCharacters()

static ilFormPropertyGUI::removeProhibitedCharacters ( string $a_text )

static

Remove prohibited characters see #19159.

Definition at line 406 of file class.ilFormPropertyGUI.php.

Referenced by ilLMObject\saveTitle().

                                                                      : string
     {
         return str_replace("\x0B", "", $a_text);
     }

Here is the caller graph for this function:

◆ serializeData()

ilFormPropertyGUI::serializeData ( )

Definition at line 236 of file class.ilFormPropertyGUI.php.

References ILIAS\UI\Implementation\Component\Input\getValue().

Referenced by writeToSession().

                                    : string
     {
         return serialize($this->getValue());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAlert()

ilFormPropertyGUI::setAlert ( string $a_alert )

Definition at line 145 of file class.ilFormPropertyGUI.php.

                                              : void
     {
         $this->alert = $a_alert;
     }

Here is the caller graph for this function:

◆ setDisabled()

ilFormPropertyGUI::setDisabled ( bool $a_disabled )

Definition at line 165 of file class.ilFormPropertyGUI.php.

References ILIAS\UI\examples\Input\Field\Checkbox\disabled().

Referenced by __construct(), ilADTFormBridge\addBasicFieldProperties(), ilIncomingMailInputGUI\addSubOptions(), ilObjMailGUI\buildSignaturePlaceholderInputs(), ilObjMailGUI\getGeneralSettingsForm(), ilMailTemplateGUI\getTemplateForm(), ilCalendarCategoryGUI\initFormCategory(), ilCASSettingsGUI\initFormSettings(), ilObjPollGUI\initQuestionForm(), ilLTIConsumeProviderFormGUI\initToolConfigForm(), and ilDclFileFieldRepresentation\requiredWorkaroundForInputField().

                                                  : void
     {
         $this->disabled = $a_disabled;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setHiddenTitle()

ilFormPropertyGUI::setHiddenTitle ( string $a_val )

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

Referenced by ilImageFileInputGUI\__construct(), and ilFileInputGUI\__construct().

                                                  : void
     {
         $this->hidden_title = $a_val;
     }

Here is the caller graph for this function:

◆ setInfo()

ilFormPropertyGUI::setInfo ( string $a_info )

Definition at line 135 of file class.ilFormPropertyGUI.php.

References ILIAS\UI\examples\MessageBox\Info\info().

Referenced by ilADTFormBridge\addBasicFieldProperties(), ilCronDeleteInactivatedUserAccounts\addCustomSettingsToForm(), ilCronDeleteNeverLoggedInUserAccounts\addCustomSettingsToForm(), ilCronDeleteInactiveUserAccounts\addCustomSettingsToForm(), ilSamlSettingsGUI\addMetadataElement(), ilDclMobFieldRepresentation\buildFieldCreationInput(), ilDclIliasReferenceFieldRepresentation\buildFieldCreationInput(), ilDclTextFieldRepresentation\buildFieldCreationInput(), ilDclReferenceFieldRepresentation\buildFieldCreationInput(), ilCmiXapiRegistrationGUI\buildForm(), ilCmiXapiSettingsGUI\buildForm(), ilObjCmiXapiAdministrationGUI\buildLrsTypeForm(), ilLTIConsumerAdministrationGUI\buildProviderImportForm(), ilObjLanguageExtGUI\exportObject(), ilCourseRegistrationGUI\fillRegistrationType(), ilSurveyParticipantsGUI\getAccessCodeImportForm(), ilChatroomFormFactory\getClientSettingsForm(), ilForumSettingsGUI\getCustomForm(), ilNewsItemGUI\getEditForm(), ilExerciseManagementGUI\getEvaluationModalForm(), ilObjMailGUI\getExternalSettingsForm(), ilSurveyParticipantsGUI\getImportExternalMailRecipientsFromFileForm(), ilDclTextFieldRepresentation\getInputField(), ilObjNewsSettingsGUI\getSettingsForm(), ilObjMediaCastGUI\initAddCastItemForm(), ilRegistrationSettingsGUI\initAddCodesForm(), ilExAssignmentEditorGUI\initAssignmentForm(), ilObjAuthSettingsGUI\initAuthModeDetermination(), ilObjSAHSLearningModuleGUI\initCreateForm(), ilObjPortfolioGUI\initCreatePortfolioFromTemplateForm(), ilPCGridGUI\initCreationForm(), ilObjPortfolioTemplateGUI\initDidacticTemplate(), ilObjItemGroupGUI\initEditCustomForm(), ilObjBookingPoolGUI\initEditCustomForm(), ilObjCourseGUI\initEditForm(), ilLTIConsumerSettingsFormGUI\initForm(), ilLTIConsumeProviderFormGUI\initForm(), ilPCMyCoursesGUI\initForm(), ilBookingScheduleGUI\initForm(), ilDclFieldEditGUI\initForm(), ilPCSectionGUI\initForm(), ilObjMediaObjectGUI\initForm(), ilObjGroupGUI\initForm(), ilConditionHandlerGUI\initFormCondition(), ilConsultationHoursGUI\initFormSequence(), ilECSParticipantSettingsGUI\initFormSettings(), ilObjSystemCheckGUI\initFormTrash(), ilObjGroupGUI\initInfoEditor(), ilContainerGUI\initListPresentationForm(), ilObjMediaObjectsSettingsGUI\initMediaObjectsSettingsForm(), ilObjLanguageExtGUI\initNewImportForm(), assOrderingQuestion\initOrderingElementFormFieldLabels(), ilExAssignmentEditorGUI\initPeerReviewForm(), ilObjSCORMLearningModuleGUI\initPropertiesForm(), ilObjSCORM2004LearningModuleGUI\initPropertiesForm(), ilPersonalProfileGUI\initPublicProfileForm(), ilObjPollGUI\initQuestionForm(), ilPermissionGUI\initRoleForm(), ilObjFileServicesGUI\initSettingsForm(), ilBadgeProfileGUI\initSettingsForm(), ilLTIConsumeProviderFormGUI\initToolConfigForm(), ilPCQuestionGUI\insert(), ilObjLanguageExtGUI\maintainObject(), ilAdvancedMDRecordTranslations\modifyTranslationInfoForDescription(), ilAdvancedMDFieldTranslations\modifyTranslationInfoForDescription(), ilAdvancedMDRecordTranslations\modifyTranslationInfoForTitle(), ilAdvancedMDFieldTranslations\modifyTranslationInfoForTitle(), assKprimChoiceGUI\populateAnswerSpecificFormPart(), assKprimChoiceGUI\populateCorrectionsFormProperties(), assKprimChoiceGUI\populateQuestionSpecificFormPart(), ilLDAPSettingsGUI\roleMapping(), ilDclBaseFieldRepresentation\setupInputField(), and ILIAS\Object\Properties\CoreProperties\TileImage\ilObjectPropertyTileImage\toLegacyForm().

                                            : void
     {
         $this->info = $a_info;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMulti()

ilFormPropertyGUI::setMulti	(	bool	$a_multi,
		bool	$a_sortable = `false`,
		bool	$a_addremove = `true`
	)

Definition at line 328 of file class.ilFormPropertyGUI.php.

Referenced by ilTaxAssignInputGUI\__construct(), and ilECSMappingSettingsGUI\initFormCSettings().

      : void {
         if (!$this instanceof ilMultiValuesItem) {
             throw new ilFormException(sprintf(
                 "%s not supported for form property type %s",
                 __FUNCTION__,
                 get_class($this)
             ));
         }
 
         $this->multi = $a_multi;
         $this->multi_sortable = $a_sortable;
         $this->multi_addremove = $a_addremove;
     }

Here is the caller graph for this function:

◆ setMultiValues()

ilFormPropertyGUI::setMultiValues ( array $a_values )

Definition at line 351 of file class.ilFormPropertyGUI.php.

Referenced by ilSelectInputGUI\setValue(), ilNonEditableValueGUI\setValue(), and ilManualPlaceholderInputGUI\setValue().

                                                    : void
     {
         $this->multi_values = array_unique($a_values);
     }

Here is the caller graph for this function:

◆ setParent()

ilFormPropertyGUI::setParent ( ilFormPropertyGUI $a_val )

Definition at line 194 of file class.ilFormPropertyGUI.php.

Referenced by ilSubEnabledFormPropertyGUI\addSubItem().

                                                        : void
     {
         $this->parent_gui = $a_val;
     }

Here is the caller graph for this function:

◆ setParentForm()

ilFormPropertyGUI::setParentForm ( ilPropertyFormGUI $a_parentform )

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

Referenced by ilPCSectionGUI\initForm().

                                                                   : void
     {
         $this->parentform = $a_parentform;
     }

Here is the caller graph for this function:

◆ setParentTable()

ilFormPropertyGUI::setParentTable ( $a_val )

Set parent table.

Parameters

ilTable2GUI $a_val table object

Definition at line 256 of file class.ilFormPropertyGUI.php.

                                           : void
     {
         $this->parent_table = $a_val;
     }

◆ setPostVar()

ilFormPropertyGUI::setPostVar ( string $a_postvar )

Definition at line 118 of file class.ilFormPropertyGUI.php.

Referenced by __construct(), ilIdentifiedMultiValuesInputGUI\getFieldIdFromPostVar(), ilRegistrationSettingsGUI\initEmailAssignmentForm(), ilLDAPSettingsGUI\initRoleMappingForm(), and ilDclGenericMultiInputGUI\render().

                                                  : void
     {
         $this->postvar = $a_postvar;
     }

Here is the caller graph for this function:

◆ setRequestParam()

ilFormPropertyGUI::setRequestParam	(	string	$key,
			$val
	)

This writes the request (aka post) values.

Code that relies on this should be refactored as soon as possible.

Deprecated:

Definition at line 566 of file class.ilFormPropertyGUI.php.

                                                       : void
     {
         $this->set_params[$key] = $val;
     }

◆ setRequired()

ilFormPropertyGUI::setRequired ( bool $a_required )

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

Referenced by FormMailCodesGUI\__construct(), ilRandomTestROInputGUI\__construct(), ilCertificateSettingsFormRepository\__construct(), ilADTFormBridge\addBasicFieldProperties(), ilMemberAgreementGUI\addCustomFields(), ilCronOerHarvester\addCustomSettingsToForm(), ilExAssTypePortfolioGUI\addEditFormCustomProperties(), ilExAssTypeWikiTeamGUI\addEditFormCustomProperties(), SurveyMatrixQuestionGUI\addFieldsToEditForm(), SurveyMultipleChoiceQuestionGUI\addFieldsToEditForm(), SurveyMetricQuestionGUI\addFieldsToEditForm(), SurveySingleChoiceQuestionGUI\addFieldsToEditForm(), ilExAssignmentEditorGUI\addMailTemplatesRadio(), ilECSObjectSettings\addSettingsToForm(), ilMembershipNotifications\addToSettingsForm(), ilTestRandomQuestionSetPoolDefinitionFormGUI\build(), ilDclSelectionFieldRepresentation\buildFieldCreationInput(), ilCmiXapiSettingsGUI\buildForm(), ilAssQuestionHintGUI\buildForm(), ilTestPasswordProtectionGUI\buildPasswordForm(), ilAssClozeTestFeedback\completeSpecificFormProperties(), ilDidacticTemplateSettingsGUI\editImportForm(), ilUserStartingPointGUI\getCalenderSubInputs(), ilObjStyleSheetGUI\getCloneForm(), ilGlossaryTermGUI\getEditTermForm(), ilObjMailGUI\getExternalSettingsForm(), ilObjStyleSheetGUI\getImportForm(), ilAccessibilityUserHasLanguageCriterionGUI\getSelection(), ilUserStartingPointGUI\getStartingPointSelectionInput(), ilObjTestGUI\getTargetQuestionpoolForm(), ilObjUserFolderGUI\initAccessRestrictionForm(), ilPageObjectGUI\initActivationForm(), ilObjMediaCastGUI\initAddCastItemForm(), ilRegistrationSettingsGUI\initAddCodesForm(), ilPCFileItemGUI\initAddFileForm(), ilPortfolioRoleAssignmentGUI\initAssignmentForm(), ilExAssignmentEditorGUI\initAssignmentForm(), ilBadgeManagementGUI\initBadgeForm(), ilECSSettingsGUI\initCategoryMappingForm(), ilObjStyleSheetGUI\initColorForm(), ilObjPortfolioTemplateGUI\initCopyPageFormOptions(), ilObjPortfolioGUI\initCopyPageFormOptions(), ilObjCmiXapiGUI\initCreateForm(), ilObjSAHSLearningModuleGUI\initCreateForm(), ilObjPortfolioGUI\initCreateFromTemplateForm(), ilPCLayoutTemplateGUI\initCreationForm(), ilBlogPostingGUI\initDateForm(), SurveyQuestionGUI\initEditForm(), ilCronManagerGUI\initEditForm(), ilPCFileListGUI\initEditForm(), ilDidacticTemplateSettingsGUI\initEditTemplate(), ilSurveyParticipantsGUI\initExternalRaterForm(), ilObjectCustomUserFieldsGUI\initFieldForm(), ilLTIConsumerSettingsFormGUI\initForm(), ilWebDAVMountInstructionsDocumentFormGUI\initForm(), ilLTIConsumeProviderFormGUI\initForm(), ilContainerNewsSettingsGUI\initForm(), ilLOTestAssignmentForm\initForm(), ilPCContentTemplateGUI\initForm(), ilOrgUnitSimpleUserImportGUI\initForm(), ilPCMapGUI\initForm(), ilPCConsultationHoursGUI\initForm(), ilPCBlogGUI\initForm(), ilPCSkillsGUI\initForm(), ilPCVerificationGUI\initForm(), ilOrgUnitSimpleImportGUI\initForm(), ilBookingScheduleGUI\initForm(), ilObjCourseGroupingGUI\initForm(), ilPCSectionGUI\initForm(), ilCustomUserFieldsGUI\initForm(), ilBookingObjectGUI\initForm(), ilObjUserGUI\initForm(), ilContainerGUI\initFormPasswordInstruction(), ilCourseObjectivesGUI\initFormRandom(), ilAuthShibbolethSettingsGUI\initFormRoleAssignment(), ilLDAPSettingsGUI\initFormRoleAssignments(), ilLPListOfSettingsGUI\initFormSettings(), ilObjSystemCheckGUI\initFormTrash(), ilPersonalSettingsGUI\initGeneralSettingsForm(), ilObjBadgeAdministrationGUI\initImageTemplateForm(), ilPermissionGUI\initImportForm(), ilSurveyRaterGUI\initMailRatersForm(), ilSurveyParticipantsGUI\initMailRatersForm(), ilObjLanguageExtGUI\initNewImportForm(), ilSurveyRaterGUI\initOptionSelectForm(), ilObjPortfolioBaseGUI\initPageForm(), ilWorkspaceAccessGUI\initPasswordForm(), ilExAssignmentEditorGUI\initPeerReviewForm(), ilPersonalProfileGUI\initPersonalDataImportForm(), ilMediaCreationGUI\initPoolSelection(), ilExSubmissionObjectGUI\initPortfolioTemplateForm(), ilPCBlogGUI\initPostingForm(), ilPDNewsBlockGUI\initPrivateSettingsForm(), ilObjPollGUI\initQuestionForm(), ilObjForumGUI\initReplyEditForm(), ilObjSurveyAdministrationGUI\initSettingsForm(), ilOpenIdConnectSettingsGUI\initSettingsForm(), ilLOEditorGUI\initSettingsForm(), ilNewsForContextBlockGUI\initSettingsForm(), ilObjWikiGUI\initTemplateSelectionForm(), ilLTIConsumeProviderFormGUI\initToolConfigForm(), ilObjSCORMLearningModuleGUI\initTrackingImportForm(), ilObjSCORMLearningModuleGUI\newModuleVersion(), ilMailingListsGUI\performDeleteMembers(), assMatchingQuestionGUI\populateAnswerSpecificFormPart(), assTextSubsetGUI\populateAnswerSpecificFormPart(), assTextQuestionGUI\populateAnswerSpecificFormPart(), assSingleChoiceGUI\populateAnswerSpecificFormPart(), assMultipleChoiceGUI\populateAnswerSpecificFormPart(), assTextSubsetGUI\populateCorrectionsFormProperties(), assLongMenuGUI\populateCorrectionsFormProperties(), assSingleChoiceGUI\populateCorrectionsFormProperties(), assMultipleChoiceGUI\populateCorrectionsFormProperties(), assMatchingQuestionGUI\populateCorrectionsFormProperties(), ilAssQuestionSkillAssignmentPropertyFormGUI\populateFullProperties(), assImagemapQuestionGUI\populateQuestionSpecificFormPart(), assLongMenuGUI\populateQuestionSpecificFormPart(), assClozeTestGUI\populateQuestionSpecificFormPart(), assMatchingQuestionGUI\populateQuestionSpecificFormPart(), assSingleChoiceGUI\populateQuestionSpecificFormPart(), assMultipleChoiceGUI\populateQuestionSpecificFormPart(), assClozeTestGUI\populateSelectGapFormPart(), assClozeTestGUI\populateTextGapFormPart(), ilAdvancedMDFieldDefinitionSelect\prepareCustomDefinitionFormConfirmation(), ilDclFileFieldRepresentation\requiredWorkaroundForInputField(), assFormulaQuestionGUI\resetSavedPreviewSession(), ilAccessibilityCriterionFormGUI\setCheckInputCalled(), ilObjCertificateSettingsGUI\settings(), and assQuestionGUI\suggestedsolution().

                                                  : void
     {
         $this->required = $a_required;
     }

Here is the caller graph for this function:

◆ setTitle()

ilFormPropertyGUI::setTitle ( string $a_title )

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

Referenced by ilMailFormAttachmentPropertyGUI\__construct(), __construct(), ILIAS\Course\Certificate\CertificateSettingsCourseFormRepository\createForm(), ilBulkEditQuestionsGUI\getFormTaxonomies(), ilObjTestGUI\getTargetQuestionpoolForm(), assOrderingQuestion\initOrderingElementFormFieldLabels(), and assQuestionGUI\populateTaxonomyFormSection().

                                              : void
     {
         $this->title = $a_title;
     }

Here is the caller graph for this function:

◆ setType()

ilFormPropertyGUI::setType ( string $a_type )

protected

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

                                               : void
     {
         $this->type = $a_type;
     }

Here is the caller graph for this function:

◆ str()

ilFormPropertyGUI::str ( $key )

protected

Definition at line 475 of file class.ilFormPropertyGUI.php.

References getRequestParam(), ILIAS\Repository\refinery(), and stripSlashesAddSpaceFallback().

                                 : string
     {
         if (is_null($this->refinery)) {
             return "";
         }
         $t = $this->refinery->kindlyTo()->string();
         return $this->stripSlashesAddSpaceFallback(
             (string) ($this->getRequestParam($key, $t) ?? "")
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ strArray()

ilFormPropertyGUI::strArray ( $key )

protected

Definition at line 496 of file class.ilFormPropertyGUI.php.

References getRequestParam(), isRequestParamArray(), ILIAS\Repository\refinery(), and stripSlashesAddSpaceFallback().

                                      : array
     {
         if (!$this->isRequestParamArray($key)) {
             return [];
         }
         $t = $this->refinery->custom()->transformation(
             function ($arr) {
                 // keep keys(!), transform all values to string
                 return array_column(
                     array_map(
                         function ($k, $v) {
                             if (is_array($v)) {
                                 $v = "";
                             }
                             return [$k, $this->stripSlashesAddSpaceFallback((string) $v)];
                         },
                         array_keys($arr),
                         $arr
                     ),
                     1,
                     0
                 );
             }
         );
         return (array) ($this->getRequestParam($key, $t) ?? []);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stripSlashesAddSpaceFallback()

ilFormPropertyGUI::stripSlashesAddSpaceFallback ( string $a_str )

Strip slashes with add space fallback, see https://www.ilias.de/mantis/view.php?id=19727.

Definition at line 414 of file class.ilFormPropertyGUI.php.

References ilUtil\stripSlashes().

Referenced by ilSamlIdpMetadataInputGUI\checkInput(), ilChatroomAuthInputGUI\getInput(), str(), and strArray().

                                                                : string
     {
         $str = ilUtil::stripSlashes($a_str);
         if ($str != $a_str) {
             $str = ilUtil::stripSlashes(str_replace("<", "< ", $a_str));
         }
         return $str;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ symbol()

ilFormPropertyGUI::symbol ( )

protected

Definition at line 92 of file class.ilFormPropertyGUI.php.

References $DIC.

Referenced by getMultiIconsHTML(), ilSelectBuilderInputGUI\insert(), and ilTextWizardInputGUI\render().

                                : \ILIAS\Repository\Symbol\SymbolAdapterGUI
     {
         global $DIC;
         return $DIC->repository()->internal()->gui()->symbol();
     }

Here is the caller graph for this function:

◆ unserializeData()

ilFormPropertyGUI::unserializeData ( string $a_data )

Definition at line 241 of file class.ilFormPropertyGUI.php.

References $data.

Referenced by readFromSession().

                                                    : void
     {
         $data = unserialize($a_data);
 
         if ($data) {
             $this->setValue($data);
         } else {
             $this->setValue("");
         }
     }

Here is the caller graph for this function:

◆ writeToSession()

ilFormPropertyGUI::writeToSession ( )

Exceptions

Exception

Definition at line 282 of file class.ilFormPropertyGUI.php.

References checkParentFormTable(), getSessionKey(), serializeData(), and ilSession\set().

Referenced by ilRepositorySelectorInputGUI\reset(), and ilRepositorySelectorInputGUI\selectRepositoryItem().

                                     : void
     {
         $this->checkParentFormTable();
         ilSession::set($this->getSessionKey(), $this->serializeData());
     }