in_the_loop() │ WP 2.0.0

Проверяет активен ли цикл перебора записей в момент вызова этой функции. Условный тег, чтобы делать что-либо находясь в цикле WordPress.

Использует global $wp_query

Хуков нет.

Возвращает

true|false. Логические true или false.

Использование

if( in_the_loop() ){
	// находимся в цикле...
}

Примеры

0

#1 Изменение заголовка поста

Хак ниже показывает, как изменить заголовок записи только когда the_title() вызывается из цикла WordPress:

add_filter( 'the_title', 'modify_single_post_entry_titles' );

function modify_single_post_entry_titles( $title ) {

	if ( is_singular( 'post' ) && in_the_loop() ) {
		// меняем заголовок
		$title = 'измененный заголовок';
	}

	return $title;
}

Заметки

  • Global. WP_Query. $wp_query WordPress Query object.

Список изменений

С версии 2.0.0 Введена.

Код in_the_loop() WP 6.7.1

wp-includes/query.php 
function in_the_loop() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		return false;
	}

	return $wp_query->in_the_loop;
}

Условные теги (все)

Запросы

Записи: посты, страницы, ...