ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
ilCheckboxInputGUI Class Reference

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

+ Inheritance diagram for ilCheckboxInputGUI:
+ Collaboration diagram for ilCheckboxInputGUI:

Public Member Functions

 __construct ($a_title="", $a_postvar="")
 Constructor. More...
 
 setValue ($a_value)
 Set Value. More...
 
 getValue ()
 Get Value. More...
 
 setChecked ($a_checked)
 Set Checked. More...
 
 getChecked ()
 Get Checked. More...
 
 setOptionTitle ($a_optiontitle)
 Set Option Title (optional). More...
 
 getOptionTitle ()
 Get Option Title (optional). More...
 
 setValueByArray ($a_values)
 Set value by array. More...
 
 setAdditionalAttributes ($a_attrs)
 Set addiotional attributes. More...
 
 getAdditionalAttributes ()
 get addtional attributes More...
 
 checkInput ()
 Check input, strip slashes etc. More...
 
 hideSubForm ()
 Sub form hidden on init? More...
 
 render ($a_mode='')
 Render item. More...
 
 insert ($a_tpl)
 Insert property html. More...
 
 getTableFilterHTML ()
 Get HTML for table filter. More...
 
 serializeData ()
 serialize data More...
 
 unserializeData ($a_data)
 unserialize data More...
 
 getToolbarHTML ()
 Get HTML for toolbar. 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 Attributes

 $value = "1"
 
 $checked
 
 $optiontitle = ""
 
 $additional_attributes = ''
 
- Protected Attributes inherited from ilSubEnabledFormPropertyGUI
 $sub_items = array()
 
- Protected Attributes inherited from ilFormPropertyGUI
 $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...
 
- Protected Member Functions inherited from ilFormPropertyGUI
 setType ($a_type)
 Set Type. More...
 
 getMultiIconsHTML ()
 Get HTML for multiple value icons. More...
 

Detailed Description

This class represents a checkbox property in a property form.

Author
Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e
Version
$Id$

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

Constructor & Destructor Documentation

◆ __construct()

ilCheckboxInputGUI::__construct (   $a_title = "",
  $a_postvar = "" 
)

Constructor.

Parameters
string$a_titleTitle
string$a_postvarPost Variable

Definition at line 46 of file class.ilCheckboxInputGUI.php.

References ilFormPropertyGUI\setType().

47  {
48  parent::__construct($a_title, $a_postvar);
49  $this->setType("checkbox");
50  }
setType($a_type)
Set Type.
+ Here is the call graph for this function:

Member Function Documentation

◆ checkInput()

ilCheckboxInputGUI::checkInput ( )

Check input, strip slashes etc.

set alert, if input is not ok.

Returns
boolean Input ok, true/false

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

References $_POST, $lng, $ok, ilSubEnabledFormPropertyGUI\checkSubItemsInput(), ilFormPropertyGUI\getPostVar(), and ilUtil\stripSlashes().

151  {
152  global $lng;
153 
154  $_POST[$this->getPostVar()] =
156 
157  // getRequired() is NOT processed here!
158 
159  $ok = $this->checkSubItemsInput();
160 
161  // only not ok, if checkbox not checked
162  if (!$ok && $_POST[$this->getPostVar()] == "")
163  {
164  $ok = true;
165  }
166 
167  return $ok;
168  }
getPostVar()
Get Post Variable.
static stripSlashes($a_str, $a_strip_html=true, $a_allow="")
strip slashes if magic qoutes is enabled
global $lng
Definition: privfeed.php:17
$_POST["username"]
+ Here is the call graph for this function:

◆ getAdditionalAttributes()

ilCheckboxInputGUI::getAdditionalAttributes ( )

get addtional attributes

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

References $additional_attributes.

Referenced by render().

+ Here is the caller graph for this function:

◆ getChecked()

ilCheckboxInputGUI::getChecked ( )

Get Checked.

Returns
boolean Checked

Definition at line 87 of file class.ilCheckboxInputGUI.php.

References $checked.

Referenced by hideSubForm(), render(), and serializeData().

88  {
89  return $this->checked;
90  }
+ Here is the caller graph for this function:

◆ getOptionTitle()

ilCheckboxInputGUI::getOptionTitle ( )

Get Option Title (optional).

Returns
string Option Title (optional)

Definition at line 107 of file class.ilCheckboxInputGUI.php.

References $optiontitle.

Referenced by render().

108  {
109  return $this->optiontitle;
110  }
+ Here is the caller graph for this function:

◆ getTableFilterHTML()

ilCheckboxInputGUI::getTableFilterHTML ( )

Get HTML for table filter.

Definition at line 233 of file class.ilCheckboxInputGUI.php.

References $html, and render().

234  {
235  $html = $this->render();
236  return $html;
237  }
render($a_mode='')
Render item.
$html
Definition: example_001.php:87
+ Here is the call graph for this function:

◆ getToolbarHTML()

ilCheckboxInputGUI::getToolbarHTML ( )

Get HTML for toolbar.

Implements ilToolbarItem.

Definition at line 264 of file class.ilCheckboxInputGUI.php.

References $html, and render().

265  {
266  $html = $this->render('toolbar');
267  return $html;
268  }
render($a_mode='')
Render item.
$html
Definition: example_001.php:87
+ Here is the call graph for this function:

◆ getValue()

ilCheckboxInputGUI::getValue ( )

Get Value.

Returns
string Value

Definition at line 67 of file class.ilCheckboxInputGUI.php.

References $value.

Referenced by render().

68  {
69  return $this->value;
70  }
+ Here is the caller graph for this function:

◆ hideSubForm()

ilCheckboxInputGUI::hideSubForm ( )

Sub form hidden on init?

Definition at line 174 of file class.ilCheckboxInputGUI.php.

References getChecked().

175  {
176  return !$this->getChecked();
177  }
+ Here is the call graph for this function:

◆ insert()

ilCheckboxInputGUI::insert (   $a_tpl)

Insert property html.

Returns
int Size

Definition at line 221 of file class.ilCheckboxInputGUI.php.

References $html, and render().

222  {
223  $html = $this->render();
224 
225  $a_tpl->setCurrentBlock("prop_generic");
226  $a_tpl->setVariable("PROP_GENERIC", $html);
227  $a_tpl->parseCurrentBlock();
228  }
render($a_mode='')
Render item.
$html
Definition: example_001.php:87
+ Here is the call graph for this function:

◆ render()

ilCheckboxInputGUI::render (   $a_mode = '')

Render item.

Definition at line 182 of file class.ilCheckboxInputGUI.php.

References $tpl, getAdditionalAttributes(), getChecked(), ilFormPropertyGUI\getDisabled(), ilFormPropertyGUI\getFieldId(), getOptionTitle(), ilFormPropertyGUI\getPostVar(), and getValue().

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

183  {
184  $tpl = new ilTemplate("tpl.prop_checkbox.html", true, true, "Services/Form");
185 
186  $tpl->setVariable("POST_VAR", $this->getPostVar());
187  $tpl->setVariable("ID", $this->getFieldId());
188  $tpl->setVariable("PROPERTY_VALUE", $this->getValue());
189  $tpl->setVariable("OPTION_TITLE", $this->getOptionTitle());
190  if(strlen($this->getAdditionalAttributes()))
191  {
192  $tpl->setVariable('PROP_CHECK_ATTRS',$this->getAdditionalAttributes());
193  }
194  if ($this->getChecked())
195  {
196  $tpl->setVariable("PROPERTY_CHECKED",
197  'checked="checked"');
198  }
199  if ($this->getDisabled())
200  {
201  $tpl->setVariable("DISABLED",
202  'disabled="disabled"');
203  }
204 
205  if ($a_mode == "toolbar")
206  {
207  // block-inline hack, see: http://blog.mozilla.com/webdev/2009/02/20/cross-browser-inline-block/
208  // -moz-inline-stack for FF2
209  // zoom 1; *display:inline for IE6 & 7
210  $tpl->setVariable("STYLE_PAR", 'display: -moz-inline-stack; display:inline-block; zoom: 1; *display:inline;');
211  }
212 
213  return $tpl->get();
214  }
getOptionTitle()
Get Option Title (optional).
getPostVar()
Get Post Variable.
global $tpl
Definition: ilias.php:8
getFieldId()
Get Post Variable.
special template class to simplify handling of ITX/PEAR
getAdditionalAttributes()
get addtional attributes
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ serializeData()

ilCheckboxInputGUI::serializeData ( )

serialize data

Definition at line 242 of file class.ilCheckboxInputGUI.php.

References getChecked().

243  {
244  return serialize($this->getChecked());
245  }
+ Here is the call graph for this function:

◆ setAdditionalAttributes()

ilCheckboxInputGUI::setAdditionalAttributes (   $a_attrs)

Set addiotional attributes.

Parameters
string$a_attrsaddition attribute string

Definition at line 131 of file class.ilCheckboxInputGUI.php.

132  {
133  $this->additional_attributes = $a_attrs;
134  }

◆ setChecked()

ilCheckboxInputGUI::setChecked (   $a_checked)

Set Checked.

Parameters
boolean$a_checkedChecked

Definition at line 77 of file class.ilCheckboxInputGUI.php.

Referenced by ilCourseContentGUI\__showUserAcceptanceTable(), ilObjTestSettingsGeneralGUI\addAvailabilityProperties(), ilObjTestSettingsGeneralGUI\addQuestionBehaviourProperties(), ilObjTestSettingsGeneralGUI\addTestAccessProperties(), ilObjTestSettingsGeneralGUI\addTestFinishProperties(), ilObjTestSettingsGeneralGUI\addTestIntroProperties(), ilAdvancedMDFieldDefinition\addToFieldDefinitionForm(), ilObjSystemFolderGUI\benchmarkObject(), ilObjQuestionPoolSettingsGeneralGUI\buildForm(), ilTestScoringGUI\buildManScoringParticipantForm(), ilCertificateGUI\certificateEditor(), ilSetupGUI\displayDatabase(), ilObjExternalToolsSettingsGUI\editMapsObject(), ilObjExternalToolsSettingsGUI\editMathJaxObject(), ilObjPersonalDesktopSettingsGUI\editSettings(), ilObjUserGUI\getValues(), ilSetupGUI\initDbSlaveForm(), ilObjRootFolderGUI\initEditForm(), ilObjPortfolioGUI\initEditForm(), ilObjCourseGUI\initEditForm(), ilDidacticTemplateSettingsGUI\initEditTemplate(), ilLearningProgressBaseGUI\initEditUserForm(), ilCalendarRecurrenceGUI\initForm(), ilAdvancedMDSettingsGUI\initForm(), ilObjGroupGUI\initForm(), ilECSMappingSettingsGUI\initFormCSettings(), ilECSMappingSettingsGUI\initFormDSettings(), ilObjLinkResourceGUI\initFormLink(), ilObjRoleTemplateGUI\initFormRoleTemplate(), ilCASSettingsGUI\initFormSettings(), ilObjSearchSettingsGUI\initFormSettings(), ilObjAdvancedEditingGUI\initGeneralPageSettingsForm(), ilPersonalSettingsGUI\initGeneralSettingsForm(), ilObjSystemFolderGUI\initHTTPSForm(), ilObjContentObjectGUI\initMenuForm(), ilPDNewsBlockGUI\initPrivateSettingsForm(), ilObjSurveyGUI\initPropertiesForm(), ilObjSurveyAdministrationGUI\initSettingsForm(), ilObjUserTrackingGUI\initSettingsForm(), ilECSSettingsGUI\initSettingsForm(), ilObjMDSettingsGUI\initSettingsForm(), ilObjTaxonomyGUI\initSettingsForm(), ilObjMediaCastGUI\initSettingsForm(), ilWikiPageTemplateGUI\listTemplates(), ilScoringAdjustmentGUI\outputAdjustQuestionForm(), assKprimChoiceGUI\populateQuestionSpecificFormPart(), ilRadiusSettingsGUI\settings(), ilObjCertificateSettingsGUI\settings(), ilObjAssessmentFolderGUI\settingsObject(), ilObjAdvancedEditingGUI\settingsObject(), ilObjLanguageExtGUI\settingsObject(), setValueByArray(), ilConditionHandlerGUI\showObligatoryForm(), ilPersonalProfileGUI\showPublicProfileFields(), and unserializeData().

78  {
79  $this->checked = $a_checked;
80  }
+ Here is the caller graph for this function:

◆ setOptionTitle()

ilCheckboxInputGUI::setOptionTitle (   $a_optiontitle)

Set Option Title (optional).

Parameters
string$a_optiontitleOption Title (optional)

Definition at line 97 of file class.ilCheckboxInputGUI.php.

Referenced by ilMailFormGUI\getTemplateDataById(), ilSetupGUI\initBasicSettingsForm(), ilMailFolderTableGUI\initFilter(), ilLDAPSettingsGUI\initForm(), ilObjSearchSettingsGUI\initFormLuceneSettings(), ilObjCalendarSettingsGUI\initFormSettings(), and ilObjFileBasedLMGUI\initSettingsForm().

98  {
99  $this->optiontitle = $a_optiontitle;
100  }
+ Here is the caller graph for this function:

◆ setValue()

ilCheckboxInputGUI::setValue (   $a_value)

Set Value.

Parameters
string$a_valueValue

Definition at line 57 of file class.ilCheckboxInputGUI.php.

Referenced by ilDAVCronDiskQuota\addCustomSettingsToForm(), SurveyMultipleChoiceQuestionGUI\addFieldsToEditForm(), SurveyMatrixQuestionGUI\addFieldsToEditForm(), ilObjTestSettingsGeneralGUI\addQuestionBehaviourProperties(), ilObjTestSettingsScoringResultsGUI\addResultDetailsSettingsFormSection(), ilECSObjectSettings\addSettingsToForm(), ilObjTestSettingsGeneralGUI\addTestAccessProperties(), ilObjTestSettingsGeneralGUI\addTestFinishProperties(), ilObjTestSettingsGeneralGUI\addTestIntroProperties(), ilObjTestSettingsGeneralGUI\addTestRunProperties(), ilObjTestSettingsGeneralGUI\addTestSequenceProperties(), ilObjTestDynamicQuestionSetConfigGUI\buildForm(), ilObjGroupGUI\editMapSettingsObject(), ilObjCourseGUI\editMapSettingsObject(), ilObjNewsSettingsGUI\editSettings(), ilObjPersonalDesktopSettingsGUI\editSettings(), ilObjSkillManagementGUI\editSettings(), ilObjFileAccessSettingsGUI\editWebDAVSettings(), ilObjPersonalDesktopSettingsGUI\editWsp(), ilObjContactAdministrationGUI\getConfigurationForm(), ilSearchBaseGUI\getCreationDateForm(), ilObjUserGUI\getValues(), ilObjUserGUI\handleIgnoredRequiredFields(), ilObjFileAccessSettingsGUI\initDownloadingSettingsForm(), SurveyQuestionGUI\initEditForm(), ilObjCourseGUI\initEditForm(), ilObjectCustomUserFieldsGUI\initFieldForm(), ilObjMailGUI\initForm(), ilObjBibliographicAdminLibrariesFormGUI\initForm(), ilContainerNewsSettingsGUI\initForm(), ilRegistrationSettingsGUI\initForm(), ilLDAPSettingsGUI\initForm(), ilObjGroupGUI\initForm(), ilObjUserFolderGUI\initFormGeneralSettings(), ilObjLinkResourceGUI\initFormLink(), ilObjSearchSettingsGUI\initFormLuceneSettings(), ilObjRoleGUI\initFormRoleProperties(), ilObjPortfolioAdministrationGUI\initFormSettings(), ilObjTaggingSettingsGUI\initFormSettings(), ilObjSearchSettingsGUI\initFormSettings(), ilObjLoggingSettingsGUI\initFormSettings(), ilObjCalendarSettingsGUI\initFormSettings(), ilAdvancedMDSettingsGUI\initFormSubstitutions(), ilObjForumGUI\initForumCreateForm(), ilObjUserFolderGUI\initLoginSettingsForm(), ilObjForumGUI\initNotificationSettingsForm(), ilObjFileAccessSettingsGUI\initPreviewSettingsForm(), ilObjSCORM2004LearningModuleGUI\initPropertiesForm(), ilObjSurveyGUI\initPropertiesForm(), ilObjRepositorySettingsGUI\initSettingsForm(), ilMemberExportGUI\initSettingsForm(), ilLOEditorGUI\initSettingsForm(), ilObjGlossaryGUI\initSettingsForm(), ilSearchBaseGUI\initStandardSearchForm(), ilObjSAHSLearningModuleGUI\initUploadForm(), ilObjFileAccessSettingsGUI\initUploadSettingsForm(), assFormulaQuestionGUI\isSaveCommand(), ilObjForumGUI\isTopLevelReplyCommand(), ilObjLinkResourceGUI\linkChecker(), ilObjContentObjectGUI\linkChecker(), assClozeTestGUI\populateQuestionSpecificFormPart(), assSingleChoiceGUI\populateQuestionSpecificFormPart(), assMultipleChoiceGUI\populateQuestionSpecificFormPart(), assClozeTestGUI\populateSelectGapFormPart(), ilObjSCORMLearningModuleGUI\properties(), ilNotificationGUI\showSettingsObject(), and unserializeData().

58  {
59  $this->value = $a_value;
60  }
+ Here is the caller graph for this function:

◆ setValueByArray()

ilCheckboxInputGUI::setValueByArray (   $a_values)

Set value by array.

Parameters
object$a_itemItem

Definition at line 117 of file class.ilCheckboxInputGUI.php.

References ilFormPropertyGUI\getPostVar(), ilSubEnabledFormPropertyGUI\getSubItems(), and setChecked().

118  {
119  $this->setChecked($a_values[$this->getPostVar()]);
120  foreach($this->getSubItems() as $item)
121  {
122  $item->setValueByArray($a_values);
123  }
124  }
getPostVar()
Get Post Variable.
setChecked($a_checked)
Set Checked.
+ Here is the call graph for this function:

◆ unserializeData()

ilCheckboxInputGUI::unserializeData (   $a_data)

unserialize data

Definition at line 250 of file class.ilCheckboxInputGUI.php.

References $data, setChecked(), and setValue().

251  {
252  $data = unserialize($a_data);
253 
254  if ($data)
255  {
256  $this->setValue($data);
257  $this->setChecked(true);
258  }
259  }
setChecked($a_checked)
Set Checked.
setValue($a_value)
Set Value.
+ Here is the call graph for this function:

Field Documentation

◆ $additional_attributes

ilCheckboxInputGUI::$additional_attributes = ''
protected

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

Referenced by getAdditionalAttributes().

◆ $checked

ilCheckboxInputGUI::$checked
protected

Definition at line 36 of file class.ilCheckboxInputGUI.php.

Referenced by getChecked().

◆ $optiontitle

ilCheckboxInputGUI::$optiontitle = ""
protected

Definition at line 37 of file class.ilCheckboxInputGUI.php.

Referenced by getOptionTitle().

◆ $value

ilCheckboxInputGUI::$value = "1"
protected

Definition at line 35 of file class.ilCheckboxInputGUI.php.

Referenced by getValue().


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