get_the_archive_title() – Retrieve the archive title based on the queried object.

You appear to be a bot. Output may be restricted

Description

Retrieve the archive title based on the queried object.

Usage

$string = get_the_archive_title();

Parameters

Returns

string Archive title.

Source

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

1 to 89 of 89
function get_the_archive_title() {
  $title  = __( 'Archives' );
  $prefix = '';

  if ( is_category() ) {
    $title  = single_cat_title( '', false );
    $prefix = _x( 'Category:', 'category archive title prefix' );
  } elseif ( is_tag() ) {
    $title  = single_tag_title( '', false );
    $prefix = _x( 'Tag:', 'tag archive title prefix' );
  } elseif ( is_author() ) {
    $title  = get_the_author();
    $prefix = _x( 'Author:', 'author archive title prefix' );
  } elseif ( is_year() ) {
    $title  = get_the_date( _x( 'Y', 'yearly archives date format' ) );
    $prefix = _x( 'Year:', 'date archive title prefix' );
  } elseif ( is_month() ) {
    $title  = get_the_date( _x( 'F Y', 'monthly archives date format' ) );
    $prefix = _x( 'Month:', 'date archive title prefix' );
  } elseif ( is_day() ) {
    $title  = get_the_date( _x( 'F j, Y', 'daily archives date format' ) );
    $prefix = _x( 'Day:', 'date archive title prefix' );
  } elseif ( is_tax( 'post_format' ) ) {
    if ( is_tax( 'post_format', 'post-format-aside' ) ) {
      $title = _x( 'Asides', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-gallery' ) ) {
      $title = _x( 'Galleries', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-image' ) ) {
      $title = _x( 'Images', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-video' ) ) {
      $title = _x( 'Videos', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-quote' ) ) {
      $title = _x( 'Quotes', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-link' ) ) {
      $title = _x( 'Links', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-status' ) ) {
      $title = _x( 'Statuses', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-audio' ) ) {
      $title = _x( 'Audio', 'post format archive title' );
    } elseif ( is_tax( 'post_format', 'post-format-chat' ) ) {
      $title = _x( 'Chats', 'post format archive title' );
    }
  } elseif ( is_post_type_archive() ) {
    $title  = post_type_archive_title( '', false );
    $prefix = _x( 'Archives:', 'post type archive title prefix' );
  } elseif ( is_tax() ) {
    $queried_object = get_queried_object();
    if ( $queried_object ) {
      $tax    = get_taxonomy( $queried_object->taxonomy );
      $title  = single_term_title( '', false );
      $prefix = sprintf(
        /* translators: %s: Taxonomy singular name. */
        _x( '%s:', 'taxonomy term archive title prefix' ),
        $tax->labels->singular_name
      );
    }
  }

  $original_title = $title;

  
/**
 * Filters the archive title prefix.
 *
 * @since 5.5.0
 *
 * @param string $prefix Archive title prefix.
 */
  $prefix = apply_filters( 'get_the_archive_title_prefix', $prefix );
  if ( $prefix ) {
    $title = sprintf(
      /* translators: 1: Title prefix. 2: Title. */
      _x( '%1$s %2$s', 'archive title' ),
      $prefix,
      '<span>' . $title . '</span>'
    );
  }

  
/**
 * Filters the archive title.
 *
 * @since 4.1.0
 * @since 5.5.0 Added the `$prefix` and `$original_title` parameters.
 *
 * @param string $title          Archive title to be displayed.
 * @param string $original_title Archive title without prefix.
 * @param string $prefix         Archive title prefix.
 */
  return apply_filters( 'get_the_archive_title', $title, $original_title, $prefix );
}
 

 View on GitHub View on Trac