From 83c329fc8975d7a89b1cbc2d827fd8aea7b617bd Mon Sep 17 00:00:00 2001 From: Jennifer Hodgdon Date: Tue, 13 Aug 2013 07:51:08 -0700 Subject: Issue #2044791 by skipyT, alexandre.todorov, joachim: Clarify documentation of hook_block_view around empty return values --- modules/block/block.api.php | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'modules/block') diff --git a/modules/block/block.api.php b/modules/block/block.api.php index e63994ebd..d8e129e2f 100644 --- a/modules/block/block.api.php +++ b/modules/block/block.api.php @@ -200,11 +200,13 @@ function hook_block_save($delta = '', $edit = array()) { * within the module, defined in hook_block_info(). * * @return - * An array containing the following elements: + * Either an empty array so the block will not be shown or an array containing + * the following elements: * - subject: The default localized title of the block. If the block does not * have a default title, this should be set to NULL. * - content: The content of the block's body. This may be a renderable array - * (preferable) or a string containing rendered HTML content. + * (preferable) or a string containing rendered HTML content. If the content + * is empty the block will not be shown. * * For a detailed usage example, see block_example.module. * -- cgit v1.2.3