<?xml version="1.0"?><phpdoc><class name="IntegratedTemplateExtension" extends="IntegratedTemplate" undoc="false" access="public" package="PHPDoc"><file>c:/www/apache/doc2//redist/ITX.php</file><doc><author email="uw@netuse.de">Ulf Wendel</author><inherited src="Array"/><description>With 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.</description><shortdescription>Integrated Template Extension - ITX</shortdescription><version>$ID: $</version></doc><function name="IntegratedTemplateExtension" undoc="false" access="public"><doc><return type="void"/><description>Make sure that you call this constructor if you derive you owntemplate class from this one.</description><shortdescription>Builds some complex regexps and calls the constructor of the parent class.</shortdescription></doc></function><function name="replaceBlock" undoc="false" access="public"><doc><see type="function">replaceBlockfile()</see><see type="function">addBlock()</see><see type="function">addBlockfile()</see><parameter name="$block" type="string"/><parameter name="$template" type="string"/><return name="" type="boolean"/><description>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.&amp;quot;__&amp;quot;.blockname.&amp;quot;__&amp;quot;.closingDelimiter .Due to the cache updates replaceBlock() and replaceBlockfile() are &amp;quot;expensive&amp;quot; operationswhich means extensive usage will slow down your script. So try to avoid them and ifyou can&amp;apos;t do so try to use them before you pass lots of variables to the block you&amp;apos;rereplacing.</description><shortdescription>Replaces an existing block with new content. Warning: not implemented yet.</shortdescription></doc></function><function name="replaceBlockfile" undoc="false" access="private"><doc><see type="function">replaceBlockfile()</see><see type="function">addBlock()</see><see type="function">addBlockfile()</see><parameter name="$block" type="string"/><parameter name="$filename" type="string">of the file that contains the blockcontent</parameter><return type="void"/><description>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.&amp;quot;__&amp;quot;.blockname.&amp;quot;__&amp;quot;.closingDelimiter .Due to the cache updates replaceBlock() and replaceBlockfile() are &amp;quot;expensive&amp;quot; operationswhich means extensive usage will slow down your script. So try to avoid them and ifyou can&amp;apos;t do so try to use them before you pass lots of variables to the block you&amp;apos;rereplacing.</description><shortdescription>Replaces an existing block with new content from a file. Warning: not implemented yet.</shortdescription><brother>replaceblock</brother></doc></function><function name="addBlock" undoc="false" access="public"><doc><see type="function">addBlockfile()</see><parameter name="$placeholder" type="string">of the variable placeholder, the name must be unique within the template.</parameter><parameter name="$blockname" type="string">of the block to be added</parameter><parameter name="$template" type="string">of the block</parameter><return name="" type="boolean"/><description>Add means &amp;quot;replace a variable placeholder by a new block&amp;quot;.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 &amp;quot;cheap&amp;quot; meaning quick operations.The block content must not start with &amp;lt;!-- BEGIN blockname --&amp;gt; and end with&amp;lt;!-- END blockname --&amp;gt; this would cause overhead and produce an error.</description><shortdescription>Adds a block to the template changing a variable placeholder to a block placeholder.</shortdescription></doc></function><function name="addBlockfile" undoc="false" access="private"><doc><see type="function">addBlockfile()</see><parameter name="$placeholder" type="string">of the variable placeholder to be converted</parameter><parameter name="$blockname" type="string">of the block to be added</parameter><parameter name="$filename" type="string">that contains the block</parameter><return type="void"/><description>Add means &amp;quot;replace a variable placeholder by a new block&amp;quot;.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 &amp;quot;cheap&amp;quot; meaning quick operations.The block content must not start with &amp;lt;!-- BEGIN blockname --&amp;gt; and end with&amp;lt;!-- END blockname --&amp;gt; this would cause overhead and produce an error.</description><shortdescription>Adds a block taken from a file to the template changing a variable placeholder to a block placeholder.</shortdescription><brother>addblock</brother></doc></function><function name="deleteFromBlockvariablelist" undoc="false" access="private"><doc><parameter name="$block" type="string"/><parameter name="$variables" type="mixed">of one variable or array of variables ( array ( name =&amp;gt; true ) ) to be stripped.</parameter><return type="void"/><description/><shortdescription>Deletes one or many variables from the block variable list.</shortdescription></doc></function><function name="updateBlockvariablelist" undoc="false" access="private"><doc><parameter name="$block" type="string"/><return type="void"/><description/><shortdescription>Updates the variable list of a block.</shortdescription></doc></function><function name="findPlaceholderBlocks" undoc="false" access="private"><doc><parameter name="$variable" type="string">placeholder</parameter><return name="$parents" type="array"> parents[0..n] = blockname</return><description/><shortdescription>Returns an array of blocknames where the given variable placeholder is used.</shortdescription></doc></function><function name="warning" undoc="false" access="private"><doc><see type="var">$warn</see><see type="var">$printWarning</see><see type="var">$haltOnWarning</see><parameter name="$message" type="string"/><parameter name="$file" default="&amp;quot;&amp;quot;" type="string">where the warning occured</parameter><parameter name="$line" default="0" type="integer">where thr warning occured</parameter><return type="void"/><description/><shortdescription>Handles warnings, saves them to $warn and prints them or calls die() depending on the flags</shortdescription></doc></function><variable name="$warn" access="public" type="array">array()<doc><see type="var">$printWarning</see><see type="var">$haltOnWarning</see><see type="function">warning()</see><description/><shortdescription>Array with all warnings.</shortdescription></doc></variable><variable name="$printWarning" access="public" type="boolean">false<doc><see type="var">$haltOnWarning</see><see type="var">$warn</see><see type="function">warning()</see><description/><shortdescription>Print warnings?</shortdescription></doc></variable><variable name="$haltOnWarning" access="public" type="boolean">false<doc><see type="var">$warn</see><see type="var">$printWarning</see><see type="function">warning()</see><description/><shortdescription>Call die() on warning?</shortdescription></doc></variable><variable name="$checkblocknameRegExp" access="private" type="string">&amp;quot;&amp;quot;<doc><description/><shortdescription>RegExp used to test for a valid blockname.</shortdescription></doc></variable><inherited src="IntegratedTemplate" type="functions"><element>integratedtemplate</element><element>show</element><element>get</element><element>parse</element><element>parsecurrentblock</element><element>setvariable</element><element>setcurrentblock</element><element>init</element><element>free</element><element>settemplate</element><element>loadtemplatefile</element><element>setroot</element><element>buildblockvariablelist</element><element>getglobalvariables</element><element>findblocks</element><element>getfile</element><element>halt</element></inherited><inherited src="IntegratedTemplate" type="variables"><element>$err</element><element>$printerror</element><element>$haltonerror</element><element>$clearcache</element><element>$openingdelimiter</element><element>$closingdelimiter</element><element>$blocknameregexp</element><element>$variablenameregexp</element><element>$variablesregexp</element><element>$blockregexp</element><element>$currentblock</element><element>$template</element><element>$blocklist</element><element>$blockdata</element><element>$blockvariables</element><element>$blockinner</element><element>$blocktypes</element><element>$variablecache</element><element>$clearcacheonparse</element><element>$removeunknownvariables</element><element>$removeemptyblocks</element><element>$fileroot</element><element>$flagblocktrouble</element><element>$flagglobalparsed</element></inherited><path><parent>IntegratedTemplate</parent></path><baseclass>IntegratedTemplate</baseclass></class></phpdoc>
