Inheritance diagram for HTML_Template_IT:

Collaboration diagram for HTML_Template_IT:

Public Member Functions
	__construct ($root='', $options=null)
	Builds some complex regular expressions and optinally sets the file root directory. More...

	setOption ($option, $value)
	Sets the option for the template class. More...

	setOptions ($options)
	Sets the options for the template class. More...

	show ($block='__global__')
	Print a certain block with all replacements done. More...

	get ($block='__global__')
	Returns a block with all replacements done. More...

	parse ($block='__global__', $flag_recursion=false)
	Parses the given block. More...

	parseCurrentBlock ()
	Parses the current block. More...

	setVariable ($variable, $value='')
	Sets a variable value. More...

	setCurrentBlock ($block='__global__')
	Sets the name of the current block that is the block where variables are added. More...

	touchBlock ($block)
	Preserves an empty block even if removeEmptyBlocks is true. More...

	init ()
	Clears all datafields of the object and rebuild the internal blocklist. More...

	free ()
	Clears all datafields of the object. More...

	setTemplate ( $template, $removeUnknownVariables=true, $removeEmptyBlocks=true)
	Sets the template. More...

	loadTemplatefile ( $filename, $removeUnknownVariables=true, $removeEmptyBlocks=true)
	Reads a template file from the disk. More...

	setRoot ($root)
	Sets the file root. More...

	buildBlockvariablelist ()
	Build a list of all variables within of a block. More...

	getGlobalvariables ()
	Returns a list of all global variables. More...

	findBlocks ($string)
	Recusively builds a list of all blocks within the template. More...

	getFile ($filename)
	Reads a file from disk and returns its content. More...

	_addPregDelimiters ($str)
	Adds delimiters to a string, so it can be used as a pattern in preg_* functions. More...

	_preserveOpeningDelimiter ($str)
	Replaces an opening delimiter by a special string. More...

	errorMessage ($value, $blockname='')
	Return a textual error message for a IT error code. More...

Data Fields
	$err = array()

	$clearCache = false

	$openingDelimiter = '{'

	$closingDelimiter = '}'

	$blocknameRegExp = '[\.0-9A-Za-z_-]+'

	$variablenameRegExp = '[\.0-9A-Za-z_-]+'

	$variablesRegExp = ''

	$removeVariablesRegExp = ''
	RegExp used to strip unused variable placeholder. More...

	$removeUnknownVariables = true

	$removeEmptyBlocks = true

	$blockRegExp = ''

	$currentBlock = '__global__'

	$template = ''

	$blocklist = array()

	$blockdata = array()

	$blockvariables = array()

	$blockinner = array()

	$touchedBlocks = array()
	List of blocks to preverse even if they are "empty". More...

	$_hiddenBlocks = array()
	List of blocks which should not be shown even if not "empty". More...

	$variableCache = array()

	$clearCacheOnParse = false

	$fileRoot = ''

	$flagBlocktrouble = false

	$flagGlobalParsed = false

	$flagCacheTemplatefile = true

	$lastTemplatefile = ''
	EXPERIMENTAL! FIXME! More...

	$_options
	$_options['preserve_data'] Whether to substitute variables and remove empty placeholders in data passed through setVariable (see also bugs #20199, #21951). More...

Detailed Description

Definition at line 124 of file IT.php.

Constructor & Destructor Documentation

◆ __construct()

HTML_Template_IT::__construct	(	$root = `''`,
		$options = `null`
	)

Builds some complex regular expressions and optinally sets the file root directory.

Make sure that you call this constructor if you derive your template class from this one.

Parameters

string File root directory, prefix for all filenames given to the object.

See also: setRoot()

Definition at line 370 of file IT.php.

    {
        if (!is_null($options)) {
            $this->setOptions($options);
        }
        $this->variablesRegExp = '@' . $this->openingDelimiter .
                                 '(' . $this->variablenameRegExp . ')' .
                                 $this->closingDelimiter . '@sm';
        $this->removeVariablesRegExp = '@' . $this->openingDelimiter .
                                       "\s*(" . $this->variablenameRegExp .
                                       ")\s*" . $this->closingDelimiter .'@sm';
 
        $this->blockRegExp = '@<!--\s+BEGIN\s+(' . $this->blocknameRegExp .
                             ')\s+-->(.*)<!--\s+END\s+\1\s+-->@sm';
 
        $this->setRoot($root);
    } // end constructor

References $options, setOptions(), and setRoot().

Here is the call graph for this function:

Member Function Documentation

◆ _addPregDelimiters()

HTML_Template_IT::_addPregDelimiters ( $str )

Adds delimiters to a string, so it can be used as a pattern in preg_* functions.

Parameters

string

Returns: string

Definition at line 950 of file IT.php.

    {
        return '@' . $str . '@';
    }

◆ _preserveOpeningDelimiter()

HTML_Template_IT::_preserveOpeningDelimiter ( $str )

Replaces an opening delimiter by a special string.

Parameters

string

Returns: string

Definition at line 961 of file IT.php.

    {
        return (false === strpos($str, $this->openingDelimiter))?
                $str:
                str_replace(
                    $this->openingDelimiter,
                    $this->openingDelimiter .
                    '%preserved%' . $this->closingDelimiter,
                    $str
                );
    }

◆ buildBlockvariablelist()

HTML_Template_IT::buildBlockvariablelist ( )

Build a list of all variables within of a block.

Definition at line 817 of file IT.php.

    {
        foreach ($this->blocklist as $name => $content) {
            preg_match_all($this->variablesRegExp, $content, $regs);
 
            if (count($regs[1]) != 0) {
                foreach ($regs[1] as $k => $var) {
                    $this->blockvariables[$name][$var] = true;
                }
            } else {
                $this->blockvariables[$name] = array();
            }
        }
    } // end func buildBlockvariablelist

Referenced by ilTemplate\init(), init(), HTML_Template_ITX\init(), and HTML_Template_ITX\replaceBlock().

Here is the caller graph for this function:

◆ errorMessage()

HTML_Template_IT::errorMessage	(	$value,
		$blockname = `''`
	)

Return a textual error message for a IT error code.

Parameters

integer $value error code

Returns: string error message, or false if the error code was not recognized

Definition at line 981 of file IT.php.

    {
        static $errorMessages;
        if (!isset($errorMessages)) {
            $errorMessages = array(
                IT_OK                       => '',
                IT_ERROR                    => 'unknown error',
                IT_TPL_NOT_FOUND            => 'Cannot read the template file',
                IT_BLOCK_NOT_FOUND          => 'Cannot find this block',
                IT_BLOCK_DUPLICATE          => 'The name of a block must be'.
                                               ' uniquewithin a template.'.
                                               ' Found "' . $blockname . '" twice.'.
                                               'Unpredictable results '.
                                               'may appear.',
                IT_UNKNOWN_OPTION           => 'Unknown option'
            );
        }
 
        return isset($errorMessages[$value]) ?
                $errorMessages[$value] : $errorMessages[IT_ERROR];
    }

References IT_BLOCK_DUPLICATE, IT_BLOCK_NOT_FOUND, IT_ERROR, IT_OK, IT_TPL_NOT_FOUND, and IT_UNKNOWN_OPTION.

Referenced by findBlocks(), get(), ilIndependentTemplate\get(), getFile(), ilIndependentTemplate\getFile(), parse(), setCurrentBlock(), setOption(), and touchBlock().

Here is the caller graph for this function:

◆ findBlocks()

HTML_Template_IT::findBlocks ( $string )

Recusively builds a list of all blocks within the template.

Parameters

string string that gets scanned

See also: $blocklist

Definition at line 858 of file IT.php.

    {
        $blocklist = array();
        if (preg_match_all($this->blockRegExp, $string, $regs, PREG_SET_ORDER)) {
            foreach ($regs as $k => $match) {
                $blockname         = $match[1];
                $blockcontent = $match[2];
 
                if (isset($this->blocklist[$blockname])) {
                    throw (new ilTemplateException($this->errorMessage(
                        IT_BLOCK_DUPLICATE, $blockname)));
                }
 
                $this->blocklist[$blockname] = $blockcontent;
                $this->blockdata[$blockname] = "";
 
                $blocklist[] = $blockname;
 
                $inner = $this->findBlocks($blockcontent);
                foreach ($inner as $k => $name) {
                    $pattern = sprintf(
                        '@<!--\s+BEGIN\s+%s\s+-->(.*)<!--\s+END\s+%s\s+-->@sm',
                        $name,
                        $name
                    );
 
                    $this->blocklist[$blockname] = preg_replace(
                                        $pattern,
                                        $this->openingDelimiter .
                                        '__' . $name . '__' .
                                        $this->closingDelimiter,
                                        $this->blocklist[$blockname]
                               );
                    $this->blockinner[$blockname][] = $name;
                    $this->blockparents[$name] = $blockname;
                }
            }
        }
 
        return $blocklist;
    } // end func findBlocks

References $blocklist, errorMessage(), findBlocks(), IT_BLOCK_DUPLICATE, and sprintf.

Referenced by HTML_Template_ITX\addBlock(), findBlocks(), ilTemplate\init(), init(), HTML_Template_ITX\init(), and HTML_Template_ITX\replaceBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ free()

HTML_Template_IT::free ( )

Clears all datafields of the object.

Don't use this function unless you know what you're doing.

@access public

See also: init()

Definition at line 714 of file IT.php.

    {
        $this->err = array();
 
        $this->currentBlock = '__global__';
 
        $this->variableCache    = array();
        $this->blocklist        = array();
        $this->touchedBlocks    = array();
 
        $this->flagBlocktrouble = false;
        $this->flagGlobalParsed = false;
    } // end func free

Referenced by ilTemplate\init(), init(), and HTML_Template_ITX\init().

Here is the caller graph for this function:

◆ get()

HTML_Template_IT::get ( $block = '__global__' )

Returns a block with all replacements done.

Parameters

string name of the block

Returns: string

Exceptions

ilTemplateException @access public

See also: show()

Reimplemented in ilIndependentTemplate, and ilTemplate.

Definition at line 447 of file IT.php.

    {
        if ($block == '__global__'  && !$this->flagGlobalParsed) {
            $this->parse('__global__');
        }
 
        if (!isset($this->blocklist[$block])) {
            throw (new ilTemplateException($this->errorMessage(IT_BLOCK_NOT_FOUND) .
                '"' . $block . "'"));
        }
 
        if (isset($this->blockdata[$block])) {
            $ret = $this->blockdata[$block];
            if ($this->clearCache) {
                unset($this->blockdata[$block]);
            }
            if ($this->_options['preserve_data']) {
                $ret = str_replace(
                        $this->openingDelimiter .
                        '%preserved%' . $this->closingDelimiter,
                        $this->openingDelimiter,
                        $ret
                    );
            }
            return $ret;
        }
 
        return '';
    } // end func get()

References $ret, errorMessage(), IT_BLOCK_NOT_FOUND, and parse().

Here is the call graph for this function:

◆ getFile()

HTML_Template_IT::getFile ( $filename )

Reads a file from disk and returns its content.

Parameters

string Filename

Returns: string Filecontent

Reimplemented in ilIndependentTemplate.

Definition at line 905 of file IT.php.

    {
        if ($filename{0} == '/' && substr($this->fileRoot, -1) == '/') {
            $filename = substr($filename, 1);
        }
 
        $filename = $this->fileRoot . $filename;
 
        require_once('./Services/GlobalCache/classes/class.ilGlobalCache.php');
        $this->real_filename = $filename;
        $ilGlobalCache = ilGlobalCache::getInstance(ilGlobalCache::COMP_TEMPLATE);
        if(!$content = $ilGlobalCache->get($filename)) {
            if (!($fh = @fopen($filename, 'r'))) {
                throw (new ilTemplateException($this->errorMessage(IT_TPL_NOT_FOUND) .
                    ': "' .$filename .'"'));
            }
 
            $fsize = filesize($filename);
            if ($fsize < 1) {
                fclose($fh);
                return '';
            }
 
            $content = fread($fh, $fsize);
            $ilGlobalCache->set($filename, $content, 60);
            fclose($fh);
        }
 
 
        return preg_replace_callback(
            "#<!-- INCLUDE (.*) -->#im",
            function ($hit) {
                return $this->getFile($hit[1]);
            },
            $content
        );
    } // end func getFile

References $fh, $filename, ilGlobalCache\COMP_TEMPLATE, errorMessage(), getFile(), ilGlobalCache\getInstance(), and IT_TPL_NOT_FOUND.

Referenced by HTML_Template_ITX\addBlockfile(), ilTemplate\addBlockFile(), getFile(), ilTemplate\loadTemplatefile(), loadTemplatefile(), and HTML_Template_ITX\replaceBlockfile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGlobalvariables()

HTML_Template_IT::getGlobalvariables ( )

Returns a list of all global variables.

Definition at line 835 of file IT.php.

    {
        $regs   = array();
        $values = array();
 
        foreach ($this->blockvariables['__global__'] as $allowedvar => $v) {
            if (isset($this->variableCache[$allowedvar])) {
                $regs[]   = '@' . $this->openingDelimiter .
                            $allowedvar . $this->closingDelimiter . '@';
                $values[] = $this->variableCache[$allowedvar];
                unset($this->variableCache[$allowedvar]);
            }
        }
 
        return array($regs, $values);
    } // end func getGlobalvariables

◆ init()

HTML_Template_IT::init ( )

Clears all datafields of the object and rebuild the internal blocklist.

LoadTemplatefile() and setTemplate() automatically call this function when a new template is given. Don't use this function unless you know what you're doing.

@access public

See also: free()

Reimplemented in ilTemplate, and HTML_Template_ITX.

Definition at line 677 of file IT.php.

    {
        $this->free();
        require_once('./Services/GlobalCache/classes/class.ilGlobalCache.php');
        $blocks = ilGlobalCache::getInstance(ilGlobalCache::COMP_TPL_BLOCKS);
 
        if ($blockdata = $blocks->get($this->real_filename)) {
            $this->blockdata = $blockdata['blockdata'];
            $this->blocklist = $blockdata['blocklist'];
        } else {
            ilGlobalCache::log('have to build blocks...', ilGlobalCacheSettings::LOG_LEVEL_FORCED);
            $this->findBlocks($this->template);
            $blockdata['blockdata'] = $this->blockdata;
            $blockdata['blocklist'] = $this->blocklist;
            $blocks->set($this->real_filename, $blockdata, 60);
        }
 
        // we don't need it any more
        $this->template = '';
 
        $variables = ilGlobalCache::getInstance(ilGlobalCache::COMP_TPL_VARIABLES);
        if ($blockvariables = $variables->get($this->real_filename)) {
            $this->blockvariables = $blockvariables;
        } else {
            $this->buildBlockvariablelist();
            $variables->set($this->real_filename, $this->blockvariables, 60);
        }
    } // end func init

References $blockdata, $blocklist, $blockvariables, buildBlockvariablelist(), ilGlobalCache\COMP_TPL_BLOCKS, ilGlobalCache\COMP_TPL_VARIABLES, findBlocks(), free(), ilGlobalCache\getInstance(), ilGlobalCache\log(), and ilGlobalCacheSettings\LOG_LEVEL_FORCED.

Referenced by setTemplate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadTemplatefile()

HTML_Template_IT::loadTemplatefile	(	$filename,
		$removeUnknownVariables = `true`,
		$removeEmptyBlocks = `true`
	)

Reads a template file from the disk.

Parameters

string	name of the template file
bool	how to handle unknown variables.
bool	how to handle empty blocks. @access public

Returns: boolean false on failure, otherwise true

See also: $template, setTemplate(), $removeUnknownVariables, $removeEmptyBlocks

Reimplemented in ilTemplate, and ilIndependentTemplate.

Definition at line 776 of file IT.php.

    {
        $template = '';
        if (!$this->flagCacheTemplatefile ||
            $this->lastTemplatefile != $filename
        ) {
            $template = $this->getFile($filename);
        }
        $this->lastTemplatefile = $filename;
 
        return $template != '' ?
                $this->setTemplate(
                        $template,$removeUnknownVariables, $removeEmptyBlocks
                    ) : false;
    } // end func LoadTemplatefile

References $filename, $removeEmptyBlocks, $removeUnknownVariables, $template, getFile(), and setTemplate().

Referenced by ilIndependentTemplate\loadTemplatefile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parse()

HTML_Template_IT::parse	(	$block = `'__global__'`,
		$flag_recursion = `false`
	)

Parses the given block.

Parameters

string name of the block to be parsed @access public

See also: parseCurrentBlock()

Exceptions

ilTemplateException

Definition at line 485 of file IT.php.

    {
        static $regs, $values;
 
        if (!isset($this->blocklist[$block])) {
            throw (new ilTemplateException($this->errorMessage(IT_BLOCK_NOT_FOUND) .
                '"' . $block . "'"));
        }
 
        if ($block == '__global__') {
            $this->flagGlobalParsed = true;
        }
 
        if (!$flag_recursion) {
            $regs   = array();
            $values = array();
        }
        $outer = $this->blocklist[$block];
        $empty = true;
 
        if ($this->clearCacheOnParse) {
            foreach ($this->variableCache as $name => $value) {
                $regs[] = $this->openingDelimiter .
                          $name . $this->closingDelimiter;
                $values[] = $value;
                $empty = false;
            }
            $this->variableCache = array();
        } else {
            foreach ($this->blockvariables[$block] as $allowedvar => $v) {
 
                if (isset($this->variableCache[$allowedvar])) {
                   $regs[]   = $this->openingDelimiter .
                               $allowedvar . $this->closingDelimiter;
                   $values[] = $this->variableCache[$allowedvar];
                   unset($this->variableCache[$allowedvar]);
                   $empty = false;
                }
            }
        }
 
        if (isset($this->blockinner[$block])) {
            foreach ($this->blockinner[$block] as $k => $innerblock) {
 
                $this->parse($innerblock, true);
                if ($this->blockdata[$innerblock] != '') {
                    $empty = false;
                }
 
                $placeholder = $this->openingDelimiter . "__" .
                                $innerblock . "__" . $this->closingDelimiter;
                $outer = str_replace(
                                    $placeholder,
                                    $this->blockdata[$innerblock], $outer
                        );
                $this->blockdata[$innerblock] = "";
            }
 
        }
 
        if (!$flag_recursion && 0 != count($values)) {
            if ($this->_options['use_preg']) {
                $regs        = array_map(array(
                                    &$this, '_addPregDelimiters'),
                                    $regs
                                );
                $funcReplace = 'preg_replace';
            } else {
                $funcReplace = 'str_replace';
            }
 
            if ($this->_options['preserve_data']) {
                $values = array_map(
                            array(&$this, '_preserveOpeningDelimiter'), $values
                        );
            }
 
            $outer = $funcReplace($regs, $values, $outer);
 
            if ($this->removeUnknownVariables) {
                $outer = preg_replace($this->removeVariablesRegExp, "", $outer);
            }
        }
 
        if ($empty) {
            if (!$this->removeEmptyBlocks) {
                $this->blockdata[$block ].= $outer;
            } else {
                if (isset($this->touchedBlocks[$block])) {
                    $this->blockdata[$block] .= $outer;
                    unset($this->touchedBlocks[$block]);
                }
            }
        } else {
            if (empty($this->blockdata[$block])) {
                $this->blockdata[$block] = $outer;
            } else {
                $this->blockdata[$block] .= $outer;
            }
        }
 
        return $empty;
    } // end func parse

References $closingDelimiter, errorMessage(), IT_BLOCK_NOT_FOUND, and parse().

Referenced by get(), ilIndependentTemplate\get(), parse(), and parseCurrentBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parseCurrentBlock()

HTML_Template_IT::parseCurrentBlock ( )

Parses the current block.

See also: parse(), setCurrentBlock(), $currentBlock @access User interface

Definition at line 594 of file IT.php.

    {
        return $this->parse($this->currentBlock);
    } // end func parseCurrentBlock

References parse().

Referenced by ilTemplate\fillAdminPanel(), ilTemplate\fillBodyClass(), ilTemplate\fillContentStyle(), ilTemplate\fillCssFiles(), ilTemplate\fillHeader(), ilTemplate\fillInlineCss(), ilTemplate\fillJavascriptFile(), ilTemplate\fillJavaScriptFiles(), ilTemplate\fillLeftContent(), ilTemplate\fillLeftNav(), ilTemplate\fillOnLoadCode(), ilTemplate\fillPageFormAction(), ilTemplate\fillRightContent(), ilTemplate\fillSideIcons(), ilTemplate\fillToolbar(), ilTemplate\get(), ilTemplate\replaceFromDatabase(), ilTemplate\setBanner(), ilTemplate\setCenterColumnClass(), ilTemplate\show(), and ilTemplate\touchBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setCurrentBlock()

HTML_Template_IT::setCurrentBlock ( $block = '__global__' )

Sets the name of the current block that is the block where variables are added.

Parameters

string name of the block

Returns: boolean false on failure, otherwise true

Exceptions

ilTemplateException @access public

Reimplemented in ilTemplate, and ilTemplate.

Definition at line 633 of file IT.php.

    {
 
        if (!isset($this->blocklist[$block])) {
            throw (new ilTemplateException($this->errorMessage(IT_BLOCK_NOT_FOUND) .
                '"' . $block . "'"));
        }
 
        $this->currentBlock = $block;
 
        return true;
    } // end func setCurrentBlock

References errorMessage(), and IT_BLOCK_NOT_FOUND.

Here is the call graph for this function:

◆ setOption()

HTML_Template_IT::setOption	(	$option,
		$value
	)

Sets the option for the template class.

@access public

Parameters

string	option name
mixed	option value

Returns: mixed IT_OK on success, error object on failure

Definition at line 397 of file IT.php.

    {
        if (array_key_exists($option, $this->_options)) {
            $this->_options[$option] = $value;
            return IT_OK;
        }
        throw (new ilTemplateException($this->errorMessage(IT_UNKNOWN_OPTION) . ": '{$option}'"));
    }

References errorMessage(), IT_OK, and IT_UNKNOWN_OPTION.

Referenced by ilTemplate\__construct(), and setOptions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setOptions()

HTML_Template_IT::setOptions ( $options )

Sets the options for the template class.

@access public

Parameters

string	options array of options default value: 'preserve_data' => false, 'use_preg' => true
mixed	option value

Returns: mixed IT_OK on success, error object on failure

See also: $options

Definition at line 418 of file IT.php.

    {
        if (is_array($options)) {
            foreach ($options as $option => $value) {
                $error = $this->setOption($option, $value);
            }
        }
 
        return IT_OK;
    }

References $error, $options, IT_OK, and setOption().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setRoot()

HTML_Template_IT::setRoot ( $root )

Sets the file root.

The file root gets prefixed to all filenames passed to the object.

Make sure that you override this function when using the class on windows.

Parameters

string

See also: HTML_Template_IT() @access User interface

Definition at line 805 of file IT.php.

    {
        if ($root != '' && substr($root, -1) != '/') {
            $root .= '/';
        }
 
        $this->fileRoot = $root;
    } // end func setRoot

Referenced by __construct().

Here is the caller graph for this function:

◆ setTemplate()

HTML_Template_IT::setTemplate	(	$template,
		$removeUnknownVariables = `true`,
		$removeEmptyBlocks = `true`
	)

Sets the template.

You can eighter load a template file from disk with LoadTemplatefile() or set the template manually using this function.

Parameters

string	template content
boolean	remove unknown/unused variables?
boolean	remove empty blocks?

See also: LoadTemplatefile(), $template @access User interface

Returns: boolean

Definition at line 741 of file IT.php.

    {
        $this->removeUnknownVariables = $removeUnknownVariables;
        $this->removeEmptyBlocks = $removeEmptyBlocks;
 
        if ($template == '' && $this->flagCacheTemplatefile) {
            $this->variableCache = array();
            $this->blockdata = array();
            $this->touchedBlocks = array();
            $this->currentBlock = '__global__';
        } else {
            $this->template = '<!-- BEGIN __global__ -->' . $template .
                              '<!-- END __global__ -->';
            $this->init();
        }
 
        if ($this->flagBlocktrouble) {
            return false;
        }
 
        return true;
    } // end func setTemplate

References $removeEmptyBlocks, $removeUnknownVariables, $template, and init().

Referenced by ilTemplate\loadTemplatefile(), and loadTemplatefile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setVariable()

HTML_Template_IT::setVariable	(	$variable,
		$value = `''`
	)

Sets a variable value.

The function can be used eighter like setVariable( "varname", "value") or with one array $variables["varname"] = "value" given setVariable($variables) quite like phplib templates set_var().

Parameters

mixed	string with the variable name or an array variables["varname"] = "value"
string	value of the variable or empty if $variable is an array.
string	prefix for variable names @access public

Definition at line 613 of file IT.php.

    {
        if (is_array($variable)) {
            $this->variableCache = array_merge(
                                            $this->variableCache, $variable
                                    );
        } else {
            $this->variableCache[$variable] = $value;
        }
    } // end func setVariable

Referenced by ilContainerRenderer\addHeaderRow(), ilTemplate\addILIASFooter(), ilContainerRenderer\addStandardRow(), ilTemplate\fillAdminPanel(), ilTemplate\fillBodyClass(), ilTemplate\fillContentLanguage(), ilTemplate\fillContentStyle(), ilTemplate\fillCssFiles(), ilTemplate\fillHeader(), ilTemplate\fillInlineCss(), ilTemplate\fillJavascriptFile(), ilTemplate\fillJavaScriptFiles(), ilTemplate\fillLeftContent(), ilTemplate\fillLeftNav(), ilTemplate\fillLightbox(), ilTemplate\fillMainContent(), ilTemplate\fillMessage(), ilTemplate\fillNewContentStyle(), ilTemplate\fillOnLoadCode(), ilTemplate\fillPageFormAction(), ilTemplate\fillPermanentLink(), ilTemplate\fillRightContent(), ilTemplate\fillSideIcons(), ilTemplate\fillTabs(), ilTemplate\fillToolbar(), ilTemplate\fillVars(), ilTemplate\fillWindowTitle(), ilChatroomAuthInputGUI\insert(), ilCaptchaInputGUI\insert(), ilEMailInputGUI\insert(), ilClozeGapInputBuilderGUI\insert(), ilAssLacLegendGUI\populateVisibilityCss(), ilContainerRenderer\renderDetails(), ilChatroomViewGUI\renderFileUploadForm(), ilSurveyPageGUI\renderPageNode(), ilContainerRenderer\renderSelectAllBlock(), ilTemplate\replace(), ilTemplate\setBackgroundColor(), ilTemplate\setBanner(), ilTemplate\setCenterColumnClass(), ilTemplate\setLocator(), ilTemplate\setNewContentStyleSheetLocation(), ilTemplate\setStyleSheetLocation(), ilTemplate\setSubTabs(), ilTemplate\setTabs(), and ilTemplate\show().

Here is the caller graph for this function:

◆ show()

HTML_Template_IT::show ( $block = '__global__' )

Print a certain block with all replacements done.

@brother get()

Reimplemented in ilTemplate.

Definition at line 433 of file IT.php.

    {
        print $this->get($block);
    } // end func show

References print.

◆ touchBlock()

HTML_Template_IT::touchBlock ( $block )

Preserves an empty block even if removeEmptyBlocks is true.

Parameters

string name of the block

Returns: boolean false on false, otherwise true

Exceptions

ilTemplateException @access public

See also: $removeEmptyBlocks

Reimplemented in ilTemplate, and ilTemplate.

Definition at line 655 of file IT.php.

    {
        if (!isset($this->blocklist[$block])) {
            throw (new ilTemplateException($this->errorMessage(IT_BLOCK_NOT_FOUND) .
                '"' . $block . "'"));
        }
 
        $this->touchedBlocks[$block] = true;
 
        return true;
    } // end func touchBlock

References errorMessage(), and IT_BLOCK_NOT_FOUND.

Here is the call graph for this function:

Field Documentation

◆ $_hiddenBlocks

array HTML_Template_IT::$_hiddenBlocks = array()

List of blocks which should not be shown even if not "empty".

See also: hideBlock(), $removeEmptyBlocks

Definition at line 282 of file IT.php.

◆ $_options

HTML_Template_IT::$_options

Initial value:

= array(
        'preserve_data' => false,
        'use_preg'      => true
    )

$_options['preserve_data'] Whether to substitute variables and remove empty placeholders in data passed through setVariable (see also bugs #20199, #21951).

$_options['use_preg'] Whether to use preg_replace instead of str_replace in parse() (this is a backwards compatibility feature, see also bugs #21951, #20392)

Definition at line 354 of file IT.php.

◆ $blockdata

HTML_Template_IT::$blockdata = array()

Definition at line 236 of file IT.php.

Referenced by ilTemplate\init(), init(), and HTML_Template_ITX\replaceBlock().

◆ $blockinner

HTML_Template_IT::$blockinner = array()

Definition at line 248 of file IT.php.

Referenced by ilTemplate\init().

◆ $blocklist

HTML_Template_IT::$blocklist = array()

Definition at line 229 of file IT.php.

Referenced by findBlocks(), HTML_Template_ITX\getBlocklist(), ilTemplate\init(), and init().

◆ $blocknameRegExp

HTML_Template_IT::$blocknameRegExp = '[\.0-9A-Za-z_-]+'

Definition at line 164 of file IT.php.

◆ $blockRegExp

HTML_Template_IT::$blockRegExp = ''

Definition at line 209 of file IT.php.

◆ $blockvariables

HTML_Template_IT::$blockvariables = array()

Definition at line 242 of file IT.php.

Referenced by ilTemplate\init(), and init().

◆ $clearCache

HTML_Template_IT::$clearCache = false

Definition at line 138 of file IT.php.

◆ $clearCacheOnParse

HTML_Template_IT::$clearCacheOnParse = false

Definition at line 305 of file IT.php.

◆ $closingDelimiter

HTML_Template_IT::$closingDelimiter = '}'

Definition at line 154 of file IT.php.

Referenced by HTML_Template_ITX\buildFunctionlist(), and parse().

◆ $currentBlock

HTML_Template_IT::$currentBlock = '__global__'

Definition at line 215 of file IT.php.

◆ $err

HTML_Template_IT::$err = array()

Definition at line 132 of file IT.php.

Referenced by ilTemplate\init().

◆ $fileRoot

HTML_Template_IT::$fileRoot = ''

Definition at line 313 of file IT.php.

◆ $flagBlocktrouble

HTML_Template_IT::$flagBlocktrouble = false

Definition at line 319 of file IT.php.

Referenced by ilTemplate\init().

◆ $flagCacheTemplatefile

HTML_Template_IT::$flagCacheTemplatefile = true

Definition at line 339 of file IT.php.

◆ $flagGlobalParsed

HTML_Template_IT::$flagGlobalParsed = false

Definition at line 325 of file IT.php.

◆ $lastTemplatefile

HTML_Template_IT::$lastTemplatefile = ''

EXPERIMENTAL! FIXME!

Definition at line 344 of file IT.php.

◆ $openingDelimiter

HTML_Template_IT::$openingDelimiter = '{'

Definition at line 146 of file IT.php.

◆ $removeEmptyBlocks

HTML_Template_IT::$removeEmptyBlocks = true

Definition at line 202 of file IT.php.

Referenced by ilTemplate\loadTemplatefile(), loadTemplatefile(), ilIndependentTemplate\loadTemplatefile(), and setTemplate().

◆ $removeUnknownVariables

HTML_Template_IT::$removeUnknownVariables = true

Definition at line 195 of file IT.php.

Referenced by ilTemplate\loadTemplatefile(), loadTemplatefile(), ilIndependentTemplate\loadTemplatefile(), and setTemplate().

◆ $removeVariablesRegExp

HTML_Template_IT::$removeVariablesRegExp = ''

RegExp used to strip unused variable placeholder.

@brother $variablesRegExp

Definition at line 188 of file IT.php.

◆ $template

HTML_Template_IT::$template = ''

Definition at line 221 of file IT.php.

Referenced by HTML_Template_ITX\addBlock(), ilTemplate\addBlockFile(), HTML_Template_ITX\buildFunctionlist(), ilTemplate\loadTemplatefile(), loadTemplatefile(), HTML_Template_ITX\replaceBlock(), and setTemplate().

◆ $touchedBlocks

array HTML_Template_IT::$touchedBlocks = array()

List of blocks to preverse even if they are "empty".

This is something special. Sometimes you have blocks that should be preserved although they are empty (no placeholder replaced). Think of a shopping basket. If it's empty you have to drop a message to the user. If it's filled you have to show the contents of the shopping baseket. Now where do you place the message that the basket is empty? It's no good idea to place it in you applications as customers tend to like unecessary minor text changes. Having another template file for an empty basket means that it's very likely that one fine day the filled and empty basket templates have different layout. I decided to introduce blocks that to not contain any placeholder but only text such as the message "Your shopping basked is empty".

Now if there is no replacement done in such a block the block will be recognized as "empty" and by default ($removeEmptyBlocks = true) be stripped off. To avoid thisyou can now call touchBlock() to avoid this.

The array $touchedBlocks stores a list of touched block which must not be removed even if they are empty.

See also: touchBlock(), $removeEmptyBlocks

Definition at line 275 of file IT.php.

◆ $variableCache

HTML_Template_IT::$variableCache = array()

Definition at line 294 of file IT.php.

◆ $variablenameRegExp

HTML_Template_IT::$variablenameRegExp = '[\.0-9A-Za-z_-]+'

Definition at line 174 of file IT.php.

◆ $variablesRegExp

HTML_Template_IT::$variablesRegExp = ''

Definition at line 182 of file IT.php.

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

Services/UICore/lib/html-it/IT.php

Public Member Functions

Data Fields

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _addPregDelimiters()

◆ _preserveOpeningDelimiter()

◆ buildBlockvariablelist()

◆ errorMessage()

◆ findBlocks()

◆ free()

◆ get()

◆ getFile()

◆ getGlobalvariables()

◆ init()

◆ loadTemplatefile()

◆ parse()

◆ parseCurrentBlock()

◆ setCurrentBlock()

◆ setOption()

◆ setOptions()

◆ setRoot()

◆ setTemplate()

◆ setVariable()

◆ show()

◆ touchBlock()

Field Documentation

◆ $_hiddenBlocks

◆ $_options

◆ $blockdata

◆ $blockinner

◆ $blocklist

◆ $blocknameRegExp

◆ $blockRegExp

◆ $blockvariables

◆ $clearCache

◆ $clearCacheOnParse

◆ $closingDelimiter

◆ $currentBlock

◆ $err

◆ $fileRoot

◆ $flagBlocktrouble

◆ $flagCacheTemplatefile

◆ $flagGlobalParsed

◆ $lastTemplatefile

◆ $openingDelimiter

◆ $removeEmptyBlocks

◆ $removeUnknownVariables

◆ $removeVariablesRegExp

◆ $template

◆ $touchedBlocks

◆ $variableCache

◆ $variablenameRegExp

◆ $variablesRegExp