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

返回介绍

is_singular()

发布于 2017-09-11 字数4051 浏览 796 评论 0

is_singular( string|array $post_types = '' )

Is the query for an existing single post of any post type (post, attachment, page, custom post types)?


描述

If the $post_types parameter is specified, this function will additionally check if the query is for one of the Posts Types specified.


参数

$post_types

(string|array)
(Optional)
Post type or array of post types.

Default value: ”


返回值

(bool) Whether the query is for an existing single post of any of the given post types.


源代码

File: wp-includes/query.php

function is_singular( $post_types = '' ) {
	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_singular( $post_types );
}

更新日志

Version 描述
1.5.0 Introduced.

相关函数

Uses

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

Used By

  • wp-includes/embed.php:
    wp_oembed_add_discovery_links()
  • wp-includes/general-template.php:
    wp_get_document_title()
  • wp-admin/includes/class-wp-media-list-table.php:
    WP_Media_List_Table::extra_tablenav()
  • wp-admin/includes/class-wp-posts-list-table.php:
    WP_Posts_List_Table::extra_tablenav()
  • wp-includes/general-template.php:
    feed_links_extra()
  • wp-includes/class-wp.php:
    WP::handle_404()
  • wp-includes/link-template.php:
    rel_canonical()
  • wp-includes/link-template.php:
    wp_get_shortlink()
  • wp-includes/link-template.php:
    get_next_comments_link()
  • wp-includes/link-template.php:
    get_previous_comments_link()
  • wp-includes/link-template.php:
    paginate_comments_links()
  • wp-includes/link-template.php:
    get_posts_nav_link()
  • wp-includes/post-template.php:
    is_page_template()
  • wp-includes/post-template.php:
    wp_list_pages()
  • wp-includes/post-template.php:
    get_body_class()
  • wp-includes/canonical.php:
    redirect_canonical()
  • Show 11 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

    Custom Post Types

    When any of the following return true: is_single(), is_page() or is_attachment().

    
    is_singular();
    

    True when viewing a post of the Custom Post Type book.

    
    is_singular( 'book' );
    

    True when viewing a post of the Custom Post Type newspaper or book.

    
    is_singular( array( 'newspaper', 'book' ) );
    
  2. Different Sidebar Ads in Singular Page

    
    if ( is_singular() ) {
      // show adv.

    Default Post Type

    True when viewing a regular post.

    
    is_singular( 'post' );
    

上一篇:is_single()

下一篇:is_site_admin()

发布评论

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

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