get_the_archive_title

function

get_the_archive_title()

Retrieve the archive title based on the queried object.

Contents

Description
- Return
- Source
- Changelog
Related
- Uses
- Used By
User Contributed Notes

Description Description

Return Return

(string) Archive title.

Source Source

File: wp-includes/general-template.php

function get_the_archive_title() {
	$title = __( 'Archives' );

	if ( is_category() ) {
		/* translators: Category archive title. %s: Category name. */
		$title = sprintf( __( 'Category: %s' ), single_cat_title( '', false ) );
	} elseif ( is_tag() ) {
		/* translators: Tag archive title. %s: Tag name. */
		$title = sprintf( __( 'Tag: %s' ), single_tag_title( '', false ) );
	} elseif ( is_author() ) {
		/* translators: Author archive title. %s: Author name. */
		$title = sprintf( __( 'Author: %s' ), '<span class="vcard">' . get_the_author() . '</span>' );
	} elseif ( is_year() ) {
		/* translators: Yearly archive title. %s: Year. */
		$title = sprintf( __( 'Year: %s' ), get_the_date( _x( 'Y', 'yearly archives date format' ) ) );
	} elseif ( is_month() ) {
		/* translators: Monthly archive title. %s: Month name and year. */
		$title = sprintf( __( 'Month: %s' ), get_the_date( _x( 'F Y', 'monthly archives date format' ) ) );
	} elseif ( is_day() ) {
		/* translators: Daily archive title. %s: Date. */
		$title = sprintf( __( 'Day: %s' ), get_the_date( _x( 'F j, Y', 'daily archives date format' ) ) );
	} 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() ) {
		/* translators: Post type archive title. %s: Post type name. */
		$title = sprintf( __( 'Archives: %s' ), post_type_archive_title( '', false ) );
	} elseif ( is_tax() ) {
		$queried_object = get_queried_object();
		if ( $queried_object ) {
			$tax = get_taxonomy( $queried_object->taxonomy );
			/* translators: Taxonomy term archive title. 1: Taxonomy singular name, 2: Current taxonomy term. */
			$title = sprintf( __( '%1$s: %2$s' ), $tax->labels->singular_name, single_term_title( '', false ) );
		}
	}

	/**
	 * Filters the archive title.
	 *
	 * @since 4.1.0
	 *
	 * @param string $title Archive title to be displayed.
	 */
	return apply_filters( 'get_the_archive_title', $title );
}

Expand full source code Collapse full source code View on Trac

Changelog Changelog

Changelog
Version	Description
4.1.0	Introduced.

Uses Uses

Uses
Uses	Description
wp-includes/general-template.php: get_the_archive_title	Filters the archive title.
wp-includes/l10n.php: __()	Retrieve the translation of $text.
wp-includes/l10n.php: _x()	Retrieve translated string with gettext context.
wp-includes/general-template.php: get_the_date()	Retrieve the date on which the post was written.
wp-includes/general-template.php: single_cat_title()	Display or retrieve page title for category archive.
wp-includes/general-template.php: single_tag_title()	Display or retrieve page title for tag post archive.
wp-includes/general-template.php: post_type_archive_title()	Display or retrieve title for a post type archive.
wp-includes/general-template.php: single_term_title()	Display or retrieve page title for taxonomy term archive.
wp-includes/query.php: is_year()	Determines whether the query is for an existing year archive.
wp-includes/query.php: is_category()	Determines whether the query is for an existing category archive page.
wp-includes/query.php: is_tag()	Determines whether the query is for an existing tag archive page.
wp-includes/query.php: is_author()	Determines whether the query is for an existing author archive page.
wp-includes/query.php: is_month()	Determines whether the query is for an existing month archive.
wp-includes/query.php: is_day()	Determines whether the query is for an existing day archive.
wp-includes/query.php: is_tax()	Determines whether the query is for an existing custom taxonomy archive page.
wp-includes/query.php: is_post_type_archive()	Determines whether the query is for an existing post type archive page.
wp-includes/query.php: get_queried_object()	Retrieve the currently-queried object.
wp-includes/taxonomy.php: get_taxonomy()	Retrieves the taxonomy object of $taxonomy.
wp-includes/plugin.php: apply_filters()	Calls the callback functions that have been added to a filter hook.
wp-includes/author-template.php: get_the_author()	Retrieve the author of the current post.

Show 15 more uses Hide more uses

Used By Used By

Used By
Used By	Description
wp-includes/general-template.php: the_archive_title()	Display the archive title based on the queried object.

User Contributed Notes User Contributed Notes

Skip to note 1 content
You must log in to vote on the helpfulness of this noteVote results for this note: 20You must log in to vote on the helpfulness of this note

Contributed by WebMan Design | Oliver Juhas — 3 years ago
TIP: Getting rid of archive “label”

If you would like to get rid of the “Category:”, “Tag:”, “Author:”, “Archives:” and “Other taxonomy name:” in the archive title, use this little function in your (child) theme functions.php file:
function my_theme_archive_title( $title ) { if ( is_category() ) { $title = single_cat_title( '', false ); } elseif ( is_tag() ) { $title = single_tag_title( '', false ); } elseif ( is_author() ) { $title = '<span class="vcard">' . get_the_author() . '</span>'; } elseif ( is_post_type_archive() ) { $title = post_type_archive_title( '', false ); } elseif ( is_tax() ) { $title = single_term_title( '', false ); } return $title; } add_filter( 'get_the_archive_title', 'my_theme_archive_title' );
Expand full source code Collapse full source code
Feedback
- Just an update on this: I’ve actually created a plugin Archive Title that takes care of this. You can find it at WordPress plugins repository at https://wordpress.org/plugins/archive-title/ — By WebMan Design | Oliver Juhas — 4 months ago
Log in to add feedback
Skip to note 2 content
You must log in to vote on the helpfulness of this noteVote results for this note: 9You must log in to vote on the helpfulness of this note

Contributed by warmarks — 2 years ago
CPT Title Without word: ‘Archive’:
If you are building custom archive template for a CPT, and want to output just the title of the CPT with no extra word like “Archive” use following function instead:
```
echo post_type_archive_title( '', false );
```
Log in to add feedback
Skip to note 3 content
You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

Contributed by WP Sites - Brad Dalton — 3 years ago
Add text or execute a function before the archive title.
```
add_filter( 'get_the_archive_title', 'modify_archive_title', 10, 1 );

function modify_archive_title( $title ) {
        
    $var = "1";

    return $var . $title;

}
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.

Keep Leading Your Followers!
Share it for them.