HTML_Template_IT::parse()

HTML_Template_IT::parse() -- parse a block

Synopsis

      require_once 'HTML/Template/IT.php';

void HTML_Template_IT::parse ( string $block = "__global__" , boolean $flag_recursion = FALSE )

Description

Parses the defined block, performs all substitutions and appends the result to already parsed blocks.

Parameter

string $block - block to parse. When not set the complete template is used.
boolean $flag_recursion - Used internally. Can be ignored

Return value

boolean - Returns TRUE if there was no placeholder to substitute, otherwise FALSE or IT_Error.

Example

The template cvsnames.tpl.htm

     
<html>
 <table>
<!-- BEGIN row -->
  <tr>
   <td>
    {CVS_USERNAME}
   </td>
   <td> 
    {REALNAME}
   </td>
  </tr>
<!-- END row -->
 </table>
</html>

The script

     
<?php
  require_once "HTML/Template/IT.php";

  $data = array
  (
    "0" => array("cvs_username" => "pajoye", 
                 "realname" => "Pierre-Alain Joye"),
    "1" => array("cvs_username" => "dsp",
                 "realname" => "David Soria Parra")
  );

  $tpl = new HTML_Template_IT("./templates");

  $tpl->loadTemplatefile("cvsnames.tpl.htm", true, true);

  foreach($data as $name) {

     $tpl->setVariable("CVS_USERNAME", $name["cvs_username"]);
     $tpl->setVariable("REALNAME", $name["realname"]);

     $tpl->parse("row");
  }

  // show() parses the __global__ block and
  // print the output
  $tpl->show();

?>

Throws

Possible PEAR_Error values

Error code	Error message	Reason	Solution
IT_BLOCK_NOT_FOUND	" Cannot find this block `block` "	The given block does not exists.	Check for typing mistakes in the argument.

Note

This function can not be called statically.

See

HTML_Template_it::parseCurrentBlock()


HTML_Template_IT::loadTemplatefile()	HTML_Template_IT::parseCurrentBlock()

HTML_Template_IT

PEAR Manual


HTML_Template_IT::loadTemplatefile()	HTML_Template_IT::parseCurrentBlock()

HTML_Template_IT

PEAR Manual