is_singular() WP 1.5.0

Перевіряє чи переглядається сторінка запису (пост, сторінка, свій тип запису, вкладення). Можна вказати тип запису для перевірки. Умовний тег.

Якщо функції не вказано параметр, то функція поєднує у собі перевірку всіх умовних тегів: is_attachment() .

Логіка цієї функції відрізняється від функції is_single() , тим що там перевіряється окремий запис, а тут перевіряється тип запису.

Використовуйте is_single() , коли потрібно перевірити сторінку за конкретним ID, ім’ям запису, а не за її типом: post , page , attachment .

Основа для:
is_product()
1 раз – 0.000001 сек
(швидкість світла) | 50000 разів – 0.01 сек
(швидкість світла) |
PHP 7.2.5, WP 5.0.2

Хуків немає.

Повертає

true|false.

Використання

if( is_singular( $post_types ) ){
	// ...
}
$post_types
(рядок/масив)
Тип запису або кілька типів записів, які потрібно перевіряти. Декілька типів записів потрібно вказувати в масиві.

Приклади

0

#1 Перевіряє, чи поточна сторінка є звичайним постом

if ( is_singular( 'post' ) ){
	// viewing a regular post
}
0

#2 Приклад різних перевірок

// true, якщо виконано одну з таких умов:
// is_single(), is_page() or is_attachment().
is_singular();

// True під час перегляду посту book (Custom Post Type).
is_singular( 'book');

// True під час перегляду запису типу newspaper чи book.
is_singular(['newspaper', 'book']);
0

#3 Виведення вмісту лише на окремих сторінках

Таким кодом можна вивести різні рекламні блоки в сайдбарі для окремих сторінок і сторінок відмінних від них (архівів).

if ( is_singular() ) {
  // Реклама №1
}
else {
  // Реклама №2
}
0

#4 Як визначити окрему сторінку вказаного типу

Цей приклад показує, як визначити окрему сторінку зазначеного типу запису:book

if( is_singular('book') ){
	// Код, який працюватиме лише на окремих сторінках з типом запису book
}
0

#5 Визначення кількох типів записів

Приклад, що показує як передавати кілька типів записів у масиві:

if( is_singular( ['newspaper', 'book'] ) ){
	// тут якийсь код
}

нотатки

  • Дивіться: is_page()
  • Дивіться: is_single()
  • Global. WP_Query. $wp_query WordPress Query object.

список змін

З версії 1.5.0Введено.

Код is_singular() WP 6.0.2

function is_singular( $post_types = '' ) {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags до роботи не працює, тому що керує. Before then, they always return false.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_singular( $post_types );
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *