pnBlockShow

set configuration variable

Synopsis

string pnBlockShow(modname, block, blockinfo);

Description

pnBlockShow() gets the output of a block by calling its 'block_display' function.

Parameters

modname

The well-known name of a module to display the block from. This parameter can be left empty, or set to 'Core' to display core blocks.

block

The name of the block to load

blockinfo

An associative array of parameters to pass to the block display function. The exact number and type of parameter is block-dependent.

Return Values

This function returns the output of the block display function is if it succeeds, or void if an exception was raised.

Exceptions

This function raises BAD_PARAM if you pass an invalid parameter. This function raises DATABASE_ERROR if an error occurs while querying data. This function raises ID_NOT_EXIST if the block is unknown. This function raises MODULE_FILE_NOT_EXIST if the block file doesn't exist.

Notes

TODO: nail down the block standards. Note that the PostNuke block standards state that blocks called in this way have to return output themselves. Especially, they need to implement the '{$modname}_{$block}block_display' function.

See Also

pnBlockLoad()