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.

Gibt einen Block mit nach allen Ersetzungen aus (Previous) HTML_Template_PHPLIB (Next)
Last updated: Sun, 19 Dec 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.