You are here

function drupal_set_title in Drupal 7

Same name and namespace in other branches
  1. 4 includes/path.inc \drupal_set_title()
  2. 5 includes/path.inc \drupal_set_title()
  3. 6 includes/path.inc \drupal_set_title()

Sets the title of the current page.

The title is displayed on the page and in the title bar.

Parameters

$title: Optional string value to assign to the page title; or if set to NULL (default), leaves the current title unchanged.

$output: Optional flag - normally should be left as CHECK_PLAIN. Only set to PASS_THROUGH if you have already removed any possibly dangerous code from $title using a function like check_plain() or filter_xss(). With this flag the string will be passed through unchanged.

Return value

The updated title of the current page.

67 calls to drupal_set_title()
aggregator_page_source in modules/aggregator/aggregator.pages.inc
Page callback: Displays all the items captured from the particular feed.
authorize_access_denied_page in ./authorize.php
Renders a 403 access denied page for authorize.php.
authorize_run_operation in includes/authorize.inc
Runs the operation specified in $_SESSION['authorize_operation'].
block_admin_configure in modules/block/block.admin.inc
Form constructor for the block configuration form.
blog_page_user in modules/blog/blog.pages.inc
Menu callback; displays a Drupal page containing recent blog entries of a given user.

... See full list

File

includes/bootstrap.inc, line 2166
Functions that need to be loaded on every Drupal request.

Code

function drupal_set_title($title = NULL, $output = CHECK_PLAIN) {
  $stored_title =& drupal_static(__FUNCTION__);
  if (isset($title)) {
    $stored_title = $output == PASS_THROUGH ? $title : check_plain($title);
  }
  return $stored_title;
}