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

返回介绍

is_category()

发布于 2017-09-11 字数3551 浏览 1009 评论 0

is_category( mixed $category = '' )

Is the query for an existing category archive page?


描述

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


参数

$category

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

Default value: ”


返回值

(bool)


源代码

File: wp-includes/query.php

function is_category( $category = '' ) {
	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_category( $category );
}

更新日志

Version 描述
1.5.0 Introduced.

More Information

  • See also is_archive() and Category Templates.
  • For Custom Taxonomies use is_tax()

相关函数

Uses

  • wp-includes/l10n.php:
    __()
  • wp-includes/class-wp-query.php:
    WP_Query::is_category()
  • 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_dropdown_categories()
  • 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 6 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

    
    is_category();
    // When any Category archive page is being displayed.
    
    is_category( '9' );
    // When the archive page for Category 9 is being displayed.
    
    is_category( 'Stinky Cheeses' );
    // When the archive page for the Category with Name "Stinky Cheeses" is being displayed.
    
    is_category( 'blue-cheese' );
    // When the archive page for the Category with Category Slug "blue-cheese" is being displayed.
    
    is_category( array( 9, 'blue-cheese', 'Stinky Cheeses' ) );
    // Returns true when the category of posts being displayed is either term_ID 9,
    // or slug "blue-cheese", or name "Stinky Cheeses".
    // Note: the array ability was added in version 2.5.
    
    

上一篇:is_blog_user()

下一篇:is_child_theme()

发布评论

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

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