c:/www/apache/doc2//form/IT.phpUlf WendelWell there's not much to say about it. I needed a template class thatsupports a single template file with multiple (nested) blocks inside anda simple block API.The Isotemplate API is somewhat tricky for a beginner although it is the bestone you can build. template::parse() [phplib template = Isotemplate] requestsyou to name a source and a target where the current block gets parsed into.Source and target can be block names or even handler names. This API gives youa maximum of fexibility but you always have to know what you do which isquite unusual for php skripter like me.I noticed that I do not any control on which block gets parsed into which one.If all blocks are within one file, the script knows how they are nested and inwhich way you have to parse them. IT knows that inner1 is a child of block2, there'sno need to tell him about this.<table border><tr><td colspan=2>__global__<p>(hidden and automatically added)</td></tr><tr><td>block1</td><td><table border><tr><td colspan=2>block2</td></tr><tr><td>inner1</td><td>inner2</td></tr></table></td></tr></table>To add content to block1 you simply type:<code>$tpl->setCurrentBlock("block1");</code>and repeat this as often as needed:<code>$tpl->setVariable(...);$tpl->parseCurrentBlock();</code>To add content to block2 you would type something like:<code>$tpl->setCurrentBlock("inner1");$tpl->setVariable(...);$tpl->parseCurrentBlock();$tpl->setVariable(...);$tpl->parseCurrentBlock();$tpl->parse("block1");</code>This will result in one repition of block1 which contains two repitionsof inner1. inner2 will be removed if $removeEmptyBlock is set to true which is the default.Usage:<code>$tpl = new IntegratedTemplate( [string filerootdir] );// load a template or set it with setTemplate()$tpl->loadTemplatefile( string filename [, boolean removeUnknownVariables, boolean removeEmptyBlocks] )// set "global" Variables meaning variables not beeing within a (inner) block$tpl->setVariable( string variablename, mixed value );// like with the Isotemplates there's a second way to use setVariable()$tpl->setVariable( array ( string varname => mixed value ) );// Let's use any block, even a deeply nested one$tpl->setCurrentBlock( string blockname );// repeat this as often as you need it.$tpl->setVariable( array ( string varname => mixed value ) );$tpl->parseCurrentBlock();// get the parsed template or print it: $tpl->show()$tpl->get();</code>Integrated Template - IT$Id: IT.php,v 1.3 2001/01/19 13:37:03 sbergmann Exp $setRoot()root directory, prefix for all filenames given to the object.Make sure that you call this constructor if you derive your templateclass from this one.Builds some complex regular expressions and optinally sets the file root directory.show()of the blockPrint a certain block with all replacements done.getshow()of the blockReturns a block with all replacements done.parseCurrentBlock()of the block to be parsedParses the given block.parse()setCurrentBlock()$currentBlockParses the current blockwith the variable name or an array %variables["varname"] = "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().Sets a variable value.of the blockfalse on failure, otherwise trueSets the name of the current block that is the block where variables are added.$removeEmptyBlocksof the blockfalse on false, otherwise truePreserves an empty block even if removeEmptyBlocks is true.free()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 blocklistinit()Don't use this function unless you know what you're doing.Clears all datafields of the object.LoadTemplatefile()$templatecontentYou can eighter load a template file from disk with LoadTemplatefile() or set thetemplate manually using this function.Sets the template.$template$removeUnknownVariables$removeEmptyBlockssetTemplate()of the template fileto handle unknown variables.to handle empty blocks.false on failure, otherwise trueReads a template file from the disk.IntegratedTemplate()Make sure that you override this function when using the classon windows.Sets the file root. The file root gets prefixed to all filenames passed to the object.Build a list of all variables within of a blockReturns a list of all$blocklistthat gets scannedRecusively builds a list of all blocks within the template.Filecontent Reads a file from disk and returns its content.$errmessagewhere the error occuredwhere the error occuredError Handling function.array()halt()$printError$haltOnErrorContains the error objectsfalsehalt()$haltOnError$errPrint error messages?falsehalt()$printError$errCall die() on error?falseClear cache on get()?"{"$closingDelimiter$blocknameRegExp$variablenameRegExpFirst character of a variable placeholder ( _{_VARIABLE} )."}"$openingDelimiter$blocknameRegExp$variablenameRegExpLast character of a variable placeholder ( {VARIABLE_}_ )."[0-9A-Za-z_-]+"$variablenameRegExp$openingDelimiter$closingDelimiterPer default "sm" is used as the regexp modifier, "i" is missing.That means a case sensitive search is done.RegExp matching a block in the template."[0-9A-Za-z_-]+"$blocknameRegExp$openingDelimiter$closingDelimiterPer default "sm" is used as the regexp modifier, "i" is missing.That means a case sensitive search is done.RegExp matching a variable placeholder in the template.""IntegratedTemplate()RegExp used to find variable placeholder, filled by the constructor.""RegExp used to strip unused variable placeholder.trueControls the handling of unknown variables, default is remove.trueControls the handling of empty blocks, default is remove.""IntegratedTemplate()RegExp used to find blocks an their content, filled by the constructor."__global__"Name of the current block.""Content of the template.array()findBlocks()Array of all blocks and their content.array()Array with the parsed content of a block.array()Array of variables in a block.array()Array of inner blocks of a block.array()touchBlock()$removeEmptyBlocksThis is something special. Sometimes you have blocks thatshould be preserved although they are empty (no placeholder replaced).Think of a shopping basket. If it's empty you have to drop a message tothe 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 goodidea to place it in you applications as customers tend to like unecessary minortext changes. Having another template file for an empty basket means that it'svery likely that one fine day the filled and empty basket templates have differentlayout. I decided to introduce blocks that to not contain any placeholder but onlytext such as the message "Your shopping basked is empty".Now if there is no replacement done in such a block the block will be recognizedas "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 evenif they are empty.List of blocks to preverse even if they are "empty".array()setVariable()$clearCacheOnParseVariables get cached before any replacement is done.Advantage: empty blocks can be removed automatically.Disadvantage: might take some more memoryVariable cache.falseIf you're not an expert just leave the default false.True reduces memory consumption somewhat if you tend toadd lots of values for unknown placeholder.Clear the variable cache on parse?""IntegratedTemplate()setRoot()The string gets prefixed to all filenames given.Root directory for all file operations.falseInternal flag indicating that a blockname was used multiple times.falseFlag indicating that the global block was parsed.trueFlag indication that a template gets cached.Complex templates require some times to be preparsedbefore the replacement can take place. Often I useone template file over and over again but I don't knowbefore that I will use the same template file again.Now IT could notice this and skip the preparse.EXPERIMENTAL! FIXME!""EXPERIMENTAL! FIXME!IntegratedTemplateExtension