HTML_Template_IT::touchBlock() -- Verhindert das Entfernen eines leeren Blocks beim Parsen
Beschreibung
Ein mit touchBlock() markierter, leerer Block wird beim Parsen nicht entfernt, selbst wenn
$removeEmptyBlocks TRUE ist. Nicht gesetzte Platzhalter bleiben ebenfalls erhalten.
Rückgabewert
boolean -
Wenn TRUE existiert der Block im geladenen Template. Andernfalls wird ein IT_Error zurückgegeben.
Beispiel
Beispiel 42-1. 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> |
|
Beispiel 42-2. 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", true, true);
// 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();
?> |
|
Fehler-Meldungen
Tabelle 42-1. Mögliche Fehler-Arten
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.
|
Hinweise
Diese Methode kann nicht
statisch aufgerufen werden.