c:/www/apache/doc2//form/ITX.phpUlf WendelWith this class you get the full power of the phplib template class.You may have one file with blocks in it but you have as well one main fileand multiple files one for each block. This is quite usefull when you haveuser configurable websites. Using blocks not in the main template allowsyou to some parts of your layout easily.Note that you can replace an existing block and add new blocks add runtime.Adding new blocks means changing a variable placeholder to a block.Integrated Template Extension - ITX$Id: ITX.php,v 1.4 2001/01/24 11:19:28 sbergmann Exp $Make sure that you call this constructor if you derive you owntemplate class from this one.Builds some complex regexps and calls the constructor of the parent class.replaceBlockfile()addBlock()addBlockfile()The Replacement does not affect previously added variables. All data is cached.In case the new block does contain less or other variable placeholder the previouslypassed data that is no longer referenced will be deleted. The internal listof allowed variables gets updated as well.In case the original block contains other blocks it must eighter have placeholderfor the inner blocks or contain them. If you want to use placeholder the placeholder mustlook like openingDelimiter."__".blockname."__".closingDelimiter .Due to the cache updates replaceBlock() and replaceBlockfile() are "expensive" operationswhich means extensive usage will slow down your script. So try to avoid them and ifyou can't do so try to use them before you pass lots of variables to the block you'rereplacing.Replaces an existing block with new content. Warning: not implemented yet.replaceBlockfile()addBlock()addBlockfile()of the file that contains the blockcontentThe Replacement does not affect previously added variables. All data is cached.In case the new block does contain less or other variable placeholder the previouslypassed data that is no longer referenced will be deleted. The internal listof allowed variables gets updated as well.In case the original block contains other blocks it must eighter have placeholderfor the inner blocks or contain them. If you want to use placeholder the placeholder mustlook like openingDelimiter."__".blockname."__".closingDelimiter .Due to the cache updates replaceBlock() and replaceBlockfile() are "expensive" operationswhich means extensive usage will slow down your script. So try to avoid them and ifyou can't do so try to use them before you pass lots of variables to the block you'rereplacing.Replaces an existing block with new content from a file. Warning: not implemented yet.replaceblockaddBlockfile()of the variable placeholder, the name must be unique within the template.of the block to be addedof the blockAdd means "replace a variable placeholder by a new block".This is different to PHPLibs templates. The function loads ablock, creates a handle for it and assigns it to a certainvariable placeholder. To to the same with PHPLibs templates you wouldcall set_file() to create the handle and parse() to assign theparsed block to a variable. By this PHPLibs templates assume that you tendto assign a block to more than one one placeholder. To assign a parsed blockto more than only the placeholder you specify in this function you haveto use a combination of getBlock() and setVariable().As no updates to cached data is necessary addBlock() and addBlockfile()are rather "cheap" meaning quick operations.The block content must not start with <!-- BEGIN blockname --> and end with<!-- END blockname --> this would cause overhead and produce an error.Adds a block to the template changing a variable placeholder to a block placeholder.addBlockfile()of the variable placeholder to be convertedof the block to be addedthat contains the blockAdd means "replace a variable placeholder by a new block".This is different to PHPLibs templates. The function loads ablock, creates a handle for it and assigns it to a certainvariable placeholder. To to the same with PHPLibs templates you wouldcall set_file() to create the handle and parse() to assign theparsed block to a variable. By this PHPLibs templates assume that you tendto assign a block to more than one one placeholder. To assign a parsed blockto more than only the placeholder you specify in this function you haveto use a combination of getBlock() and setVariable().As no updates to cached data is necessary addBlock() and addBlockfile()are rather "cheap" meaning quick operations.The block content must not start with <!-- BEGIN blockname --> and end with<!-- END blockname --> this would cause overhead and produce an error.Adds a block taken from a file to the template changing a variable placeholder to a block placeholder.addblockof the placeholder you're searchingof the block to scan. If left out (default) all blocks are scanned.Name of the (first) block that contains the specified placeholder. If the placeholder was not found or an error occured an empty string is returned.Returns the name of the (first) block that contains the specified placeholder.Checks the list of function calls in the template and calls their callback function.Returns a list of all function calls in the current template.IDReplaces a function call with the given replacement.name in the templateof the callback functionof the callback objectFalse on failure.Sets a callback function.table - array[templatefunction] = array( "function" => userfunction, "object" => userobject )Sets the Callback function lookup tableblockExists() [blockname => blockname]Returns a list of blocknames in the template.getBlocklist()Checks wheter a block exists.BlockvariableExists() [varname => varname]Returns a list of variables of a block.getBlockvariables()Checks wheter a block variable exists.Builds a functionlist from the template.of one variable or array of variables ( array ( name => true ) ) to be stripped.Deletes one or many variables from the block variable list.Updates the variable list of a block.placeholder parents[0..n] = blocknameReturns an array of blocknames where the given variable placeholder is used.$warn$printWarning$haltOnWarningwhere the warning occuredwhere the warning occuredHandles warnings, saves them to $warn and prints them or calls die() depending on the flagsfree()LoadTemplatefile() and setTemplate() automatically call this functionwhen a new template is given. Don't use this functionunless you know what you're doing.Clears all datafields of the object and rebuild the internal blocklistarray()$printWarning$haltOnWarningwarning()Array with all warnings.false$haltOnWarning$warnwarning()Print warnings?false$warn$printWarningwarning()Call die() on warning?""RegExp used to test for a valid blockname."func_"Functionnameprefix used when searching function calls in the template."[_a-zA-Z]+[A-Za-z_0-9]*"Functionname RegExp.""IntegratedTemplateExtension()The variable gets set by the constructor.RegExp used to grep function calls in the template.array()List of functions found in the template.array()List of callback functions specified by the user.integratedtemplateshowgetparseparsecurrentblocksetvariablesetcurrentblocktouchblockfreesettemplateloadtemplatefilesetrootbuildblockvariablelistgetglobalvariablesfindblocksgetfilehalt$err$printerror$haltonerror$clearcache$openingdelimiter$closingdelimiter$blocknameregexp$variablenameregexp$variablesregexp$removevariablesregexp$removeunknownvariables$removeemptyblocks$blockregexp$currentblock$template$blocklist$blockdata$blockvariables$blockinner$touchedblocks$variablecache$clearcacheonparse$fileroot$flagblocktrouble$flagglobalparsed$flagcachetemplatefile$lasttemplatefileIntegratedTemplateIntegratedTemplate