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

返回介绍

is_tag()

发布于 2017-09-11 字数3147 浏览 780 评论 0

is_tag( mixed $tag = '' )

Is the query for an existing tag archive page?


描述

If the $tag parameter is specified, this function will additionally check if the query is for one of the tags specified.


参数

$tag

(mixed)
(Optional)
Tag ID, name, slug, or array of Tag IDs, names, and slugs.

Default value: ”


返回值

(bool)


源代码

File: wp-includes/query.php

function is_tag( $tag = '' ) {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_tag( $tag );
}

更新日志

Version 描述
2.3.0 Introduced.

相关函数

Uses

  • wp-includes/l10n.php:
    __()
  • wp-includes/class-wp-query.php:
    WP_Query::is_tag()
  • wp-includes/functions.php:
    _doing_it_wrong()

Used By

  • wp-includes/general-template.php:
    wp_get_document_title()
  • wp-includes/general-template.php:
    get_the_archive_title()
  • wp-includes/category-template.php:
    term_描述()
  • wp-includes/category-template.php:
    wp_list_categories()
  • wp-includes/general-template.php:
    feed_links_extra()
  • wp-includes/general-template.php:
    wp_title()
  • wp-includes/general-template.php:
    single_term_title()
  • wp-includes/class-wp.php:
    WP::handle_404()
  • wp-includes/post-template.php:
    get_body_class()
  • wp-includes/canonical.php:
    redirect_canonical()
  • Show 5 more used by
    Hide more used by


User Contributed Notes

  1. Skip to note content

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

    Contributed by Codex

    Examples

    
    // When any Tag archive page is being displayed.
    is_tag();
    
    // When the archive page for Tag 30 is being displayed.
    is_tag( '30' );
    
    // When the archive page for tag with the Slug of 'extreme' is being displayed.
    is_tag( 'extreme' );
    
    // When the archive page for tag with the Name of 'mild' is being displayed.
    is_tag( 'mild' );
    
    /*
     * Returns true when the tag of posts being displayed is either term_ID 30,
     * or slug "extreme", or name "mild". Note: the array ability was added
     * at Version 3.7.
     */
    is_tag( array( 30, 'mild', 'extreme' ) );
    
    

上一篇:is_super_admin()

下一篇:is_tax()

发布评论

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

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