Define a configuration form for a block.

Parameters

$delta: Which block is being configured. This is a unique identifier for the block within the module, defined in hook_block_info().

Return value

A configuration form, if one is needed for your block beyond the standard elements that the block module provides (block title, visibility, etc.).

For a detailed usage example, see block_example.module.

See also

hook_block_info()

hook_block_save()

Related topics

10 functions implement hook_block_configure()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

aggregator_block_configure in modules/aggregator/aggregator.module

Implements hook_block_configure().

block_block_configure in modules/block/block.module

Implements hook_block_configure().

blog_block_configure in modules/blog/blog.module

Implements hook_block_configure().

book_block_configure in modules/book/book.module

Implements hook_block_configure().

comment_block_configure in modules/comment/comment.module

Implements hook_block_configure().

... See full list

1 invocation of hook_block_configure()

block_admin_configure in modules/block/block.admin.inc

Form constructor for the block configuration form.

File

modules/block/block.api.php, line 157

Code

function hook_block_configure($delta = '') {
    // This example comes from node.module.
    $form = array();
    if ($delta == 'recent') {
        $form['node_recent_block_count'] = array(
            '#type' => 'select',
            '#title' => t('Number of recent content items to display'),
            '#default_value' => variable_get('node_recent_block_count', 10),
            '#options' => drupal_map_assoc(array(
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9,
                10,
                11,
                12,
                13,
                14,
                15,
                16,
                17,
                18,
                19,
                20,
                25,
                30,
            )),
        );
    }
    return $form;
}

---