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

Inheritance diagram for ilTagInputGUI:

Collaboration diagram for ilTagInputGUI:

Public Member Functions
	setMaxTags ($max_tags)

	setMaxChars ($max_chars)

	setAllowDuplicates ($allow_duplicates)

	setJsSelfInit ($js_self_init)

	setTypeAhead ($type_ahead)

	setTypeAheadIgnoreCase ($type_ahead_ignore_case)

	setTypeAheadMinLength ($min_length)

	setTypeAheadLimit ($limit)

	setTypeAheadHighlight ($highlight)

	setTypeAheadList ($type_ahead_list)

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

	getOptions ()
	Get Options. More...

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

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

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

	render ($a_mode="")

	insert ($a_tpl)

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

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

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

Protected Attributes
	$tpl

	$options = array()

	$max_tags = 0

	$max_chars = 0

	$allow_duplicates = false

	$js_self_init = true

	$type_ahead = false

	$type_ahead_ignore_case = true

	$type_ahead_list = array()

	$type_ahead_min_length = 2

	$type_ahead_limit = 30

	$type_ahead_highlight = true

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

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 tag list property in a property form.

Author: Guido Vollbach gvoll.nosp@m.bach.nosp@m.@data.nosp@m.bay..nosp@m.de

Version: $Id$

Definition at line 11 of file class.ilTagInputGUI.php.

Constructor & Destructor Documentation

◆ __construct()

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

Constructor.

Parameters

string	$a_title	Title
string	$a_postvar	Post Variable

Definition at line 137 of file class.ilTagInputGUI.php.

References $DIC, $tpl, and ilFormPropertyGUI\setType().

     {
         global $DIC;
 
         $this->tpl = $DIC["tpl"];
         $this->lng = $DIC->language();
         parent::__construct($a_title, $a_postvar);
         $this->setType("tag_input");
         $tpl = $DIC["tpl"];
         $tpl->addJavaScript('./Services/Form/js/bootstrap-tagsinput_2015_25_03.js');
         $tpl->addJavaScript('./Services/Form/js/typeahead_0.11.1.js');
         $tpl->addCss('./Services/Form/css/bootstrap-tagsinput_2015_25_03.css');
     }

Here is the call graph for this function:

Member Function Documentation

◆ checkInput()

ilTagInputGUI::checkInput ( )

Check input, strip slashes etc.

set alert, if input is not ok.

Returns: boolean Input ok, true/false

Definition at line 169 of file class.ilTagInputGUI.php.

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

     {
         $lng = $this->lng;
 
         $valid = true;
         if (array_key_exists($this->getPostVar(), $_POST)) {
             foreach ($_POST[$this->getPostVar()] as $idx => $value) {
                 $_POST[$this->getPostVar()][$idx] = ilUtil::stripSlashes($value);
             }
             $_POST[$this->getPostVar()] = array_unique($_POST[$this->getPostVar()]);
 
             if ($this->getRequired() && !trim(implode("", $_POST[$this->getPostVar()]))) {
                 $valid = false;
             }
         } elseif ($this->getRequired()) {
             $valid = false;
         }
         if (!$valid) {
             $this->setAlert($lng->txt("msg_input_is_required"));
             return false;
         }
         return $this->checkSubItemsInput();
     }

Here is the call graph for this function:

◆ getOptions()

ilTagInputGUI::getOptions ( )

Get Options.

Returns: array Options. Array

Definition at line 126 of file class.ilTagInputGUI.php.

Referenced by render().

     {
         return $this->options ? $this->options : array();
     }

Here is the caller graph for this function:

◆ insert()

ilTagInputGUI::insert ( $a_tpl )

Parameters

$a_tpl

Definition at line 238 of file class.ilTagInputGUI.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()

ilTagInputGUI::render ( $a_mode = "" )

Parameters

string $a_mode

Returns: string

Definition at line 197 of file class.ilTagInputGUI.php.

References $tpl, ilFormPropertyGUI\getFieldId(), getOptions(), ilFormPropertyGUI\getPostVar(), and ilUtil\prepareFormOutput().

Referenced by insert().

     {
         if ($this->type_ahead) {
             $tpl = new ilTemplate("tpl.prop_tag_typeahead.html", true, true, "Services/Form");
             $tpl->setVariable("MIN_LENGTH", $this->type_ahead_min_length);
             $tpl->setVariable("LIMIT", $this->type_ahead_limit);
             $tpl->setVariable("HIGHLIGHT", $this->type_ahead_highlight);
             if ($this->type_ahead_ignore_case) {
                 $tpl->setVariable("CASE", 'i');
             }
             $tpl->setVariable("TERMS", json_encode($this->type_ahead_list));
         } else {
             $tpl = new ilTemplate("tpl.prop_tag.html", true, true, "Services/Form");
         }
 
         $tpl->setVariable("MAXTAGS", $this->max_tags);
         $tpl->setVariable("MAXCHARS", $this->max_chars);
         $tpl->setVariable("ALLOW_DUPLICATES", $this->allow_duplicates);
         
         foreach ($this->getOptions() as $option_value => $option_text) {
             $tpl->setCurrentBlock("prop_select_option");
             $tpl->setVariable("VAL_SELECT_OPTION", ilUtil::prepareFormOutput($option_text));
             $tpl->setVariable("TXT_SELECT_OPTION", $option_text);
             $tpl->parseCurrentBlock();
         }
         
         $tpl->setVariable("ID", $this->getFieldId());
                     
         $tpl->setVariable("POST_VAR", $this->getPostVar() . "[]");
         
         if ($this->js_self_init) {
             $tpl->setCurrentBlock("initialize_on_page_load");
             $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:

◆ setAllowDuplicates()

ilTagInputGUI::setAllowDuplicates ( $allow_duplicates )

Parameters

boolean $allow_duplicates

Definition at line 50 of file class.ilTagInputGUI.php.

References $allow_duplicates.

     {
         $this->allow_duplicates = $allow_duplicates;
     }

◆ setJsSelfInit()

ilTagInputGUI::setJsSelfInit ( $js_self_init )

Parameters

boolean $js_self_init

Definition at line 58 of file class.ilTagInputGUI.php.

References $js_self_init.

     {
         $this->js_self_init = $js_self_init;
     }

◆ setMaxChars()

ilTagInputGUI::setMaxChars ( $max_chars )

Parameters

int $max_chars

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

References $max_chars.

     {
         $this->max_chars = $max_chars;
     }

◆ setMaxTags()

ilTagInputGUI::setMaxTags ( $max_tags )

Parameters

int $max_tags

Definition at line 34 of file class.ilTagInputGUI.php.

References $max_tags.

     {
         $this->max_tags = $max_tags;
     }

◆ setOptions()

ilTagInputGUI::setOptions ( $a_options )

Set Options.

Parameters

array $a_options Options.

Definition at line 116 of file class.ilTagInputGUI.php.

Referenced by setValueByArray().

     {
         $this->options = $a_options;
     }

Here is the caller graph for this function:

◆ setTypeAhead()

ilTagInputGUI::setTypeAhead ( $type_ahead )

Parameters

boolean $type_ahead

Definition at line 66 of file class.ilTagInputGUI.php.

References $type_ahead.

     {
         $this->type_ahead = $type_ahead;
     }

◆ setTypeAheadHighlight()

ilTagInputGUI::setTypeAheadHighlight ( $highlight )

Parameters

boolean $highlight

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

     {
         $this->type_ahead_highlight = $highlight;
     }

◆ setTypeAheadIgnoreCase()

ilTagInputGUI::setTypeAheadIgnoreCase ( $type_ahead_ignore_case )

Parameters

boolean $type_ahead_ignore_case

Definition at line 74 of file class.ilTagInputGUI.php.

References $type_ahead_ignore_case.

     {
         $this->type_ahead_ignore_case = $type_ahead_ignore_case;
     }

◆ setTypeAheadLimit()

ilTagInputGUI::setTypeAheadLimit ( $limit )

Parameters

int $limit

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

     {
         $this->type_ahead_limit = $limit;
     }

◆ setTypeAheadList()

ilTagInputGUI::setTypeAheadList ( $type_ahead_list )

Parameters

array $type_ahead_list

Definition at line 106 of file class.ilTagInputGUI.php.

References $type_ahead_list.

     {
         $this->type_ahead_list = $type_ahead_list;
     }

◆ setTypeAheadMinLength()

ilTagInputGUI::setTypeAheadMinLength ( $min_length )

Parameters

int $min_length

Definition at line 82 of file class.ilTagInputGUI.php.

     {
         $this->type_ahead_min_length = $min_length;
     }

◆ setValueByArray()

ilTagInputGUI::setValueByArray ( $a_values )

Set value by array.

Parameters

array $a_values value array

Definition at line 156 of file class.ilTagInputGUI.php.

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

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

Here is the call graph for this function:

Field Documentation

◆ $allow_duplicates

ilTagInputGUI::$allow_duplicates = false

protected

Definition at line 21 of file class.ilTagInputGUI.php.

Referenced by setAllowDuplicates().

◆ $js_self_init

ilTagInputGUI::$js_self_init = true

protected

Definition at line 22 of file class.ilTagInputGUI.php.

Referenced by setJsSelfInit().

◆ $max_chars

ilTagInputGUI::$max_chars = 0

protected

Definition at line 20 of file class.ilTagInputGUI.php.

Referenced by setMaxChars().

◆ $max_tags

ilTagInputGUI::$max_tags = 0

protected

Definition at line 19 of file class.ilTagInputGUI.php.

Referenced by setMaxTags().

◆ $options

ilTagInputGUI::$options = array()

protected

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

◆ $tpl

ilTagInputGUI::$tpl

protected

Definition at line 16 of file class.ilTagInputGUI.php.

Referenced by __construct(), and render().

◆ $type_ahead

ilTagInputGUI::$type_ahead = false

protected

Definition at line 24 of file class.ilTagInputGUI.php.

Referenced by setTypeAhead().

◆ $type_ahead_highlight

ilTagInputGUI::$type_ahead_highlight = true

protected

Definition at line 29 of file class.ilTagInputGUI.php.

◆ $type_ahead_ignore_case

ilTagInputGUI::$type_ahead_ignore_case = true

protected

Definition at line 25 of file class.ilTagInputGUI.php.

Referenced by setTypeAheadIgnoreCase().

◆ $type_ahead_limit

ilTagInputGUI::$type_ahead_limit = 30

protected

Definition at line 28 of file class.ilTagInputGUI.php.

◆ $type_ahead_list

ilTagInputGUI::$type_ahead_list = array()

protected

Definition at line 26 of file class.ilTagInputGUI.php.

Referenced by setTypeAheadList().

◆ $type_ahead_min_length

ilTagInputGUI::$type_ahead_min_length = 2

protected

Definition at line 27 of file class.ilTagInputGUI.php.

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

Services/Form/classes/class.ilTagInputGUI.php

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ checkInput()

◆ getOptions()

◆ insert()

◆ render()

◆ setAllowDuplicates()

◆ setJsSelfInit()

◆ setMaxChars()

◆ setMaxTags()

◆ setOptions()

◆ setTypeAhead()

◆ setTypeAheadHighlight()

◆ setTypeAheadIgnoreCase()

◆ setTypeAheadLimit()

◆ setTypeAheadList()

◆ setTypeAheadMinLength()

◆ setValueByArray()

Field Documentation

◆ $allow_duplicates

◆ $js_self_init

◆ $max_chars

◆ $max_tags

◆ $options

◆ $tpl

◆ $type_ahead

◆ $type_ahead_highlight

◆ $type_ahead_ignore_case

◆ $type_ahead_limit

◆ $type_ahead_list

◆ $type_ahead_min_length