ILIAS
release_7 Revision v7.30-3-g800a261c036
|
special template class to simplify handling of ITX/PEAR More...
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 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 public. More... | |
addBlockFile ($var, $block, $tplname, $in_module=false) | |
overwrites ITX::addBlockFile public More... | |
loadTemplatefile ( $filename, $removeUnknownVariables=true, $removeEmptyBlocks=true) | |
Reads a template file from the disk. More... | |
variableExists ($a_variablename) | |
![]() | |
__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... | |
![]() | |
__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 | |
![]() | |
$warn = array() | |
$printWarning = false | |
$haltOnWarning = false | |
$checkblocknameRegExp = '' | |
$functionPrefix = 'func_' | |
$functionnameRegExp = '[_a-zA-Z]+[A-Za-z_0-9]*' | |
$functionRegExp = '' | |
$functions = array() | |
$callback = array() | |
![]() | |
$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 () | |
getTemplatePath ($a_tplname, $a_in_module=false, $a_plugin=false) | |
builds a full template path with template and module name More... | |
![]() | |
init () | |
![]() | |
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 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().
ilTemplate::addBlockFile | ( | $var, | |
$block, | |||
$tplname, | |||
$in_module = false |
|||
) |
overwrites ITX::addBlockFile 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.
ilTemplate::blockExists | ( | $a_blockname | ) |
check if block exists in actual template private
string | blockname |
Definition at line 154 of file class.ilTemplate.php.
Referenced by ilTinyMCE\handleImgContextMenuItem().
|
private |
all template vars defined in $vars will be replaced automatically without setting and parsing them with setVariable & parseCurrentBlock private
Definition at line 323 of file class.ilTemplate.php.
References HTML_Template_IT\setVariable().
Referenced by parseCurrentBlock(), and touchBlock().
ilTemplate::get | ( | $part = "DEFAULT" | ) |
string |
Definition at line 164 of file class.ilTemplate.php.
References $DIC, XapiProxy\$resp, ilPluginAdmin\getPluginObject(), getUnmodified(), IL_COMP_SERVICE, and ilUIHookPluginGUI\KEEP.
|
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().
|
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().
ilTemplate::getUnmodified | ( | $part = "DEFAULT" | ) |
string |
Definition at line 195 of file class.ilTemplate.php.
References $DIC, and ILIAS\GlobalScreen\get().
Referenced by get().
|
protected |
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().
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. public |
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().
ilTemplate::parseCurrentBlock | ( | $part = "DEFAULT" | ) |
Überladene Funktion, die auf den aktuelle Block vorher noch ein replace ausführt public.
string |
Definition at line 247 of file class.ilTemplate.php.
References $activeBlock, and fillVars().
Referenced by ilMDEditorGUI\__fillSubelements(), ilContainerRenderer\addHeaderRow(), ilExerciseGSToolProvider\addSection(), ilContainerRenderer\addSeparatorRow(), ilContainerRenderer\addStandardRow(), ilCalendarBlockGUI\addSubscriptionButton(), ilOrgUnitAuthorityInputGUI\insert(), ilChatroomAuthInputGUI\insert(), ilEMailInputGUI\insert(), ilCaptchaInputGUI\insert(), ilClozeGapInputBuilderGUI\insert(), ilSCORMExplorer\insertObject(), ilTestQuestionNavigationGUI\parseButtonsBlock(), ilTestQuestionNavigationGUI\parseNavigation(), ilAssQuestionPreviewGUI\populateGenericQuestionFeedback(), ilAssQuestionPreviewGUI\populateInstantResponseHeader(), ilAssQuestionPreviewGUI\populateInstantResponseMessage(), ilAssQuestionPreviewGUI\populateNotesPanel(), ilAssQuestionPreviewGUI\populateReachedPointsOutput(), ilAssQuestionPreviewGUI\populateSolutionOutput(), ilAssQuestionPreviewGUI\populateSpecificQuestionFeedback(), ilTestQuestionNavigationGUI\renderActionsIcon(), ilTestQuestionNavigationGUI\renderButtonInstance(), ilAssLacLegendGUI\renderCommonLegendPart(), ilContainerRenderer\renderDetails(), ilObjForumGUI\renderDraftContent(), ilAssLacLegendGUI\renderExample(), ilContainerRenderer\renderHelperGeneric(), ilTestQuestionNavigationGUI\renderIcon(), ilSurveyPageGUI\renderPageNode(), ilObjForumGUI\renderPostContent(), ilAssLacLegendGUI\renderQuestSpecificLegendPart(), and ilContainerRenderer\renderSelectAllBlock().
ilTemplate::setCurrentBlock | ( | $part = "DEFAULT" | ) |
Überladene Funktion, die sich hier lokal noch den aktuellen Block merkt.
public
string |
Definition at line 213 of file class.ilTemplate.php.
Referenced by ilMDEditorGUI\__fillSubelements(), ilContainerRenderer\addHeaderRow(), ilExerciseGSToolProvider\addSection(), ilContainerRenderer\addSeparatorRow(), ilContainerRenderer\addStandardRow(), ilCalendarBlockGUI\addSubscriptionButton(), ilOrgUnitAuthorityInputGUI\insert(), ilChatroomAuthInputGUI\insert(), ilEMailInputGUI\insert(), ilCaptchaInputGUI\insert(), ilClozeGapInputBuilderGUI\insert(), ilSCORMExplorer\insertObject(), ilTestQuestionNavigationGUI\parseButtonsBlock(), ilTestQuestionNavigationGUI\parseNavigation(), ilAssQuestionPreviewGUI\populateGenericQuestionFeedback(), ilAssQuestionPreviewGUI\populateInstantResponseHeader(), ilAssQuestionPreviewGUI\populateInstantResponseMessage(), ilAssQuestionPreviewGUI\populateNotesPanel(), ilAssQuestionPreviewGUI\populateReachedPointsOutput(), ilAssQuestionPreviewGUI\populateSolutionOutput(), ilAssQuestionPreviewGUI\populateSpecificQuestionFeedback(), ilTestQuestionNavigationGUI\renderActionsIcon(), ilTestQuestionNavigationGUI\renderButtonInstance(), ilAssLacLegendGUI\renderCommonLegendPart(), ilContainerRenderer\renderDetails(), ilObjForumGUI\renderDraftContent(), ilAssLacLegendGUI\renderExample(), ilContainerRenderer\renderHelperGeneric(), ilTestQuestionNavigationGUI\renderIcon(), ilSurveyPageGUI\renderPageNode(), ilObjForumGUI\renderPostContent(), ilAssLacLegendGUI\renderQuestSpecificLegendPart(), ilContainerRenderer\renderSelectAllBlock(), ilObjForumGUI\renderSplitButton(), and touchBlock().
ilTemplate::touchBlock | ( | $block | ) |
overwrites ITX::touchBlock.
public
string |
Definition at line 230 of file class.ilTemplate.php.
References fillVars(), HTML_Template_IT\parseCurrentBlock(), and setCurrentBlock().
Referenced by ilContainerRenderer\addHeaderRow(), ilContainerRenderer\addStandardRow(), ilTinyMCE\handleImgContextMenuItem(), and ilSurveyPageGUI\renderPageNode().
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.