|
ILIAS
release_7 Revision v7.30-3-g800a261c036
|
special template class to simplify handling of ITX/PEAR More...
Inheritance diagram for ilTemplate:
Collaboration diagram for ilTemplate:Public Member Functions | |
| __construct (string $file, bool $flag1, bool $flag2, string $in_module="", string $vars="DEFAULT", bool $plugin=false, bool $a_use_cache=true) | |
| constructor ilTemplate constructor. More... | |
| blockExists ($a_blockname) | |
| check if block exists in actual template @access private More... | |
| get ($part="DEFAULT") | |
| getUnmodified ($part="DEFAULT") | |
| setCurrentBlock ($part="DEFAULT") | |
| Überladene Funktion, die sich hier lokal noch den aktuellen Block merkt. More... | |
| touchBlock ($block) | |
| overwrites ITX::touchBlock. More... | |
| parseCurrentBlock ($part="DEFAULT") | |
| Überladene Funktion, die auf den aktuelle Block vorher noch ein replace ausführt @access public. More... | |
| addBlockFile ($var, $block, $tplname, $in_module=false) | |
| overwrites ITX::addBlockFile @access public More... | |
| loadTemplatefile ( $filename, $removeUnknownVariables=true, $removeEmptyBlocks=true) | |
| Reads a template file from the disk. More... | |
| variableExists ($a_variablename) | |
Public Member Functions inherited from HTML_Template_ITX | |
| __construct ($root='') | |
| Builds some complex regexps and calls the constructor of the parent class. More... | |
| replaceBlock ($block, $template, $keep_content=false) | |
| Replaces an existing block with new content. More... | |
| replaceBlockfile ($block, $filename, $keep_content=false) | |
| Replaces an existing block with new content from a file. More... | |
| addBlock ($placeholder, $blockname, $template) | |
| Adds a block to the template changing a variable placeholder to a block placeholder. More... | |
| addBlockfile ($placeholder, $blockname, $filename) | |
| Adds a block taken from a file to the template changing a variable placeholder to a block placeholder. More... | |
| placeholderExists ($placeholder, $block='') | |
| Returns the name of the (first) block that contains the specified placeholder. More... | |
| performCallback () | |
| Checks the list of function calls in the template and calls their callback function. More... | |
| getFunctioncalls () | |
| Returns a list of all function calls in the current template. More... | |
| setFunctioncontent ($functionID, $replacement) | |
| Replaces a function call with the given replacement. More... | |
| setCallbackFunction ($tplfunction, $callbackfunction, $callbackobject='', $expandCallbackParameters=false) | |
| Sets a callback function. More... | |
| setCallbackFuntiontable ($functions) | |
| Sets the Callback function lookup table. More... | |
| removeBlockData ($block) | |
| Recursively removes all data assiciated with a block, including all inner blocks. More... | |
| getBlocklist () | |
| Returns a list of blocknames in the template. More... | |
| blockExists ($blockname) | |
| Checks wheter a block exists. More... | |
| getBlockvariables ($block) | |
| Returns a list of variables of a block. More... | |
| BlockvariableExists ($block, $variable) | |
| Checks wheter a block variable exists. More... | |
| buildFunctionlist () | |
| Builds a functionlist from the template. More... | |
| getValue ($code, $delimiter) | |
| Truncates the given code from the first occurence of $delimiter but ignores $delimiter enclosed by " or '. More... | |
| deleteFromBlockvariablelist ($block, $variables) | |
| Deletes one or many variables from the block variable list. More... | |
| updateBlockvariablelist ($block) | |
| Updates the variable list of a block. More... | |
| findPlaceholderBlocks ($variable) | |
| Returns an array of blocknames where the given variable placeholder is used. More... | |
| warning ($message, $file='', $line=0) | |
| Handles warnings, saves them to $warn and prints them or calls die() depending on the flags. More... | |
Public Member Functions inherited from HTML_Template_IT | |
| __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... | |
| 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 | |
| $vars | |
| $activeBlock | |
Data Fields inherited from HTML_Template_ITX | |
| $warn = array() | |
| $printWarning = false | |
| $haltOnWarning = false | |
| $checkblocknameRegExp = '' | |
| $functionPrefix = 'func_' | |
| $functionnameRegExp = '[_a-zA-Z]+[A-Za-z_0-9]*' | |
| $functionRegExp = '' | |
| $functions = array() | |
| $callback = array() | |
Data Fields inherited from HTML_Template_IT | |
| $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() | |
| $blockparents = 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... | |
Protected Member Functions | |
| init () | |
| Clears all datafields of the object and rebuild the internal blocklist. More... | |
| getTemplatePath ($a_tplname, $a_in_module=false, $a_plugin=false) | |
| builds a full template path with template and module name More... | |
| init () | |
| Clears all datafields of the object and rebuild the internal blocklist. More... | |
| init () | |
| Clears all datafields of the object and rebuild the internal blocklist. More... | |
Protected Attributes | |
| $il_use_cache | |
| $il_cur_key | |
| $tplName | |
| $tplPath | |
| $tplIdentifier | |
Static Protected Attributes | |
| static | $il_cache = array() |
Private Member Functions | |
| fillVars () | |
| all template vars defined in $vars will be replaced automatically without setting and parsing them with setVariable & parseCurrentBlock @access private More... | |
| getTemplateIdentifier ($a_tplname, $a_in_module=false) | |
| get a unique template identifier More... | |
special template class to simplify handling of ITX/PEAR
Definition at line 13 of file class.ilTemplate.php.
| ilTemplate::__construct | ( | string | $file, |
| bool | $flag1, | ||
| bool | $flag2, | ||
| string | $in_module = "", |
||
| string | $vars = "DEFAULT", |
||
| bool | $plugin = false, |
||
| bool | $a_use_cache = true |
||
| ) |
constructor ilTemplate constructor.
| string | $file | template file |
| bool | $flag1 | remove unknown variables |
| bool | $flag2 | remove empty blocks |
| string | $in_module | module/service subdirectory |
| string | $vars | variables to replace |
| bool | $plugin | plugin template |
| bool | $a_use_cache | us cache |
| ilTemplateException |
Definition at line 71 of file class.ilTemplate.php.
References XapiProxy\$plugin, $tplPath, ILIAS\GlobalScreen\Provider\__construct(), getTemplateIdentifier(), getTemplatePath(), loadTemplatefile(), and HTML_Template_IT\setOption().
Here is the call graph for this function:| ilTemplate::addBlockFile | ( | $var, | |
| $block, | |||
| $tplname, | |||
$in_module = false |
|||
| ) |
overwrites ITX::addBlockFile @access public
| string | ||
| string | ||
| string | $tplname | template name |
| boolean | $in_module | should be set to true, if template file is in module subdirectory |
Definition at line 279 of file class.ilTemplate.php.
References $DIC, XapiProxy\$resp, HTML_Template_IT\$template, HTML_Template_ITX\addBlock(), HTML_Template_IT\getFile(), ilPluginAdmin\getPluginObject(), getTemplateIdentifier(), getTemplatePath(), IL_COMP_SERVICE, and ilUIHookPluginGUI\KEEP.
Here is the call graph for this function:| ilTemplate::blockExists | ( | $a_blockname | ) |
check if block exists in actual template @access private
| string | blockname |
Reimplemented from HTML_Template_ITX.
Definition at line 154 of file class.ilTemplate.php.
References true.
Referenced by ilTinyMCE\handleImgContextMenuItem().
Here is the caller graph for this function:
|
private |
all template vars defined in $vars will be replaced automatically without setting and parsing them with setVariable & parseCurrentBlock @access private
Definition at line 323 of file class.ilTemplate.php.
References HTML_Template_IT\setVariable().
Referenced by parseCurrentBlock(), and touchBlock().
Here is the call graph for this function:
Here is the caller graph for this function:| ilTemplate::get | ( | $part = "DEFAULT" | ) |
| string |
Reimplemented from HTML_Template_IT.
Reimplemented in ilIndependantTemplate.
Definition at line 164 of file class.ilTemplate.php.
References $DIC, XapiProxy\$resp, ilPluginAdmin\getPluginObject(), getUnmodified(), IL_COMP_SERVICE, and ilUIHookPluginGUI\KEEP.
Here is the call graph for this function:
|
private |
get a unique template identifier
The identifier is common for default or customized skins but distincts templates of different services with the same name.
This is used by the UI plugin hook for template input/output
| string | $a_tplname | template name |
| string | $in_module | Component, e.g. "Modules/Forum" boolean $in_module or true, if component should be determined by ilCtrl |
Definition at line 482 of file class.ilTemplate.php.
References $_GET, $DIC, and ILIAS_MODULE.
Referenced by __construct(), and addBlockFile().
Here is the caller graph for this function:
|
protected |
builds a full template path with template and module name
| string | $a_tplname | template name |
| boolean | $in_module | should be set to true, if template file is in module subdirectory |
Definition at line 409 of file class.ilTemplate.php.
References $DIC, ilStyleDefinition\getCurrentSkin(), and ilStyleDefinition\getCurrentStyle().
Referenced by __construct(), and addBlockFile().
Here is the call graph for this function:
Here is the caller graph for this function:| ilTemplate::getUnmodified | ( | $part = "DEFAULT" | ) |
| string |
Definition at line 195 of file class.ilTemplate.php.
References $DIC, and ILIAS\GlobalScreen\get().
Referenced by get().
Here is the call graph for this function:
Here is the caller graph for this function:
|
protected |
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
Reimplemented from HTML_Template_ITX.
Definition at line 108 of file class.ilTemplate.php.
References HTML_Template_IT\$blockdata, HTML_Template_IT\$blockinner, HTML_Template_IT\$blocklist, HTML_Template_IT\$blockparents, HTML_Template_IT\$blockvariables, HTML_Template_IT\$err, HTML_Template_IT\$flagBlocktrouble, $il_cur_key, HTML_Template_IT\buildBlockvariablelist(), HTML_Template_ITX\buildFunctionlist(), HTML_Template_IT\findBlocks(), and HTML_Template_IT\free().
Here is the call graph for this function:| ilTemplate::loadTemplatefile | ( | $filename, | |
$removeUnknownVariables = true, |
|||
$removeEmptyBlocks = true |
|||
| ) |
Reads a template file from the disk.
overwrites IT:loadTemplateFile to include the template input hook
| string | name of the template file |
| bool | how to handle unknown variables. |
| bool | how to handle empty blocks. @access public |
Reimplemented from HTML_Template_IT.
Reimplemented in ilIndependantTemplate.
Definition at line 354 of file class.ilTemplate.php.
References $DIC, $filename, HTML_Template_IT\$removeEmptyBlocks, HTML_Template_IT\$removeUnknownVariables, XapiProxy\$resp, HTML_Template_IT\$template, HTML_Template_IT\getFile(), ilPluginAdmin\getPluginObject(), IL_COMP_SERVICE, ilUIHookPluginGUI\KEEP, and HTML_Template_IT\setTemplate().
Referenced by __construct().
Here is the call graph for this function:
Here is the caller graph for this function:| ilTemplate::parseCurrentBlock | ( | $part = "DEFAULT" | ) |
Überladene Funktion, die auf den aktuelle Block vorher noch ein replace ausführt @access public.
| string |
Definition at line 247 of file class.ilTemplate.php.
References $activeBlock, and fillVars().
Referenced by ilContainerRenderer\addHeaderRow(), ilContainerRenderer\addSeparatorRow(), ilContainerRenderer\addStandardRow(), ilCalendarBlockGUI\addSubscriptionButton(), ilChatroomAuthInputGUI\insert(), ilOrgUnitAuthorityInputGUI\insert(), ilCaptchaInputGUI\insert(), ilEMailInputGUI\insert(), ilClozeGapInputBuilderGUI\insert(), ilContainerRenderer\renderDetails(), ilContainerRenderer\renderHelperGeneric(), ilSurveyPageGUI\renderPageNode(), and ilContainerRenderer\renderSelectAllBlock().
Here is the call graph for this function:
Here is the caller graph for this function:| ilTemplate::setCurrentBlock | ( | $part = "DEFAULT" | ) |
Überladene Funktion, die sich hier lokal noch den aktuellen Block merkt.
@access public
| string |
Reimplemented from HTML_Template_IT.
Definition at line 213 of file class.ilTemplate.php.
Referenced by ilContainerRenderer\addHeaderRow(), ilContainerRenderer\addSeparatorRow(), ilContainerRenderer\addStandardRow(), ilCalendarBlockGUI\addSubscriptionButton(), ilChatroomAuthInputGUI\insert(), ilOrgUnitAuthorityInputGUI\insert(), ilCaptchaInputGUI\insert(), ilEMailInputGUI\insert(), ilClozeGapInputBuilderGUI\insert(), ilContainerRenderer\renderDetails(), ilContainerRenderer\renderHelperGeneric(), ilSurveyPageGUI\renderPageNode(), ilContainerRenderer\renderSelectAllBlock(), and touchBlock().
Here is the caller graph for this function:| ilTemplate::touchBlock | ( | $block | ) |
overwrites ITX::touchBlock.
@access public
| string |
Reimplemented from HTML_Template_IT.
Definition at line 230 of file class.ilTemplate.php.
References fillVars(), HTML_Template_IT\parseCurrentBlock(), and setCurrentBlock().
Referenced by ilContainerRenderer\addHeaderRow(), ilContainerRenderer\addStandardRow(), and ilSurveyPageGUI\renderPageNode().
Here is the call graph for this function:
Here is the caller graph for this function:| ilTemplate::variableExists | ( | $a_variablename | ) |
Definition at line 515 of file class.ilTemplate.php.
| ilTemplate::$activeBlock |
Definition at line 27 of file class.ilTemplate.php.
Referenced by parseCurrentBlock().
|
staticprotected |
Definition at line 32 of file class.ilTemplate.php.
|
protected |
Definition at line 42 of file class.ilTemplate.php.
Referenced by init().
|
protected |
Definition at line 37 of file class.ilTemplate.php.
|
protected |
Definition at line 57 of file class.ilTemplate.php.
|
protected |
Definition at line 47 of file class.ilTemplate.php.
|
protected |
Definition at line 52 of file class.ilTemplate.php.
Referenced by __construct().
| ilTemplate::$vars |
Definition at line 19 of file class.ilTemplate.php.