WordPress at Your Fingertips

is_singular() WP 1.5.0

Checks whether the post page is viewed (post, page, attachment, any post type). Conditional Tag.

This function combines conditional tags: is_single(), is_page(), is_attachment() and custom post types.

You can specify the specific type of post that you want to check in the $post_types parameter.

Used By: is_product()
1 time — 0.000001 sec (speed of light) | 50000 times — 0.01 sec (speed of light) | PHP 7.2.5, WP 5.0.2

No Hooks.

Return

true|false. Whether the query is for an existing single post or any of the given post types.

Usage

if( is_singular($post_types) ){
	// ... 
}
$post_types(string/array)
Post type or array of post types.
Default: ''

Examples

#1 Content only on individual pages

With this code, you can display different ads units in the sidebar for posts pages and other pages (archives).

if ( is_singular() ) {
	// Advertising №1
}
else {
	// Advertising №2
}

#2 How to determine a single page of the specified type

This example shows how to determine a single page of the post type: book

if( is_singular('book') ){
	// Code that will only work on pages with the 'book' post type
}

#3 Determine multiple post types

An example showing how to pass several types of posts in an array.

if( is_singular( array('newspaper', 'book') ) ){
	// some code 
}

Notes

Changelog

Since 1.5.0 Introduced.

Code of is_singular() WP 5.8.1

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

Conditional tags (page type and request)

Conditional tags (all)

Queries

Main Functions

vladlu 100vlad.lu
Editors: Kama 100
No comments
    Log In