PEAR Manual
Prev		Next

addBlockfile()

addBlockfile() -- Adds a block contained in the file to the template

Synopsis

require_once 'HTML/Template/Sigma.php';

mixed HTML_Template_Sigma::addBlockfile (string $placeholder, string $block, string $filename)

Adds a block taken from a file to the template, changing a variable placeholder to a block placeholder.

return SIGMA_OK on success, error object on failure

Table 40-1. Possible PEAR_Error values

Error code	Error message	Reason	Solution
`SIGMA_BLOCK_EXISTS`	Block '`$block`' already exists	Tried to add a block with a name that is already present in the template	Choose a different name for a new block
`SIGMA_PLACEHOLDER_NOT_FOUND`	Variable placeholder '`$placeholder`' not found	There is no placeholder to replace by a new block in the template	Check the spelling of the placeholder name
`SIGMA_PLACEHOLDER_DUPLICATE`	Placeholder '`$placeholder`' should be unique, found in multiple blocks	A placeholder to be replaced by a new block should appear only in one place	Check the spelling of the placeholder name, choose a different placeholder
`SIGMA_TPL_NOT_FOUND`	Cannot read the template file '`$filename`'	File is unreadable for some reason	Check if the file exists and has correct permissions set
`SIGMA_CACHE_ERROR`	Cannot save template file 'filename'	A prepared template file cannot be saved	Check if the directory for prepared templates cache exists and is writeable for your script
`SIGMA_BLOCK_DUPLICATE`	The name of a block must be unique within a template. Block 'blockname' found twice.	The added file contains a block that has the same name as the existing one	Check the file and rename the block to something else
`SIGMA_CALLBACK_SYNTAX_ERROR`	Cannot parse template function: (error description)	Bogus syntax for template function parameters.	Fix the template function definition, pay special attention to quoting rules.

This function can not be called statically.

Prev	Home	Next
addBlock()	Up	blockExists()