Question

is_singular( string|array $post_types = '' )

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

---

description

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

Different Sidebar Ads in Singular Page

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

Default Post Type

True when viewing a regular post.

is_singular( 'post' );