function block_load

Loads a block object from the database.

This function returns the first block matching the module and delta parameters, so it should not be used for theme-specific functionality.


$module: Name of the module that implements the block to load.

$delta: Unique ID of the block within the context of $module. Pass NULL to return an empty block object for $module.

Return value

A block object.

3 calls to block_load()
block_admin_configure in modules/block/
Form constructor for the block configuration form.
block_custom_block_delete in modules/block/
Form constructor for the custom block deletion form.
StatisticsReportsTestCase::testPopularContentBlock in modules/statistics/statistics.test
Tests the "popular content" block.


modules/block/block.module, line 710


function block_load($module, $delta) {
    if (isset($delta)) {
        $block = db_query('SELECT * FROM {block} WHERE module = :module AND delta = :delta', array(
            ':module' => $module,
            ':delta' => $delta,
    // If the block does not exist in the database yet return a stub block
    // object.
    if (empty($block)) {
        $block = new stdClass();
        $block->module = $module;
        $block->delta = $delta;
    return $block;

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.