Sets the main page content value for later use.

Given the nature of the Drupal page handling, this will be called once with a string or array. We store that and return it later as the block is being displayed.

Parameters

$content: A string or renderable array representing the body of the page.

Return value

If called without $content, a renderable array representing the body of the page.

5 calls to drupal_set_page_content()
drupal_deliver_html_page in includes/common.inc
Packages and sends the result of a page callback to the browser as HTML.
drupal_render_page in includes/common.inc
Renders the page, including all theming.
system_batch_page in modules/system/system.admin.inc
Default page callback for batches.
system_block_view in modules/system/system.module
Implements hook_block_view().
system_test_page_build in modules/simpletest/tests/system_test.module
Implements hook_page_build().

File

includes/common.inc, line 5749
Common functions that many Drupal modules will need to reference.

Code

function drupal_set_page_content($content = NULL) {
  $content_block =& drupal_static(__FUNCTION__, NULL);
  $main_content_display =& drupal_static('system_main_content_added', FALSE);
  if (!empty($content)) {
    $content_block = is_array($content) ? $content : array(
      'main' => array(
        '#markup' => $content,
      ),
    );
  }
  else {

    // Indicate that the main content has been requested. We assume that
    // the module requesting the content will be adding it to the page.
    // A module can indicate that it does not handle the content by setting
    // the static variable back to FALSE after calling this function.
    $main_content_display = TRUE;
    return $content_block;
  }
}