Class ilOrgUnitMultiLineInputGUI. More...

Inheritance diagram for ilOrgUnitMultiLineInputGUI:

Collaboration diagram for ilOrgUnitMultiLineInputGUI:

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

	getHook ($key)

	addHook ($key, $options)

	removeHook ($key)

	addInput (\ilFormPropertyGUI $input, $options=array())

	getTemplateDir ()

	setTemplateDir ($template_dir)

	isShowLabel ()

	setShowLabel ($show_label)

	getInputs ()
	Get Options. More...

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

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

	addCustomAttribute ($key, $value, $override=false)

	getCustomAttributes ()

	render ($iterator_id=0, $clean_render=false)
	Render item. More...

	initCSSandJS ()

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

	getTableFilterHTML ()
	Get HTML for table filter. More...

	getToolbarHTML ()
	Get HTML for toolbar. More...

	isPositionMovable ()

	setPositionMovable ($position_movable)

	isShowLabelOnce ()

	setShowLabelOnce ($show_label_once)

	isShowInfo ()

	setShowInfo ($show_info)

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

Data Fields
const	HOOK_IS_LINE_REMOVABLE = "hook_is_line_removable"

const	HOOK_IS_INPUT_DISABLED = "hook_is_disabled"

const	HOOK_BEFORE_INPUT_RENDER = "hook_before_render"

Protected Member Functions
	createInputPostVar ($iterator_id, \ilFormPropertyGUI $input)

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

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

Protected Attributes
	$cust_attr = array()

	$value

	$inputs = array()

	$input_options = array()

	$hooks = array()

	$line_values = array()

	$template_dir = ''

	$post_var_cache = array()

	$show_label = false

	$show_label_once = false

	$hidden_inputs = array()

	$position_movable = false

	$counter = 0

	$show_info = false

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

Class ilOrgUnitMultiLineInputGUI.

Author: Michael Herren mh@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch; Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Definition at line 9 of file class.ilOrgUnitMultiLineInputGUI.php.

Constructor & Destructor Documentation

◆ __construct()

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

Constructor.

Parameters

string	$a_title	Title
string	$a_postvar	Post Variable

Reimplemented from ilFormPropertyGUI.

Definition at line 78 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        parent::__construct($a_title, $a_postvar);
        $this->setType("line_select");
        $this->setMulti(true);
        $this->initCSSandJS();
    }

References ILIAS\GlobalScreen\Provider\__construct(), initCSSandJS(), setMulti(), and ilFormPropertyGUI\setType().

Here is the call graph for this function:

Member Function Documentation

◆ addCustomAttribute()

ilOrgUnitMultiLineInputGUI::addCustomAttribute	(	$key,
		$value,
		$override = `false`
	)

Parameters

	$key
	$value
bool \| false	$override

Definition at line 287 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        if (isset($this->cust_attr[$key]) && !$override) {
            $this->cust_attr[$key] .= ' ' . $value;
        } else {
            $this->cust_attr[$key] = $value;
        }
    }

References $value.

Referenced by render().

Here is the caller graph for this function:

◆ addHook()

ilOrgUnitMultiLineInputGUI::addHook	(	$key,
		$options
	)

Parameters

array $options

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

    {
        $this->hooks[$key] = $options;
    }

◆ addInput()

ilOrgUnitMultiLineInputGUI::addInput	(	\ilFormPropertyGUI	$input,
			$options = `array()`
	)

Parameters

	$input
array	$options

Definition at line 130 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $this->inputs[$input->getPostVar()] = $input;
        $this->input_options[$input->getPostVar()] = $options;
        $this->counter++;
    }

References ilFormPropertyGUI\getPostVar().

Here is the call graph for this function:

◆ checkInput()

ilOrgUnitMultiLineInputGUI::checkInput ( )

Check input, strip slashes etc.

set alert, if input is not ok.

Returns: boolean Input ok, true/false

Reimplemented from ilFormPropertyGUI.

Definition at line 249 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        global $lng;
        $valid = true;
        // escape data
        $out_array = array();
        foreach ($_POST[$this->getPostVar()] as $item_num => $item) {
            foreach ($this->inputs as $input_key => $input) {
                if (isset($item[$input_key])) {
                    $out_array[$item_num][$input_key] = (is_string($item[$input_key])) ? \ilUtil::stripSlashes($item[$input_key]) : $item[$input_key];
                }
            }
        }
        $_POST[$this->getPostVar()] = $out_array;
        if ($this->getRequired() && !trim(implode("", $_POST[$this->getPostVar()]))) {
            $valid = false;
        }
        // validate
        foreach ($this->inputs as $input_key => $inputs) {
            if (!$inputs->checkInput()) {
                $valid = false;
            }
        }
        if (!$valid) {
            $this->setAlert($lng->txt("msg_input_is_required"));
 
            return false;
        }
 
        return $valid;
    }

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

Here is the call graph for this function:

◆ createInputPostVar()

ilOrgUnitMultiLineInputGUI::createInputPostVar	(		$iterator_id,
		\ilFormPropertyGUI	$input
	)

protected

Parameters

	$iterator_id
\ilFormPropertyGUI	$input

Returns: string

Definition at line 312 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        if ($this->getMulti()) {
            return $this->getPostVar() . '[' . $iterator_id . '][' . $input->getPostVar() . ']';
        } else {
            return $this->getPostVar() . '[' . $input->getPostVar() . ']';
        }
    }

References ilFormPropertyGUI\getMulti(), and ilFormPropertyGUI\getPostVar().

Referenced by render().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCustomAttributes()

ilOrgUnitMultiLineInputGUI::getCustomAttributes ( )

Returns: array

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

    {
        return (array) $this->cust_attr;
    }

References $cust_attr.

Referenced by render().

Here is the caller graph for this function:

◆ getHook()

ilOrgUnitMultiLineInputGUI::getHook ( $key )

Returns: string

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

    {
        if (isset($this->hooks[$key])) {
            return $this->hooks[$key];
        }
 
        return false;
    }

Referenced by render().

Here is the caller graph for this function:

◆ getInputs()

ilOrgUnitMultiLineInputGUI::getInputs ( )

Get Options.

Returns: array Options. Array ("value" => "option_text")

Definition at line 179 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        return $this->inputs;
    }

References $inputs.

◆ getTableFilterHTML()

ilOrgUnitMultiLineInputGUI::getTableFilterHTML ( )

Get HTML for table filter.

Definition at line 489 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $html = $this->render();
 
        return $html;
    }

References render().

Here is the call graph for this function:

◆ getTemplateDir()

ilOrgUnitMultiLineInputGUI::getTemplateDir ( )

Returns: mixed

Definition at line 141 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        return $this->template_dir;
    }

References $template_dir.

◆ getToolbarHTML()

ilOrgUnitMultiLineInputGUI::getToolbarHTML ( )

Get HTML for toolbar.

Definition at line 500 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $html = $this->render("toolbar");
 
        return $html;
    }

References render().

Here is the call graph for this function:

◆ getValue()

ilOrgUnitMultiLineInputGUI::getValue ( )

Get Value.

Returns: string Value

Definition at line 217 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $out = array();
        foreach ($this->inputs as $key => $item) {
            $out[$key] = $item->getValue();
        }
 
        return $out;
    }

References $out.

Referenced by render().

Here is the caller graph for this function:

◆ initCSSandJS()

ilOrgUnitMultiLineInputGUI::initCSSandJS ( )

Definition at line 448 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        global $tpl;
        $tpl->addJavascript('./Modules/OrgUnit/templates/default/multi_line_input.js');
    }

References $tpl.

Referenced by __construct().

Here is the caller graph for this function:

◆ insert()

ilOrgUnitMultiLineInputGUI::insert ( & $a_tpl )

Insert property html.

Returns: int Size

Definition at line 460 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $output = "";
 
        $output .= $this->render(0, true);
        if ($this->getMulti() && is_array($this->line_values) && count($this->line_values) > 0) {
            foreach ($this->line_values as $run => $data) {
                $object = $this;
                $object->setValue($data);
                $output .= $object->render($run);
            }
        } else {
            $output .= $this->render(0, true);
        }
        if ($this->getMulti()) {
            $output = '<div id="' . $this->getFieldId() . '" class="multi_line_input">' . $output
                . '</div>';
            $output .= '<script type="text/javascript">$("#' . $this->getFieldId()
                . '").multi_line_input(' . json_encode($this->input_options) . ')</script>';
        }
        $a_tpl->setCurrentBlock("prop_generic");
        $a_tpl->setVariable("PROP_GENERIC", $output);
        $a_tpl->parseCurrentBlock();
    }

References $data, ilFormPropertyGUI\getFieldId(), ilFormPropertyGUI\getMulti(), and render().

Here is the call graph for this function:

◆ isPositionMovable()

ilOrgUnitMultiLineInputGUI::isPositionMovable ( )

Returns: boolean

Definition at line 511 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        return $this->position_movable;
    }

References $position_movable.

Referenced by render().

Here is the caller graph for this function:

◆ isShowInfo()

ilOrgUnitMultiLineInputGUI::isShowInfo ( )

Returns: boolean

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

    {
        return $this->show_info;
    }

References $show_info.

Referenced by render().

Here is the caller graph for this function:

◆ isShowLabel()

ilOrgUnitMultiLineInputGUI::isShowLabel ( )

Returns: boolean

Definition at line 159 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        return $this->show_label;
    }

References $show_label.

Referenced by render().

Here is the caller graph for this function:

◆ isShowLabelOnce()

ilOrgUnitMultiLineInputGUI::isShowLabelOnce ( )

Returns: boolean

Definition at line 529 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        return $this->show_label_once;
    }

References $show_label_once.

Referenced by render().

Here is the caller graph for this function:

◆ removeHook()

ilOrgUnitMultiLineInputGUI::removeHook ( $key )

Parameters

$key

Returns: bool

Definition at line 114 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        if (isset($this->hooks[$key])) {
            unset($this->hooks[$key]);
 
            return true;
        }
 
        return false;
    }

◆ render()

ilOrgUnitMultiLineInputGUI::render	(	$iterator_id = `0`,
		$clean_render = `false`
	)

Render item.

Parameters

int $iterator_id

Returns: string

Exceptions

ilException

Definition at line 330 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $first_label = true;
        $tpl = new \ilTemplate("tpl.multi_line_input.html", true, true, 'Customizing/global/plugins/Services/Repository/RepositoryObject/LiveVoting');
        $class = 'multi_input_line';
        $this->addCustomAttribute('class', $class, true);
        foreach ($this->getCustomAttributes() as $key => $value) {
            $tpl->setCurrentBlock('cust_attr');
            $tpl->setVariable('CUSTOM_ATTR_KEY', $key);
            $tpl->setVariable('CUSTOM_ATTR_VALUE', $value);
            $tpl->parseCurrentBlock();
        }
        $inputs = $this->inputs;
        foreach ($inputs as $key => $input) {
            $input = clone $input;
            $is_hidden = false;
            $is_ta = false;
            if (!method_exists($input, 'render')) {
                switch (true) {
                    case ($input instanceof \ilHiddenInputGUI):
                        $is_hidden = true;
                        break;
                    case ($input instanceof \ilTextAreaInputGUI):
                        $is_ta = true;
                        break;
                    default:
                        throw new \ilException("Method " . get_class($input)
                            . "::render() does not exists! You cannot use this input-type in ilMultiLineInputGUI");
                }
            }
 
            $is_disabled_hook = $this->getHook(self::HOOK_IS_INPUT_DISABLED);
            if ($is_disabled_hook !== false && !$clean_render) {
                $input->setDisabled($is_disabled_hook($this->getValue()));
            }
            if ($this->getDisabled()) {
                $input->setDisabled(true);
            }
            if ($iterator_id == 0 && !isset($this->post_var_cache[$key])) {
                $this->post_var_cache[$key] = $input->getPostVar();
            } else {
                // Reset post var
                $input->setPostVar($this->post_var_cache[$key]);
            }
            $post_var = $this->createInputPostVar($iterator_id, $input);
            $input->setPostVar($post_var);
            $before_render_hook = $this->getHook(self::HOOK_BEFORE_INPUT_RENDER);
            if ($before_render_hook !== false && !$clean_render) {
                $input = $before_render_hook($this->getValue(), $key, $input);
            }
            switch (true) {
                case $is_hidden:
                    $tpl->setCurrentBlock('hidden');
                    $tpl->setVariable('NAME', $post_var);
                    $tpl->setVariable('VALUE', \ilUtil::prepareFormOutput($input->getValue()));
                    break;
                case $is_ta:
                    if ($this->isShowLabel() || ($this->isShowLabelOnce() && $first_label)) {
                        $tpl->setCurrentBlock('input_label');
                        $tpl->setVariable('LABEL', $input->getTitle());
                        $tpl->setVariable('CONTENT', $input->getHTML());
                        $tpl->parseCurrentBlock();
                        $first_label = false;
                    } else {
                        $tpl->setCurrentBlock('input');
                        $tpl->setVariable('CONTENT', $input->getHTML());
                    }
                    break;
                default:
                    if ($this->isShowLabel() || ($this->isShowLabelOnce() && $first_label)) {
                        $tpl->setCurrentBlock('input_label');
                        $tpl->setVariable('LABEL', $input->getTitle());
                        $tpl->setVariable('CONTENT', $input->render());
                        $first_label = false;
                    } else {
                        $tpl->setCurrentBlock('input');
                        $tpl->setVariable('CONTENT', $input->render());
                    }
                    break;
            }
            if ($this->isShowInfo()) {
                if ($this->isShowLabel()) {
                    $tpl->setCurrentBlock('input_info_label');
                    $tpl->setVariable('INFO_LABEL', $input->getInfo());
                    $tpl->parseCurrentBlock();
                } else {
                    $tpl->setCurrentBlock('input_info');
                    $tpl->setVariable('INFO', $input->getInfo());
                    $tpl->parseCurrentBlock();
                }
            }
            $tpl->parseCurrentBlock();
        }
        if ($this->getMulti() && !$this->getDisabled()) {
            $image_plus = xlvoGlyphGUI::get('plus');
            $show_remove = true;
            $is_removeable_hook = $this->getHook(self::HOOK_IS_LINE_REMOVABLE);
            if ($is_removeable_hook !== false && !$clean_render) {
                $show_remove = $is_removeable_hook($this->getValue());
            }
            $show_remove = true;
            $image_minus = ($show_remove) ? xlvoGlyphGUI::get('minus') : '<span class="glyphicon glyphicon-minus hide"></span>';
            $tpl->setCurrentBlock('multi_icons');
            $tpl->setVariable('IMAGE_PLUS', $image_plus);
            $tpl->setVariable('IMAGE_MINUS', $image_minus);
            $tpl->parseCurrentBlock();
            if ($this->isPositionMovable()) {
                $tpl->setCurrentBlock('multi_icons_move');
                $tpl->setVariable('IMAGE_UP', xlvoGlyphGUI::get(xlvoGlyphGUI::UP));
                $tpl->setVariable('IMAGE_DOWN', xlvoGlyphGUI::get(xlvoGlyphGUI::DOWN));
                $tpl->parseCurrentBlock();
            }
        }
 
        return $tpl->get();
    }

References $inputs, $tpl, $value, addCustomAttribute(), createInputPostVar(), ILIAS\GlobalScreen\get(), getCustomAttributes(), ilFormPropertyGUI\getDisabled(), getHook(), ilFormPropertyGUI\getMulti(), getValue(), isPositionMovable(), isShowInfo(), isShowLabel(), isShowLabelOnce(), and ilUtil\prepareFormOutput().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMulti()

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

Parameters

bool $a_multi

Reimplemented from ilFormPropertyGUI.

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

    {
        $this->multi = $a_multi;
    }

Referenced by __construct().

Here is the caller graph for this function:

◆ setPositionMovable()

ilOrgUnitMultiLineInputGUI::setPositionMovable ( $position_movable )

Parameters

boolean $position_movable

Definition at line 520 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $this->position_movable = $position_movable;
    }

References $position_movable.

◆ setShowInfo()

ilOrgUnitMultiLineInputGUI::setShowInfo ( $show_info )

Parameters

boolean $show_info

Definition at line 557 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $this->show_info = $show_info;
    }

References $show_info.

◆ setShowLabel()

ilOrgUnitMultiLineInputGUI::setShowLabel ( $show_label )

Parameters

boolean $show_label

Definition at line 168 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $this->show_label = $show_label;
    }

References $show_label.

Referenced by setShowLabelOnce().

Here is the caller graph for this function:

◆ setShowLabelOnce()

ilOrgUnitMultiLineInputGUI::setShowLabelOnce ( $show_label_once )

Parameters

boolean $show_label_once

Definition at line 538 of file class.ilOrgUnitMultiLineInputGUI.php.

    {
        $this->setShowLabel(false);
        $this->show_label_once = $show_label_once;
    }

References $show_label_once, and setShowLabel().

Here is the call graph for this function:

◆ setTemplateDir()

ilOrgUnitMultiLineInputGUI::setTemplateDir ( $template_dir )

Parameters

mixed $template_dir

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

    {
        $this->template_dir = $template_dir;
    }

References $template_dir.

◆ setValue()

ilOrgUnitMultiLineInputGUI::setValue ( $a_value )

Set Value.

Parameters

string $a_value Value

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

    {
        foreach ($this->inputs as $key => $item) {
            if (method_exists($item, 'setValue')) {
                $item->setValue($a_value[$key]);
            } elseif ($item instanceof \ilDateTimeInputGUI) {
                $item->setDate(new \ilDate($a_value[$key]['date'], IL_CAL_DATE));
            }
        }
        $this->value = $a_value;
    }

References IL_CAL_DATE.

Referenced by setValueByArray().

Here is the caller graph for this function:

◆ setValueByArray()

ilOrgUnitMultiLineInputGUI::setValueByArray ( $a_values )

Set value by array.

Parameters

array $a_values value array

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

    {
        $data = $a_values[$this->getPostVar()];
        if ($this->getMulti()) {
            $this->line_values = $data;
        } else {
            $this->setValue($data);
        }
    }