HTML_Template_IT::touchBlock()

HTML_Template_IT::touchBlock() – Verhindert das Entfernen eines leeren Blocks beim Parsen

Synopsis

require_once 'HTML/Template/IT.php';

boolean HTML_Template_IT::touchBlock ( string $block )

Description

Ein mit touchBlock() markierter, leerer Block wird beim Parsen nicht entfernt, selbst wenn $removeEmptyBlocks TRUE ist. Nicht gesetzte Platzhalter bleiben ebenfalls erhalten.

Parameter

  • string $block - Der Name des zu markierenden Blocks.

Return value

boolean - Wenn TRUE existiert der Block im geladenen Template. Andernfalls wird ein IT_Error zurückgegeben.

Example

Das Template - login.tpl.htm

<html>
<body>
<!-- BEGIN login_successfull -->
You have logged in successfully!
<!-- END login_successfull -->
<!-- BEGIN login_failed -->
Login failed
<!-- END login_failed -->
</body>
</html>

Das Script

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

  
// Remove blocks with no placeholders, or no placeholders set ($removeEmptyBlocks=true)
  
$tpl->loadTemplatefile("login.tpl.htm"truetrue);

  
// hypothetical
  
if (login_successfull($username$password)) {
    
// print login_successfull block.
    // login_failed is removed, due to $removeEmptyBlocks = true
    
$tpl->touchBlock("login_successfull");
  } else {
    
$tpl->touchBlock("login_failed");
  }
  
$tpl->show();

?>

Throws

Possible PEAR_Error values
Error code Error message Reason Solution
IT_BLOCK_NOT_FOUND " Cannot find this block block " Der angegebene Block existiert im geladenen Template nicht. Überprüfen Sie, ob der Blockname richtig geschrieben ist.

Note

This function can not be called statically.