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.

Parameters

$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 drupal/modules/block/block.admin.inc
Form constructor for the block configuration form.
block_custom_block_delete in drupal/modules/block/block.admin.inc
Form constructor for the custom block deletion form.
StatisticsReportsTestCase::testPopularContentBlock in drupal/modules/statistics/statistics.test
Tests the "popular content" block.

File

drupal/modules/block/block.module, line 711
Controls the visual building blocks a page is constructed with.

Code

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,
    ))
      ->fetchObject();
  }

  // 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;
}