wp_get_document_title() – Returns document title for the current page.

You appear to be a bot. Output may be restricted

Description

Returns document title for the current page.

Usage

$string = wp_get_document_title();

Parameters

Returns

string Tag with the document title.

Source

File name: wordpress/wp-includes/general-template.php
Lines:

1 to 100 of 122
function wp_get_document_title() {

  
/**
 * Filters the document title before it is generated.
 *
 * Passing a non-empty value will short-circuit wp_get_document_title(),
 * returning that value instead.
 *
 * @since 4.4.0
 *
 * @param string $title The document title. Default empty string.
 */
  $title = apply_filters( 'pre_get_document_title', '' );
  if ( ! empty( $title ) ) {
    return $title;
  }

  global $page, $paged;

  $title = array(
    'title' => '',
  );

  // If it's a 404 page, use a "Page not found" title.
  if ( is_404() ) {
    $title['title'] = __( 'Page not found' );

    // If it's a search, use a dynamic search results title.
  } elseif ( is_search() ) {
    /* translators: %s: Search query. */
    $title['title'] = sprintf( __( 'Search Results for “%s”' ), get_search_query() );

    // If on the front page, use the site title.
  } elseif ( is_front_page() ) {
    $title['title'] = get_bloginfo( 'name', 'display' );

    // If on a post type archive, use the post type archive title.
  } elseif ( is_post_type_archive() ) {
    $title['title'] = post_type_archive_title( '', false );

    // If on a taxonomy archive, use the term title.
  } elseif ( is_tax() ) {
    $title['title'] = single_term_title( '', false );

    /*
		* If we're on the blog page that is not the homepage
		* or a single post of any post type, use the post title.
		*/
  } elseif ( is_home() || is_singular() ) {
    $title['title'] = single_post_title( '', false );

    // If on a category or tag archive, use the term title.
  } elseif ( is_category() || is_tag() ) {
    $title['title'] = single_term_title( '', false );

    // If on an author archive, use the author's display name.
  } elseif ( is_author() && get_queried_object() ) {
    $author         = get_queried_object();
    $title['title'] = $author->display_name;

    // If it's a date archive, use the date as the title.
  } elseif ( is_year() ) {
    $title['title'] = get_the_date( _x( 'Y', 'yearly archives date format' ) );

  } elseif ( is_month() ) {
    $title['title'] = get_the_date( _x( 'F Y', 'monthly archives date format' ) );

  } elseif ( is_day() ) {
    $title['title'] = get_the_date();
  }

  // Add a page number if necessary.
  if ( ( $paged >= 2 || $page >= 2 ) && ! is_404() ) {
    /* translators: %s: Page number. */
    $title['page'] = sprintf( __( 'Page %s' ), max( $paged, $page ) );
  }

  // Append the description or site title to give context.
  if ( is_front_page() ) {
    $title['tagline'] = get_bloginfo( 'description', 'display' );
  } else {
    $title['site'] = get_bloginfo( 'name', 'display' );
  }

  
/**
 * Filters the separator for the document title.
 *
 * @since 4.4.0
 *
 * @param string $sep Document title separator. Default '-'.
 */
  $sep = apply_filters( 'document_title_separator', '-' );

  
/**
 * Filters the parts of the document title.
 *
 * @since 4.4.0
 *
 * @param array $title {
 *     The document title parts.
 

 View on GitHub View on Trac