Imported Upstream version 1.3.0

This commit is contained in:
Mario Fetka 2018-03-08 14:15:34 +01:00
commit 91526147d9
24 changed files with 3321 additions and 0 deletions

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,889 @@
<?php
/**
* Integrated Template - IT
*
* PHP version 4
*
* Copyright (c) 1997-2007 Ulf Wendel, Pierre-Alain Joye,
* David Soria Parra
*
* This source file is subject to the New BSD license, That is bundled
* with this package in the file LICENSE, and is available through
* the world-wide-web at
* http://www.opensource.org/licenses/bsd-license.php
* If you did not receive a copy of the new BSDlicense and are unable
* to obtain it through the world-wide-web, please send a note to
* pajoye@php.net so we can mail you a copy immediately.
*
* Author: Ulf Wendel <ulf.wendel@phpdoc.de>
* Pierre-Alain Joye <pajoye@php.net>
* David Soria Parra <dsp@php.net>
*
* @category HTML
* @package HTML_Template_IT
* @author Ulf Wendel <uw@netuse.de>
* @license BSD http://www.opensource.org/licenses/bsd-license.php
* @version CVS: $Id: ITX.php 295086 2010-02-15 06:31:36Z clockwerx $
* @link http://pear.php.net/packages/HTML_Template_IT
* @access public
*/
require_once 'HTML/Template/IT.php';
require_once 'HTML/Template/IT_Error.php';
/**
* Integrated Template Extension - ITX
*
* 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 file
* and multiple files one for each block. This is quite usefull when you have
* user configurable websites. Using blocks not in the main template allows
* you to modify some parts of your layout easily.
*
* Note that you can replace an existing block and add new blocks at runtime.
* Adding new blocks means changing a variable placeholder to a block.
*
* @category HTML
* @package HTML_Template_IT
* @author Ulf Wendel <uw@netuse.de>
* @license BSD http://www.opensource.org/licenses/bsd-license.php
* @link http://pear.php.net/packages/HTML_Template_IT
* @access public
*/
class HTML_Template_ITX extends HTML_Template_IT
{
/**
* Array with all warnings.
* @var array
* @access public
* @see $printWarning, $haltOnWarning, warning()
*/
var $warn = array();
/**
* Print warnings?
* @var array
* @access public
* @see $haltOnWarning, $warn, warning()
*/
var $printWarning = false;
/**
* Call die() on warning?
* @var boolean
* @access public
* @see $warn, $printWarning, warning()
*/
var $haltOnWarning = false;
/**
* RegExp used to test for a valid blockname.
* @var string
* @access private
*/
var $checkblocknameRegExp = '';
/**
* Functionnameprefix used when searching function calls in the template.
* @var string
* @access public
*/
var $functionPrefix = 'func_';
/**
* Functionname RegExp.
* @var string
* @access public
*/
var $functionnameRegExp = '[_a-zA-Z]+[A-Za-z_0-9]*';
/**
* RegExp used to grep function calls in the template.
*
* The variable gets set by the constructor.
*
* @access private
* @var string
* @see HTML_Template_IT()
*/
var $functionRegExp = '';
/**
* List of functions found in the template.
*
* @access private
* @var array
*/
var $functions = array();
/**
* List of callback functions specified by the user.
*
* @access private
* @var array
*/
var $callback = array();
/**
* Builds some complex regexps and calls the constructor
* of the parent class.
*
* Make sure that you call this constructor if you derive your own
* template class from this one.
*
* @param string $root Root node?
*
* @access public
* @see HTML_Template_IT()
*/
function HTML_Template_ITX($root = '')
{
$this->checkblocknameRegExp = '@' . $this->blocknameRegExp . '@';
$this->functionRegExp = '@' . $this->functionPrefix . '(' .
$this->functionnameRegExp . ')\s*\(@sm';
$this->HTML_Template_IT($root);
} // end func constructor
/**
* 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 private
* @return null
*/
function init()
{
$this->free();
$this->buildFunctionlist();
$this->findBlocks($this->template);
// we don't need it any more
$this->template = '';
$this->buildBlockvariablelist();
} // end func init
/**
* Replaces an existing block with new content.
*
* This function will replace a block of the template and all blocks
* contained in the replaced block and add a new block insted, means
* you can dynamically change your template.
*
* Note that changing the template structure violates one of the IT[X]
* development goals. I've tried to write a simple to use template engine
* supporting blocks. In contrast to other systems IT[X] analyses the way
* you've nested blocks and knows which block belongs into another block.
* The nesting information helps to make the API short and simple. Replacing
* blocks does not only mean that IT[X] has to update the nesting
* information (relatively time consumpting task) but you have to make sure
* that you do not get confused due to the template change itself.
*
* @param string $block Blockname
* @param string $template Blockcontent
* @param boolean $keep_content true if the new block inherits the content
* of the old block
*
* @return boolean
* @throws IT_Error
* @see replaceBlockfile(), addBlock(), addBlockfile()
* @access public
*/
function replaceBlock($block, $template, $keep_content = false)
{
if (!isset($this->blocklist[$block])) {
return new IT_Error("The block "."'$block'".
" does not exist in the template and thus it can't be replaced.",
__FILE__, __LINE__);
}
if ($template == '') {
return new IT_Error('No block content given.', __FILE__, __LINE__);
}
if ($keep_content) {
$blockdata = $this->blockdata[$block];
}
// remove all kinds of links to the block / data of the block
$this->removeBlockData($block);
$template = "<!-- BEGIN $block -->" . $template . "<!-- END $block -->";
$parents = $this->blockparents[$block];
$this->findBlocks($template);
$this->blockparents[$block] = $parents;
// KLUDGE: rebuild the list for all block - could be done faster
$this->buildBlockvariablelist();
if ($keep_content) {
$this->blockdata[$block] = $blockdata;
}
// old TODO - I'm not sure if we need this
// update caches
return true;
} // end func replaceBlock
/**
* Replaces an existing block with new content from a file.
*
* @param string $block Blockname
* @param string $filename Name of the file that contains the blockcontent
* @param boolean $keep_content true if the new block inherits the content of
* the old block
*
* @brother replaceBlock()
* @access public
* @return null
*/
function replaceBlockfile($block, $filename, $keep_content = false)
{
return $this->replaceBlock($block, $this->getFile($filename), $keep_content);
} // end func replaceBlockfile
/**
* Adds a block to the template changing a variable placeholder
* to a block placeholder.
*
* Add means "replace a variable placeholder by a new block".
* This is different to PHPLibs templates. The function loads a
* block, creates a handle for it and assigns it to a certain
* variable placeholder. To to the same with PHPLibs templates you would
* call set_file() to create the handle and parse() to assign the
* parsed block to a variable. By this PHPLibs templates assume
* that you tend to assign a block to more than one one placeholder.
* To assign a parsed block to more than only the placeholder you specify
* in this function you have to 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.
*
* @param string $placeholder Name of the variable placeholder, the name
* must be unique within the template.
* @param string $blockname Name of the block to be added
* @param string $template Content of the block
*
* @return boolean
* @throws IT_Error
* @see addBlockfile()
* @access public
*/
function addBlock($placeholder, $blockname, $template)
{
// Don't trust any user even if it's a programmer or yourself...
if ($placeholder == '') {
return new IT_Error('No variable placeholder given.',
__FILE__, __LINE__);
} elseif ($blockname == '' ||
!preg_match($this->checkblocknameRegExp, $blockname)
) {
return new IT_Error("No or invalid blockname '$blockname' given.",
__FILE__, __LINE__);
} elseif ($template == '') {
return new IT_Error('No block content given.', __FILE__, __LINE__);
} elseif (isset($this->blocklist[$blockname])) {
return new IT_Error('The block already exists.',
__FILE__, __LINE__);
}
// find out where to insert the new block
$parents = $this->findPlaceholderBlocks($placeholder);
if (count($parents) == 0) {
return new IT_Error("The variable placeholder".
" '$placeholder' was not found in the template.",
__FILE__, __LINE__);
} elseif (count($parents) > 1) {
reset($parents);
while (list($k, $parent) = each($parents)) {
$msg .= "$parent, ";
}
$msg = substr($parent, -2);
return new IT_Error("The variable placeholder "."'$placeholder'".
" must be unique, found in multiple blocks '$msg'.",
__FILE__, __LINE__);
}
$template = "<!-- BEGIN $blockname -->"
. $template
. "<!-- END $blockname -->";
$this->findBlocks($template);
if ($this->flagBlocktrouble) {
return false; // findBlocks() already throws an exception
}
$this->blockinner[$parents[0]][] = $blockname;
$escblockname = '__' . $blockname . '__';
$this->blocklist[$parents[0]] = preg_replace(
'@' . $this->openingDelimiter . $placeholder .
$this->closingDelimiter . '@',
$this->openingDelimiter . $escblockname . $this->closingDelimiter,
$this->blocklist[$parents[0]]
);
$this->deleteFromBlockvariablelist($parents[0], $placeholder);
$this->updateBlockvariablelist($blockname);
return true;
} // end func addBlock
/**
* Adds a block taken from a file to the template changing a variable
* placeholder to a block placeholder.
*
* @param string $placeholder Name of the variable placeholder to be converted
* @param string $blockname Name of the block to be added
* @param string $filename File that contains the block
*
* @brother addBlock()
* @access public
* @return null
*/
function addBlockfile($placeholder, $blockname, $filename)
{
return $this->addBlock($placeholder, $blockname, $this->getFile($filename));
} // end func addBlockfile
/**
* Returns the name of the (first) block that contains
* the specified placeholder.
*
* @param string $placeholder Name of the placeholder you're searching
* @param string $block Name of the block to scan. If left out (default)
* all blocks are scanned.
*
* @return string 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.
* @throws IT_Error
* @access public
*/
function placeholderExists($placeholder, $block = '')
{
if ($placeholder == '') {
new IT_Error('No placeholder name given.', __FILE__, __LINE__);
return '';
}
if ($block != '' && !isset($this->blocklist[$block])) {
new IT_Error("Unknown block '$block'.", __FILE__, __LINE__);
return '';
}
// name of the block where the given placeholder was found
$found = '';
if ($block != '') {
if (is_array($variables = $this->blockvariables[$block])) {
// search the value in the list of blockvariables
reset($variables);
while (list($k, $variable) = each($variables)) {
if ($k == $placeholder) {
$found = $block;
break;
}
}
}
} else {
// search all blocks and return the name of the first block that
// contains the placeholder
reset($this->blockvariables);
while (list($blockname, $variables) = each($this->blockvariables)) {
if (is_array($variables) && isset($variables[$placeholder])) {
$found = $blockname;
break;
}
}
}
return $found;
} // end func placeholderExists
/**
* Checks the list of function calls in the template and
* calls their callback function.
*
* @access public
* @return null
*/
function performCallback()
{
reset($this->functions);
while (list($func_id, $function) = each($this->functions)) {
if (isset($this->callback[$function['name']])) {
if ($this->callback[$function['name']]['expandParameters']) {
$callFunction = 'call_user_func_array';
} else {
$callFunction = 'call_user_func';
}
if ($this->callback[$function['name']]['object'] != '') {
$call = $callFunction(
array(
&$GLOBALS[$this->callback[$function['name']]['object']],
$this->callback[$function['name']]['function']),
$function['args']);
} else {
$call = $callFunction(
$this->callback[$function['name']]['function'],
$function['args']);
}
$this->variableCache['__function' . $func_id . '__'] = $call;
}
}
} // end func performCallback
/**
* Returns a list of all function calls in the current template.
*
* @return array
* @access public
*/
function getFunctioncalls()
{
return $this->functions;
} // end func getFunctioncalls
/**
* Replaces a function call with the given replacement.
*
* @param int $functionID Function ID
* @param string $replacement Replacement
*
* @access public
* @deprecated
* @return null
*/
function setFunctioncontent($functionID, $replacement)
{
$this->variableCache['__function' . $functionID . '__'] = $replacement;
} // end func setFunctioncontent
/**
* Sets a callback function.
*
* IT[X] templates (note the X) can contain simple function calls.
* "function call" means that the editor of the template can add
* special placeholder to the template like 'func_h1("embedded in h1")'.
* IT[X] will grab this function calls and allow you to define a callback
* function for them.
*
* This is an absolutely evil feature. If your application makes heavy
* use of such callbacks and you're even implementing if-then etc. on
* the level of a template engine you're reiventing the wheel... - that's
* actually how PHP came into life. Anyway, sometimes it's handy.
*
* Consider also using XML/XSLT or native PHP. And please do not push
* IT[X] any further into this direction of adding logics to the template
* engine.
*
* For those of you ready for the X in IT[X]:
*
* <?php
* ...
* function h_one($args) {
* return sprintf('<h1>%s</h1>', $args[0]);
* }
*
* ...
* $itx = new HTML_Template_ITX(...);
* ...
* $itx->setCallbackFunction('h1', 'h_one');
* $itx->performCallback();
* ?>
*
* template:
* func_h1('H1 Headline');
*
* @param string $tplfunction Function name in the template
* @param string $callbackfunction Name of the callback function
* @param string $callbackobject Name of the callback object
* @param boolean $expandCallbackParameters If the callback is called with
* a list of parameters or with an
* array holding the parameters
*
* @return boolean False on failure.
* @throws IT_Error
* @access public
* @deprecated The $callbackobject parameter is depricated since
* version 1.2 and might be dropped in further versions.
*/
function setCallbackFunction($tplfunction, $callbackfunction,
$callbackobject = '',
$expandCallbackParameters = false) {
if ($tplfunction == '' || $callbackfunction == '') {
return new IT_Error("No template function "."('$tplfunction')".
" and/or no callback function ('$callback') given.",
__FILE__, __LINE__);
}
$this->callback[$tplfunction] = array(
'function' => $callbackfunction,
'object' => $callbackobject,
'expandParameters' => (boolean)
$expandCallbackParameters);
return true;
} // end func setCallbackFunction
/**
* Sets the Callback function lookup table
*
* @param array $functions function table
* array[templatefunction] =
* array(
* "function" => userfunction,
* "object" => userobject
* )
*
* @access public
* @return null
*/
function setCallbackFuntiontable($functions)
{
$this->callback = $functions;
} // end func setCallbackFunctiontable
/**
* Recursively removes all data assiciated with a block, including
* all inner blocks
*
* @param string $block block to be removed
*
* @return null
* @access private
*/
function removeBlockData($block)
{
if (isset($this->blockinner[$block])) {
foreach ($this->blockinner[$block] as $k => $inner) {
$this->removeBlockData($inner);
}
unset($this->blockinner[$block]);
}
unset($this->blocklist[$block]);
unset($this->blockdata[$block]);
unset($this->blockvariables[$block]);
unset($this->touchedBlocks[$block]);
} // end func removeBlockinner
/**
* Returns a list of blocknames in the template.
*
* @return array [blockname => blockname]
* @access public
* @see blockExists()
*/
function getBlocklist()
{
$blocklist = array();
foreach ($this->blocklist as $block => $content) {
$blocklist[$block] = $block;
}
return $blocklist;
} // end func getBlocklist
/**
* Checks wheter a block exists.
*
* @param string $blockname Blockname
*
* @return boolean
* @access public
* @see getBlocklist()
*/
function blockExists($blockname)
{
return isset($this->blocklist[$blockname]);
} // end func blockExists
/**
* Returns a list of variables of a block.
*
* @param string $block Blockname
*
* @return array [varname => varname]
* @access public
* @see BlockvariableExists()
*/
function getBlockvariables($block)
{
if (!isset($this->blockvariables[$block])) {
return array();
}
$variables = array();
foreach ($this->blockvariables[$block] as $variable => $v) {
$variables[$variable] = $variable;
}
return $variables;
} // end func getBlockvariables
/**
* Checks wheter a block variable exists.
*
* @param string $block Blockname
* @param string $variable Variablename
*
* @return boolean
* @access public
* @see getBlockvariables()
*/
function BlockvariableExists($block, $variable)
{
return isset($this->blockvariables[$block][$variable]);
} // end func BlockvariableExists
/**
* Builds a functionlist from the template.
*
* @access private
* @return null
*/
function buildFunctionlist()
{
$this->functions = array();
$template = $this->template;
$num = 0;
while (preg_match($this->functionRegExp, $template, $regs)) {
$pos = strpos($template, $regs[0]);
$template = substr($template, $pos + strlen($regs[0]));
$head = $this->getValue($template, ')');
$args = array();
$search = $regs[0] . $head . ')';
$replace = $this->openingDelimiter .
'__function' . $num . '__' .
$this->closingDelimiter;
$this->template = str_replace($search, $replace, $this->template);
$template = str_replace($search, $replace, $template);
while ($head != '' && $args2 = $this->getValue($head, ',')) {
$arg2 = trim($args2);
$args[] = ('"' == $arg2{0} || "'" == $arg2{0}) ?
substr($arg2, 1, -1) : $arg2;
if ($arg2 == $head) {
break;
}
$head = substr($head, strlen($arg2) + 1);
}
$this->functions[$num++] = array('name' => $regs[1],
'args' => $args);
}
} // end func buildFunctionlist
/**
* Truncates the given code from the first occurence of
* $delimiter but ignores $delimiter enclosed by " or '.
*
* @param string $code The code which should be parsed
* @param string $delimiter The delimiter char
*
* @access private
* @return string
* @see buildFunctionList()
*/
function getValue($code, $delimiter)
{
if ($code == '') {
return '';
}
if (!is_array($delimiter)) {
$delimiter = array($delimiter => true);
}
$len = strlen($code);
$enclosed = false;
$enclosed_by = '';
if (isset($delimiter[$code[0]])) {
$i = 1;
} else {
for ($i = 0; $i < $len; ++$i) {
$char = $code[$i];
if (($char == '"' || $char == "'")
&& ($char == $enclosed_by || '' == $enclosed_by)
&& (0 == $i || ($i > 0 && '\\' != $code[$i - 1]))
) {
if (!$enclosed) {
$enclosed_by = $char;
} else {
$enclosed_by = "";
}
$enclosed = !$enclosed;
}
if (!$enclosed && isset($delimiter[$char])) {
break;
}
}
}
return substr($code, 0, $i);
} // end func getValue
/**
* Deletes one or many variables from the block variable list.
*
* @param string $block Blockname
* @param mixed $variables Name of one variable or array of variables
* (array (name => true ) ) to be stripped.
*
* @access private
* @return null
*/
function deleteFromBlockvariablelist($block, $variables)
{
if (!is_array($variables)) {
$variables = array($variables => true);
}
reset($this->blockvariables[$block]);
while (list($varname, $val) = each($this->blockvariables[$block])) {
if (isset($variables[$varname])) {
unset($this->blockvariables[$block][$varname]);
}
}
} // end deleteFromBlockvariablelist
/**
* Updates the variable list of a block.
*
* @param string $block Blockname
*
* @access private
* @return null
*/
function updateBlockvariablelist($block)
{
preg_match_all(
$this->variablesRegExp,
$this->blocklist[$block], $regs
);
if (count($regs[1]) != 0) {
foreach ($regs[1] as $k => $var) {
$this->blockvariables[$block][$var] = true;
}
} else {
$this->blockvariables[$block] = array();
}
// check if any inner blocks were found
if (isset($this->blockinner[$block])
&& is_array($this->blockinner[$block])
&& count($this->blockinner[$block]) > 0
) {
/*
* loop through inner blocks, registering the variable
* placeholders in each
*/
foreach ($this->blockinner[$block] as $childBlock) {
$this->updateBlockvariablelist($childBlock);
}
}
} // end func updateBlockvariablelist
/**
* Returns an array of blocknames where the given variable
* placeholder is used.
*
* @param string $variable Variable placeholder
*
* @return array $parents parents[0..n] = blockname
* @access public
*/
function findPlaceholderBlocks($variable)
{
$parents = array();
reset($this->blocklist);
while (list($blockname, $content) = each($this->blocklist)) {
reset($this->blockvariables[$blockname]);
while (list($varname, $val) = each($this->blockvariables[$blockname])) {
if ($variable == $varname) {
$parents[] = $blockname;
}
}
}
return $parents;
} // end func findPlaceholderBlocks
/**
* Handles warnings, saves them to $warn and prints them or
* calls die() depending on the flags
*
* @param string $message Warning
* @param string $file File where the warning occured
* @param int $line Linenumber where the warning occured
*
* @see $warn, $printWarning, $haltOnWarning
* @access private
* @return null
*/
function warning($message, $file = '', $line = 0)
{
$message = sprintf(
'HTML_Template_ITX Warning: %s [File: %s, Line: %d]',
$message,
$file,
$line
);
$this->warn[] = $message;
if ($this->printWarning) {
print $message;
}
if ($this->haltOnWarning) {
die($message);
}
} // end func warning
} // end class HTML_Template_ITX
?>

View File

@ -0,0 +1,65 @@
<?php
/**
* Integrated Template - IT
*
* PHP version 4
*
* Copyright (c) 1997-2007 Ulf Wendel, Pierre-Alain Joye,
* David Soria Parra
*
* This source file is subject to the New BSD license, That is bundled
* with this package in the file LICENSE, and is available through
* the world-wide-web at
* http://www.opensource.org/licenses/bsd-license.php
* If you did not receive a copy of the new BSDlicense and are unable
* to obtain it through the world-wide-web, please send a note to
* pajoye@php.net so we can mail you a copy immediately.
*
* Author: Ulf Wendel <ulf.wendel@phpdoc.de>
* Pierre-Alain Joye <pajoye@php.net>
* David Soria Parra <dsp@php.net>
*
* @category HTML
* @package HTML_Template_IT
* @author Ulf Wendel <uw@netuse.de>
* @license BSD http://www.opensource.org/licenses/bsd-license.php
* @version CVS: $Id: IT_Error.php 295117 2010-02-15 23:25:21Z clockwerx $
* @link http://pear.php.net/packages/HTML_Template_IT
* @access public
*/
require_once "PEAR.php";
/**
* IT[X] Error class
*
* @category HTML
* @package HTML_Template_IT
* @author Ulf Wendel <uw@netuse.de>
* @license BSD http://www.opensource.org/licenses/bsd-license.php
* @link http://pear.php.net/packages/HTML_Template_IT
* @access public
*/
class IT_Error extends PEAR_Error
{
/**
* Prefix of all error messages.
*
* @var string
*/
var $error_message_prefix = "IntegratedTemplate Error: ";
/**
* Creates an cache error object.
*
* @param string $msg error message
* @param string $file file where the error occured
* @param string $line linenumber where the error occured
*/
function IT_Error($msg, $file = __FILE__, $line = __LINE__)
{
$this->PEAR_Error(sprintf("%s [%s on line %d].", $msg, $file, $line));
} // end func IT_Error
} // end class IT_Error
?>

View File

@ -0,0 +1,22 @@
Redistribution and use in source and binary forms, with or without modification
, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, th
is list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation and/
or other materials provided with the distribution.
3. The name of the author may not be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WA
RRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABIL
ITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR C
ONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOW
EVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILI
TY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE U
SE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

View File

@ -0,0 +1,27 @@
<?php
require_once 'HTML/Template/IT.php';
$data = array (
'0' => array('Stig', 'Bakken'),
'1' => array('Martin', 'Jansen'),
'2' => array('Alexander', 'Merz')
);
$tpl = new HTML_Template_IT('./templates');
$tpl->loadTemplatefile('main.tpl.htm', true, true);
foreach ($data as $name) {
foreach ($name as $cell) {
// Assign data to the inner block
$tpl->setCurrentBlock('cell');
$tpl->setVariable('DATA', $cell);
$tpl->parseCurrentBlock();
}
// Assign data and the inner block to the
// outer block
$tpl->setCurrentBlock('row');
$tpl->parseCurrentBlock();
}
// print the output
$tpl->show();
?>

View File

@ -0,0 +1,58 @@
<?php
/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
/**
* An example for the usage of ITX::addBlockfile
*
* @version CVS: $Id: sample_itx_addblockfile.php 216180 2006-07-11 21:56:05Z dsp $
*/
require_once 'HTML/Template/ITX.php';
$data = array (array ('packagename'=>'mypackage',
'version' =>'1.0',
'changelog' => array ('fix bug #002',
'add author FOO to AUTHORS')
),
array ('packagename'=>'mypackage',
'version' =>'1.0 RC 1',
'changelog' => array ('fix bug #002',
'added method foo()')
)
);
$tpl = new HTML_Template_ITX('./templates');
$tpl->loadTemplatefile('addblockfile_main.tpl.htm', true, true);
// The complete content of "addblockfile_main.tpl.htm" will be loaded into a block
// called "list_template". The placeholder {DESCRIPTION} will be replaced
// with the added block "list_template".
$tpl->addBlockfile('DESCRIPTION', 'list_template', 'addblockfile_list.tpl.htm');
// we now have the following blocks loaded:
// __global__, row, list_template and listelement
// lets assign the data.
foreach ($data as $entry) {
// assign data to the inner block (listelement) of list_template.
$tpl->setCurrentBlock('listelement');
foreach ($entry['changelog'] as $changelogentry) {
$tpl->setVariable('ENTRY', $changelogentry);
$tpl->parseCurrentBlock();
}
// assign data to the added list_template block
$tpl->setCurrentBlock('list_template');
$tpl->setVariable('LISTNAME', $entry['version']);
$tpl->parseCurrentBlock();
// back in the original templatefile we assign data to the row block
// notice:
// {DESCRIPTION} is not longer available, because it was replaced by the
// list_template block
$tpl->setCurrentBlock('row');
$tpl->setVariable('NAME', $entry['packagename']);
$tpl->parseCurrentBlock();
}
$tpl->show();
?>

View File

@ -0,0 +1,6 @@
{LISTNAME}
<ul>
<!-- BEGIN listelement -->
<li>{ENTRY}</li>
<!-- END listelement -->
</ul>

View File

@ -0,0 +1,12 @@
<html>
<body>
<table>
<!-- BEGIN row -->
<tr>
<td>{NAME}</td>
<td>{DESCRIPTION}</td>
</tr>
<!-- END row -->
</table>
</body>
</html>

View File

@ -0,0 +1,13 @@
<html>
<table border>
<!-- BEGIN row -->
<tr>
<!-- BEGIN cell -->
<td>
{DATA}
</td>
<!-- END cell -->
</tr>
<!-- END row -->
</table>
</html>

View File

@ -0,0 +1,36 @@
<?php
if (!defined('PHPUnit_MAIN_METHOD')) {
define('PHPUnit_MAIN_METHOD', 'HTML_Template_IT_AllTests::main');
}
require_once 'PHPUnit/TextUI/TestRunner.php';
require_once 'PHPUnit/Framework/TestSuite.php';
require_once 'ITTest.php';
require_once 'ITXTest.php';
class HTML_Template_IT_AllTests
{
public static function main()
{
PHPUnit_TextUI_TestRunner::run(self::suite());
}
public static function suite()
{
$suite = new PHPUnit_Framework_TestSuite('HTML_Template_IT tests');
$suite->addTestSuite('ITTest');
$suite->addTestSuite('ITXTest');
return $suite;
}
}
if (PHPUnit_MAIN_METHOD == 'HTML_Template_IT_AllTests::main') {
HTML_Template_IT_AllTests::main();
}
?>

View File

@ -0,0 +1,416 @@
<?php
require_once 'HTML/Template/IT.php';
require_once 'PHPUnit/Framework/TestCase.php';
class ITTest extends PHPUnit_Framework_TestCase
{
/**
* An HTML_Template_IT object
* @var object
*/
var $tpl;
function setUp()
{
$this->tpl = new HTML_Template_IT(dirname(__FILE__) . '/templates');
}
function tearDown()
{
unset($this->tpl);
}
function _stripWhitespace($str)
{
return preg_replace('/\\s+/', '', $str);
}
function _methodExists($name)
{
if (in_array(strtolower($name), get_class_methods($this->tpl))) {
return true;
}
$this->assertTrue(false, 'method '. $name . ' not implemented in ' . get_class($this->tpl));
return false;
}
/**
* Tests a setTemplate method
*
*/
function testSetTemplate()
{
$result = $this->tpl->setTemplate('A template', false, false);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error setting template: '. $result->getMessage());
}
$this->assertEquals('A template', $this->tpl->get());
}
/**
* Tests a loadTemplatefile method
*
*/
function testLoadTemplatefile()
{
$result = $this->tpl->loadTemplatefile('loadtemplatefile.html', false, false);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->assertEquals('A template', trim($this->tpl->get()));
}
/**
* Tests a setVariable method
*
*/
function testSetVariable()
{
$result = $this->tpl->setTemplate('{placeholder1} {placeholder2} {placeholder3}', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error setting template: '. $result->getMessage());
}
// "scalar" call
$this->tpl->setVariable('placeholder1', 'var1');
// array call
$this->tpl->setVariable(array(
'placeholder2' => 'var2',
'placeholder3' => 'var3'
));
$this->assertEquals('var1 var2 var3', $this->tpl->get());
}
/**
* Tests the <!-- INCLUDE --> functionality
*
*/
function testInclude()
{
$result = $this->tpl->loadTemplateFile('include.html', false, false);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->assertEquals('Master file; Included file', trim($this->tpl->get()));
}
/**
*
*/
function testCurrentBlock()
{
$result = $this->tpl->loadTemplateFile('blockiteration.html', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->tpl->setVariable('outer', 'a');
$this->tpl->setCurrentBlock('inner_block');
for ($i = 0; $i < 5; $i++) {
$this->tpl->setVariable('inner', $i + 1);
$this->tpl->parseCurrentBlock();
} // for
$this->assertEquals('a|1|2|3|4|5#', $this->_stripWhitespace($this->tpl->get()));
}
/**
*
*/
function testRemovePlaceholders()
{
$result = $this->tpl->setTemplate('{placeholder1},{placeholder2},{placeholder3}', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error setting template: '. $result->getMessage());
}
// we do not set {placeholder3}
$this->tpl->setVariable(array(
'placeholder1' => 'var1',
'placeholder2' => 'var2'
));
$this->assertEquals('var1,var2,', $this->tpl->get());
// Now, we should really add a switch for keeping {stuff} in
// data supplied to setVariable() safe. Until then, removing it should
// be expected behaviour
$result = $this->tpl->setTemplate('{placeholder1},{placeholder2},{placeholder3}', true, true);
$this->tpl->setOption('preserve_input', false);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error setting template: '. $result->getMessage());
}
$this->tpl->setVariable(array(
'placeholder1' => 'var1',
'placeholder2' => 'var2',
'placeholder3' => 'var3{stuff}'
));
$this->assertEquals('var1,var2,var3', $this->tpl->get());
$result = $this->tpl->setTemplate('{placeholder1},{placeholder2},{placeholder3}', true, true);
$this->tpl->setOption('preserve_input', true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error setting template: '. $result->getMessage());
}
$this->tpl->setVariable(array(
'placeholder1' => 'var1',
'placeholder2' => 'var2',
'placeholder3' => 'var3{stuff}'
));
$this->assertEquals('var1,var2,var3{stuff}', $this->tpl->get());
}
/**
*
*/
function testTouchBlock()
{
$result = $this->tpl->loadTemplateFile('blockiteration.html', false, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->tpl->setVariable('outer', 'data');
// inner_block should be preserved in output, even if empty
$this->tpl->touchBlock('inner_block');
$this->assertEquals('data|{inner}#', $this->_stripWhitespace($this->tpl->get()));
}
// Not available in stock class
/**
*
*/
/*
function testHideBlock()
{
if (!$this->_methodExists('hideBlock')) {
return;
}
$result = $this->tpl->loadTemplateFile('blockiteration.html', false, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->tpl->setVariable(array(
'outer' => 'data',
'inner' => 'stuff'
));
// inner_block is not empty, but should be removed nonetheless
$this->tpl->hideBlock('inner_block');
$this->assertEquals('data#', $this->_stripWhitespace($this->tpl->get()));
}
*/
/**
*
*/
/*
function testSetGlobalVariable()
{
if (!$this->_methodExists('setGlobalVariable')) {
return;
}
$result = $this->tpl->loadTemplateFile('globals.html', false, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->tpl->setGlobalVariable('glob', 'glob');
// {var2} is not, block_two should be removed
$this->tpl->setVariable(array(
'var1' => 'one',
'var3' => 'three'
));
for ($i = 0; $i < 3; $i++) {
$this->tpl->setVariable('var4', $i + 1);
$this->tpl->parse('block_four');
} // for
$this->assertEquals('glob:one#glob:three|glob:1|glob:2|glob:3#', $this->_stripWhitespace($this->tpl->get()));
}
*/
/**
* Test for bug #9501. preg_replace treat $<NUM> and \<NUM> as
* backreferences. IT escapes them.
*
*/
function testBug9501()
{
$this->tpl->setTemplate("Test: {VALUE}");
$this->tpl->clearCache = true;
$this->tpl->setVariable("VALUE", '$12.34');
$this->assertEquals('Test: $12.34', $this->tpl->get());
$this->tpl->setVariable("VALUE", '$1256.34');
$this->assertEquals('Test: $1256.34', $this->tpl->get());
$this->tpl->setVariable("VALUE", '^1.34');
$this->assertEquals('Test: ^1.34', $this->tpl->get());
$this->tpl->setVariable("VALUE", '$1.34');
$this->assertEquals('Test: $1.34', $this->tpl->get());
$this->tpl->setVariable("VALUE", '\$12.34');
$this->assertEquals('Test: \$12.34', $this->tpl->get());
$this->tpl->setVariable("VALUE", "\$12.34");
$this->assertEquals('Test: $12.34', $this->tpl->get());
$this->tpl->setVariable("VALUE", "\$12.34");
$this->assertEquals('Test: $12.34', $this->tpl->get());
// $12 is not parsed as a variable as it starts with a number
$this->tpl->setVariable("VALUE", "$12.34");
$this->assertEquals('Test: $12.34', $this->tpl->get());
$this->tpl->setVariable("VALUE", "\\$12.34");
$this->assertEquals('Test: \$12.34', $this->tpl->get());
// taken from the bugreport
$word = 'Cost is $456.98';
$this->tpl->setVariable("VALUE", $word);
$this->assertEquals('Test: Cost is $456.98', $this->tpl->get());
$word = "Cost is \$" . '183.22';
$this->tpl->setVariable("VALUE", $word);
$this->assertEquals('Test: Cost is $183.22', $this->tpl->get());
}
function testBug9783 ()
{
$this->tpl->setTemplate("<!-- BEGIN entry -->{DATA} <!-- END entry -->", true, true);
$data = array ('{Bakken}', 'Soria', 'Joye');
foreach ($data as $name) {
$this->tpl->setCurrentBlock('entry');
$this->tpl->setVariable('DATA', $name);
$this->tpl->parseCurrentBlock();
}
$this->assertEquals('{Bakken} Soria Joye', trim($this->tpl->get()));
}
function testBug9853 ()
{
$this->tpl->loadTemplatefile("bug_9853_01.tpl", true, true);
$this->tpl->setVariable("VAR" , "Ok !");
$this->tpl->parse("foo1");
$this->tpl->setVariable("VAR" , "Ok !");
$this->tpl->parse("foo2");
$this->tpl->setVariable("VAR." , "Ok !");
$this->tpl->setVariable("VAR2" , "Okay");
$this->tpl->parse("bar");
$this->tpl->parse();
$output01 = $this->tpl->get();
$this->tpl->loadTemplatefile("bug_9853_02.tpl", true, true);
$this->tpl->setVariable("VAR" , "Ok !");
$this->tpl->parse("foo.");
$this->tpl->setVariable("VAR" , "Ok !");
$this->tpl->parse("foo2");
$this->tpl->setVariable("VAR." , "Ok !");
$this->tpl->setVariable("VAR2" , "Okay");
$this->tpl->parse("bar");
$this->tpl->parse();
$output02 = $this->tpl->get();
$this->assertEquals($output01, $output02);
}
/**
* Tests iterations over two blocks
*
*/
function testBlockIteration()
{
$data = array(
'a',
array('b', array('1', '2', '3', '4')),
'c',
array('d', array('5', '6', '7'))
);
$result = $this->tpl->loadTemplateFile('blockiteration.html', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
foreach ($data as $value) {
if (is_array($value)) {
$this->tpl->setVariable('outer', $value[0]);
foreach ($value[1] as $v) {
$this->tpl->setVariable('inner', $v);
$this->tpl->parse('inner_block');
}
} else {
$this->tpl->setVariable('outer', $value);
}
$this->tpl->parse('outer_block');
}
$this->assertEquals('a#b|1|2|3|4#c#d|5|6|7#', $this->_stripWhitespace($this->tpl->get()));
}
/**
*
*
*/
function testTouchBlockIteration()
{
$data = array('a','b','c','d','e');
$result = $this->tpl->loadTemplateFile('blockiteration.html', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
for ($i = 0; $i < count($data); $i++) {
$this->tpl->setVariable('outer', $data[$i]);
// the inner_block is empty and should be removed
if (0 == $i % 2) {
$this->tpl->touchBlock('inner_block');
}
$this->tpl->parse('outer_block');
}
$this->assertEquals('a|#b#c|#d#e|#', $this->_stripWhitespace($this->tpl->get()));
}
public function testShouldSetOptionsCorrectly() {
$result = $this->tpl->setOption('removeEmptyBlocks', false);
$this->assertFalse(PEAR::isError($result));
$this->assertFalse($this->tpl->removeEmptyBlocks);
$result = $this->tpl->setOption('removeEmptyBlocks', true);
$this->assertFalse(PEAR::isError($result));
$this->assertTrue($this->tpl->removeEmptyBlocks);
}
public function testPlaceholderReplacementScope() {
$result = $this->tpl->loadTemplateFile('placeholderreplacementscope.html', true, true);
if (PEAR::isError($result)) {
$this->fail('Error loading template file: ' . $result->getMessage());
}
$this->tpl->setCurrentBlock('foo');
$this->tpl->setVariable('var1','test');
$this->tpl->parseCurrentBlock();
$this->tpl->setCurrentBlock('bar');
$this->tpl->setVariable('var1','not');
$this->tpl->setVariable('var2','good');
$this->tpl->parseCurrentBlock();
$actual = $this->_stripWhitespace($this->tpl->get());
$this->assertEquals('testgood', $actual);
}
}
?>

View File

@ -0,0 +1,171 @@
<?php
require_once 'HTML/Template/ITX.php';
require_once 'PHPUnit/Framework/TestCase.php';
require_once 'ITTest.php';
function _uppercaseCallback($ary)
{
return strtoupper($ary[0]);
}
class Callbacks
{
function _lowercaseCallback($ary)
{
return strtolower($ary[0]);
}
function _numberFormatCallback($float, $decimals)
{
return number_format($float, $decimals);
}
}
class ITXTest extends ITTest
{
function setUp()
{
$this->tpl = new HTML_Template_ITX(dirname(__FILE__) . '/templates');
}
function testPlaceholderExists()
{
$this->tpl->setTemplate('{var}');
$this->assertSame("__global__", $this->tpl->placeholderExists('var'), 'Existing placeholder \'var\' reported as nonexistant');
$this->assertSame("", $this->tpl->placeholderExists('foobar'), 'Nonexistant placeholder \'foobar\' reported as existing');
$this->assertSame("__global__", $this->tpl->placeholderExists('var', '__global__'), 'Existing in block \'__global__\' placeholder \'var\' reported as nonexistant');
$this->assertSame("", $this->tpl->placeholderExists('foobar', '__global__'), 'Nonexistant in block \'__global__\' placeholder \'foobar\' reported as existing');
}
function testBlockExists()
{
$this->tpl->setTemplate('{var}');
$this->assertTrue($this->tpl->blockExists('__global__'), 'Existing block \'__global__\' reported as nonexistant');
$this->assertTrue(!$this->tpl->blockExists('foobar'), 'Nonexistant block \'foobar\' reported as existing');
}
function testAddBlock()
{
$result = $this->tpl->loadTemplatefile('blocks.html', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->tpl->addBlock('var', 'added', 'added:{new_var}');
$this->assertTrue($this->tpl->blockExists('added'), 'The new block seems to be missing');
$this->assertTrue(!$this->tpl->placeholderExists('var'), 'The old variable seems to be still present in the template');
$this->tpl->setVariable('new_var', 'new_value');
$this->assertEquals('added:new_value', $this->_stripWhitespace($this->tpl->get()));
}
function testAddBlockfile()
{
$result = $this->tpl->loadTemplatefile('blocks.html', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$result = $this->tpl->addBlockfile('var', 'added', 'addblock.html');
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error adding block from file: '. $result->getMessage());
}
$this->assertTrue($this->tpl->blockExists('added'), 'The new block seems to be missing');
$this->assertTrue(!$this->tpl->placeholderExists('var'), 'The old variable seems to be still present in the template');
$this->tpl->setVariable('new_var', 'new_value');
$this->assertEquals('added:new_value', $this->_stripWhitespace($this->tpl->get()));
}
function testReplaceBlock()
{
$result = $this->tpl->loadTemplatefile('blocks.html', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->tpl->setVariable('old_var', 'old_value');
$this->tpl->parse('old_block');
// old_block's contents should be discarded
$this->tpl->replaceBlock('old_block', 'replaced:{replaced_var}#', false);
$this->assertTrue(!$this->tpl->blockExists('old_inner_block') && !$this->tpl->placeholderExists('old_var'),
'The replaced block\'s contents seem to be still present');
$this->tpl->setVariable('replaced_var', 'replaced_value');
$this->tpl->parse('old_block');
// this time old_block's contents should be preserved
$this->tpl->replaceBlock('old_block', 'replaced_again:{brand_new_var}', true);
$this->tpl->setVariable('brand_new_var', 'brand_new_value');
$this->assertEquals('replaced:replaced_value#replaced_again:brand_new_value', $this->_stripWhitespace($this->tpl->get()));
}
function testReplaceBlockfile()
{
$result = $this->tpl->loadTemplatefile('blocks.html', true, true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error loading template file: '. $result->getMessage());
}
$this->tpl->setVariable('old_var', 'old_value');
$this->tpl->parse('old_block');
// old_block's contents should be discarded
$result = $this->tpl->replaceBlockfile('old_block', 'replaceblock.html', false);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error replacing block from file: '. $result->getMessage());
}
$this->assertTrue(!$this->tpl->blockExists('old_inner_block') && !$this->tpl->placeholderExists('old_var'),
'The replaced block\'s contents seem to be still present');
$this->tpl->setVariable(array(
'replaced_var' => 'replaced_value',
'replaced_inner_var' => 'inner_value'
));
$this->tpl->parse('old_block');
// this time old_block's contents should be preserved
$result = $this->tpl->replaceBlockfile('old_block', 'addblock.html', true);
if (PEAR::isError($result)) {
$this->assertTrue(false, 'Error replacing block from file: '. $result->getMessage());
}
$this->tpl->setVariable('new_var', 'again');
$this->assertEquals('replaced:replaced_value|inner_value#added:again', $this->_stripWhitespace($this->tpl->get()));
}
function testCallback()
{
$this->tpl->setTemplate('callback:func_uppercase(word)');
$this->tpl->setCallbackFunction('uppercase', '_uppercaseCallback');
$res = $this->tpl->performCallback();
if (PEAR::isError($res)) {
$this->assertTrue(false, 'Error performing callback: '. $res->getMessage());
}
$this->assertEquals('callback:WORD', $this->tpl->get());
$this->tpl->setTemplate('callback:func_lowercase(Word)');
$this->tpl->setCallbackFunction('lowercase', array('Callbacks','_lowercaseCallback'));
$res = $this->tpl->performCallback();
if (PEAR::isError($res)) {
$this->assertTrue(false, 'Error performing callback: '. $res->getMessage());
}
$this->assertEquals('callback:word', $this->tpl->get());
$this->tpl->setTemplate('callback:func_lowercase(Word)');
$this->tpl->setCallbackFunction('lowercase', array(new Callbacks,'_lowercaseCallback'));
$res = $this->tpl->performCallback();
if (PEAR::isError($res)) {
$this->assertTrue(false, 'Error performing callback: '. $res->getMessage());
}
$this->assertEquals('callback:word', $this->tpl->get());
$this->tpl->setTemplate('callback:func_numberFormat(1.5, 2)');
$this->tpl->setCallbackFunction('numberFormat', array('Callbacks', '_numberFormatCallback'), '', true);
$res = $this->tpl->performCallback();
if (PEAR::isError($res)) {
$this->assertTrue(false, 'Error performing callback: '. $res->getMessage());
}
$this->assertEquals('callback:1.50', $this->tpl->get());
$this->tpl->setTemplate('callback:func_numberFormat(1.5, 2)');
$GLOBALS['obj'] = new Callbacks;
$this->tpl->setCallbackFunction('numberFormat', '_numberFormatCallback', 'obj', true);
$res = $this->tpl->performCallback();
if (PEAR::isError($res)) {
$this->assertTrue(false, 'Error performing callback: '. $res->getMessage());
}
$this->assertEquals('callback:1.50', $this->tpl->get());
}
}
?>

View File

@ -0,0 +1 @@
Included file

View File

@ -0,0 +1 @@
added:{new_var}

View File

@ -0,0 +1,7 @@
<!-- BEGIN outer_block -->
{outer}
<!-- BEGIN inner_block -->
|{inner}
<!-- END inner_block -->
#
<!-- END outer_block -->

View File

@ -0,0 +1,8 @@
{var}
<!-- BEGIN old_block -->
old:{old_var}
<!-- BEGIN old_inner_block -->
|{old_inner_var}
<!-- END old_inner_block -->
#
<!-- END old_block -->

View File

@ -0,0 +1,20 @@
############ TEST ################
before foo1 bloc
<!-- BEGIN foo1 -->
In foo1...{VAR}
<!-- END foo1 -->
after foo1 bloc
before foo2 bloc
<!-- BEGIN foo2 -->
In foo2...{VAR}
<!-- END foo2 -->
after foo2 bloc
before bar bloc
<!-- BEGIN bar -->
In bar...{VAR.}
In bar...{VAR2}
<!-- END bar -->
after bar bloc

View File

@ -0,0 +1,20 @@
############ TEST ################
before foo1 bloc
<!-- BEGIN foo. -->
In foo1...{VAR}
<!-- END foo. -->
after foo1 bloc
before foo2 bloc
<!-- BEGIN foo2 -->
In foo2...{VAR}
<!-- END foo2 -->
after foo2 bloc
before bar bloc
<!-- BEGIN bar -->
In bar...{VAR.}
In bar...{VAR2}
<!-- END bar -->
after bar bloc

View File

@ -0,0 +1,13 @@
<!-- BEGIN block_one -->
{glob}:{var1}#
<!-- END block_one -->
<!-- BEGIN block_two -->
{glob}:{var2}#
<!-- END block_two -->
<!-- BEGIN block_three -->
{glob}:{var3}
<!-- BEGIN block_four -->
|{glob}:{var4}
<!-- END block_four -->
#
<!-- END block_three -->

View File

@ -0,0 +1 @@
Master file; <!-- INCLUDE __include.html -->

View File

@ -0,0 +1 @@
A template

View File

@ -0,0 +1,8 @@
<!-- BEGIN foo -->
{var1}
<!-- END foo -->
<!-- BEGIN bar -->
{var2}
<!-- END bar -->

View File

@ -0,0 +1,5 @@
replaced:{replaced_var}
<!-- BEGIN new_inner_block -->
|{replaced_inner_var}
<!-- END new_inner_block -->
#

335
package.xml Normal file
View File

@ -0,0 +1,335 @@
<?xml version="1.0" encoding="UTF-8"?>
<package packagerversion="1.9.0" version="2.0" xmlns="http://pear.php.net/dtd/package-2.0" xmlns:tasks="http://pear.php.net/dtd/tasks-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://pear.php.net/dtd/tasks-1.0 http://pear.php.net/dtd/tasks-1.0.xsd http://pear.php.net/dtd/package-2.0 http://pear.php.net/dtd/package-2.0.xsd">
<name>HTML_Template_IT</name>
<channel>pear.php.net</channel>
<summary>Integrated Templates</summary>
<description>HTML_Template_IT is a templating engine designed to allow easy separation of concerns. It does this by clearly separating the presentational code from the PHP code. The presentation code may be of any format, however generally XML or HTML is used.
This engine works on the foundation of blocks and placeholders. It uses the hierarchy of blocks to determine which presentational code is instantiated when blocks are parsed. The placeholders allow the insertion of &quot;dynamic&quot; information.
There are two classes to use for templating. HTML_Template_IT is used for basic templating needs. HTML_Template_ITX gives you full power over the templating engine, allowing blocks to be added, and function callbacks to be used.</description>
<lead>
<name>Gregory Currie</name>
<user>gregorycu</user>
<email>gregorycu@php.net</email>
<active>yes</active>
</lead>
<lead>
<name>Pierre-Alain Joye</name>
<user>pajoye</user>
<email>pajoye@php.net</email>
<active>no</active>
</lead>
<lead>
<name>David Soria Parra</name>
<user>dsp</user>
<email>dsp@php.net</email>
<active>no</active>
</lead>
<developer>
<name>Thorsten Rinne</name>
<user>thorstenr</user>
<email>thorstenr@php.net</email>
<active>no</active>
</developer>
<developer>
<name>Ulf Wendel</name>
<user>uw</user>
<email>ulf.wendel@phpdoc.de</email>
<active>no</active>
</developer>
<date>2010-03-10</date>
<time>19:08:10</time>
<version>
<release>1.3.0</release>
<api>1.3.0</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<license>Modified BSD license</license>
<notes>
Changes since last stable release (1.2.1):
- Add support for pear package 2.0 format
- Remove support for pear package 1.0 format
- Fix bug #9501, doller signs disapear if preg_match is used.
- Fix bug #9783, don&apos;t remove variable which values follow the variable pattern
To allow backwards compatbility an option preserve_input is added.
If it is false, the old behaviour will be used and therefore those values will be deleted.
Default is true, so new behaviour.
- Fix bug #9853, problems with dots in placeholders or blocknames
- Fix bug #13935, docblock is wrong
- Fix bug #17129
- Add option &apos;preserve_input&apos; to only remove unkown variable that were present
during setTemplate or loadTemplatefile
which is the behaviour before 1.3.0a1
- Improved PHPCS (Request #15039)
- Added unit tests
- Fixed unit tests
</notes>
<contents>
<dir name="/">
<file md5sum="157f1b27090288fbce921b762697c3f4" name="examples/sample_it.php" role="doc" />
<file md5sum="1d2363fa8640780392af6c51e9c3713f" name="examples/sample_itx_addblockfile.php" role="doc" />
<file md5sum="43a3535aa4d5e9df400babae53d82a08" name="examples/templates/addblockfile_list.tpl.htm" role="doc" />
<file md5sum="16f4927420fa169875167a4874e7add7" name="examples/templates/addblockfile_main.tpl.htm" role="doc" />
<file md5sum="2c851fcec88007eef66c28a9d8f10ceb" name="examples/templates/main.tpl.htm" role="doc" />
<file md5sum="886a6044e8186e3b1e1d8c5b004246af" name="HTML/Template/IT.php" role="php" />
<file md5sum="16b0300b5fbe3be7a1df976ce5d27c4f" name="HTML/Template/ITX.php" role="php" />
<file md5sum="484d2aa6a504a351a1d3e2b8bb39612d" name="HTML/Template/IT_Error.php" role="php" />
<file md5sum="e576a94c06b323e4cfc6bcf9dda017c2" name="tests/AllTests.php" role="test" />
<file md5sum="adabbbb8cf54dc80720b7929e594cbec" name="tests/ITTest.php" role="test" />
<file md5sum="80139a8b443488dac801fae748b6f2c2" name="tests/ITXTest.php" role="test" />
<file md5sum="e50de49b74a1d96bb77ddae2d0abdfc3" name="tests/templates/addblock.html" role="test" />
<file md5sum="22e56437378e53d08ba07d3dd2aa4b85" name="tests/templates/blockiteration.html" role="test" />
<file md5sum="4173bf97eec43787532e247ef9b2611a" name="tests/templates/blocks.html" role="test" />
<file md5sum="7014497a69b346957fb3d2b5fa44ffd4" name="tests/templates/bug_9853_01.tpl" role="test" />
<file md5sum="385013ff6be875da2888087e96c6a93c" name="tests/templates/bug_9853_02.tpl" role="test" />
<file md5sum="2611d6ec574a65716f1bc2ca95cb8c63" name="tests/templates/globals.html" role="test" />
<file md5sum="db5b226eff0218c831749c07042529f2" name="tests/templates/include.html" role="test" />
<file md5sum="d9a6425eebdfc6981465b4a228dbee51" name="tests/templates/loadtemplatefile.html" role="test" />
<file md5sum="8747e8c70d20b6c86d1d19af2eadd874" name="tests/templates/placeholderreplacementscope.html" role="test" />
<file md5sum="5c7e2e9c32306db4b6667d2b57f1c0ac" name="tests/templates/replaceblock.html" role="test" />
<file md5sum="310552db4653b34dbb0f993847572fc5" name="tests/templates/__include.html" role="test" />
<file md5sum="7073f9a84fa6da71e7a505a777dda302" name="LICENSE" role="doc" />
</dir>
</contents>
<dependencies>
<required>
<php>
<min>4.0.0</min>
</php>
<pearinstaller>
<min>1.4.0b1</min>
</pearinstaller>
</required>
</dependencies>
<phprelease />
<changelog>
<release>
<version>
<release>1.1</release>
<api>1.1</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2003-03-11</date>
<license>Modified BSD license</license>
<notes>
*BETA* release.
</notes>
</release>
<release>
<version>
<release>1.1.1</release>
<api>1.1.1</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2003-08-21</date>
<license>Modified BSD license</license>
<notes>
- fix #4590, case sensitive method name getFile fix
- fix #1453, haltOnWarning fix, wrong property name called
- fix #3952, return IT_OK on success in setOptions
</notes>
</release>
<release>
<version>
<release>1.1.2</release>
<api>1.1.2</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2005-10-28</date>
<license>Modified BSD license</license>
<notes>
- Comply better with the coding standards (dufuz@php.net)
- Fixed Bug #5774 ITX-&gt;buildFunctionlist, forced to use {} as delimiters
instead of the user defined once (dufuz@php.net)
- Fixed Bug #5642 Undefined variable: blockname (dufuz@php.net)
</notes>
</release>
<release>
<version>
<release>1.1.3</release>
<api>1.1.3</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2005-11-01</date>
<license filesource="LICENSE">Modified BSD license</license>
<notes>
- Change to the new BSD License
(see http://www.opensource.org/licenses/bsd-license.php)
</notes>
</release>
<release>
<version>
<release>1.1.4</release>
<api>1.1.4</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2006-04-12</date>
<license>Modified BSD license</license>
<notes>
- #6084, fread raises warning when used with empty files
- #7359, remove notices when a block is not yet defined
- fix a bug introduced with some cleanup commit, in some cases,
callbacks did not work anymore
</notes>
</release>
<release>
<version>
<release>1.1.5</release>
<api>1.1.5</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2006-06-13</date>
<license>Modified BSD license</license>
<notes>
- #7611, wrong array initialized, the same object cannot be
used for multiple templates
</notes>
</release>
<release>
<version>
<release>1.2.0</release>
<api>1.2.0</api>
</version>
<stability>
<release>beta</release>
<api>beta</api>
</stability>
<date>2006-08-17</date>
<license>Modified BSD license</license>
<notes>
- Deprecate $callbackobject parameter in setCallbackFunction
- Introduce $expandCallbackParameters parameter to setCallbackFunction to support
callbacks that expect to get the parameters in a regular way, not as an array
- #7651, allow dots in placeholder and block names
</notes>
</release>
<release>
<version>
<release>1.2.1</release>
<api>1.2.1</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2006-08-25</date>
<license>Modified BSD license</license>
<notes>
- Deprecate $callbackobject parameter in setCallbackFunction
- Introduce $expandCallbackParameters parameter to setCallbackFunction to support
callbacks that expect to get the parameters in a regular way, not as an array
- #7651, allow dots in placeholder and block names
- #7611, wrong array initialized, the same object cannot be
used for multiple templates
</notes>
</release>
<release>
<version>
<release>1.3.0a1</release>
<api>1.2.1</api>
</version>
<stability>
<release>alpha</release>
<api>stable</api>
</stability>
<date>2010-02-15</date>
<license>Modified BSD license</license>
<notes>
- Add support for pear package 2.0 format
- Remove support for pear package 1.0 format
- Fix bug #9501, doller signs disapear if preg_match is used.
- Fix bug #9783, don&apos;t remove variable which values follow the variable pattern
To allow backwards compatbility an option preserve_input is added.
If it is false, the old behaviour will be used and therefore those values will be deleted.
Default is true, so new behaviour.
- Fix bug #9853, problems with dots in placeholders or blocknames
- Add option &apos;preserve_input&apos; to only remove unkown variable that were present during setTemplate or lodaTemplatefile
which is the behaviour before 1.3.0a1
- Fix bug #13935 - docblock is wrong
- Improved PHPCS (Request #15039)
</notes>
</release>
<release>
<version>
<release>1.3.0a2</release>
<api>1.3.0</api>
</version>
<stability>
<release>alpha</release>
<api>stable</api>
</stability>
<date>2010-02-16</date>
<license>Modified BSD license</license>
<notes>
Fixed unit tests
</notes>
</release>
<release>
<version>
<release>1.3.0a3</release>
<api>1.3.0</api>
</version>
<stability>
<release>alpha</release>
<api>stable</api>
</stability>
<date>2010-03-01</date>
<license>Modified BSD license</license>
<notes>
- Fix bug #17129
- Added unit test
</notes>
</release>
<release>
<version>
<release>1.3.0</release>
<api>1.3.0</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<date>2010-03-10</date>
<license>Modified BSD license</license>
<notes>
Changes since last stable release (1.2.1):
- Add support for pear package 2.0 format
- Remove support for pear package 1.0 format
- Fix bug #9501, doller signs disapear if preg_match is used.
- Fix bug #9783, don&apos;t remove variable which values follow the variable pattern
To allow backwards compatbility an option preserve_input is added.
If it is false, the old behaviour will be used and therefore those values will be deleted.
Default is true, so new behaviour.
- Fix bug #9853, problems with dots in placeholders or blocknames
- Fix bug #13935, docblock is wrong
- Fix bug #17129
- Add option &apos;preserve_input&apos; to only remove unkown variable that were present
during setTemplate or loadTemplatefile
which is the behaviour before 1.3.0a1
- Improved PHPCS (Request #15039)
- Added unit tests
- Fixed unit tests
</notes>
</release>
</changelog>
</package>