get_the_archive_title() - WordPress 函数参考中文文档

返回介绍

get_the_archive_title()

发布于 2017-09-11 字数6764 浏览 986 评论 0

get_the_archive_title()

Retrieve the archive title based on the queried object.


描述


返回值

(string) Archive title.


源代码

File: wp-includes/general-template.php

function get_the_archive_title() {
	if ( is_category() ) {
		/* translators: Category archive title. 1: Category name */
		$title = sprintf( __( 'Category: %s' ), single_cat_title( '', false ) );
	} elseif ( is_tag() ) {
		/* translators: Tag archive title. 1: Tag name */
		$title = sprintf( __( 'Tag: %s' ), single_tag_title( '', false ) );
	} elseif ( is_author() ) {
		/* translators: Author archive title. 1: Author name */
		$title = sprintf( __( 'Author: %s' ), '<span class="vcard">' . get_the_author() . '</span>' );
	} elseif ( is_year() ) {
		/* translators: Yearly archive title. 1: Year */
		$title = sprintf( __( 'Year: %s' ), get_the_date( _x( 'Y', 'yearly archives date format' ) ) );
	} elseif ( is_month() ) {
		/* translators: Monthly archive title. 1: 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. 1: 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. 1: Post type name */
		$title = sprintf( __( 'Archives: %s' ), post_type_archive_title( '', false ) );
	} elseif ( is_tax() ) {
		$tax = get_taxonomy( get_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 ) );
	} else {
		$title = __( 'Archives' );
	}

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

更新日志

Version 描述
4.1.0 Introduced.

相关函数

Uses

  • wp-includes/general-template.php:
    get_the_archive_title
  • wp-includes/l10n.php:
    __()
  • wp-includes/l10n.php:
    _x()
  • wp-includes/general-template.php:
    get_the_date()
  • wp-includes/general-template.php:
    single_cat_title()
  • wp-includes/general-template.php:
    single_tag_title()
  • wp-includes/general-template.php:
    post_type_archive_title()
  • wp-includes/general-template.php:
    single_term_title()
  • wp-includes/query.php:
    is_year()
  • wp-includes/query.php:
    is_category()
  • wp-includes/query.php:
    is_tag()
  • wp-includes/query.php:
    is_author()
  • wp-includes/query.php:
    is_month()
  • wp-includes/query.php:
    is_day()
  • wp-includes/query.php:
    is_tax()
  • wp-includes/query.php:
    is_post_type_archive()
  • wp-includes/query.php:
    get_queried_object()
  • wp-includes/taxonomy.php:
    get_taxonomy()
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/author-template.php:
    get_the_author()
  • Show 15 more uses
    Hide more uses


Used By

  • wp-includes/general-template.php:
    the_archive_title()

User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note

    Contributed by WebMan Design | Oliver Juhas

    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' );
    
  2. 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;
    
    }
    

    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 );

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!