is_trackback() WP 1.5.0

Проверяет, является ли текущий запрос запросом на страницу пингов (trackback)

За обработку запроса тракбэков отвечает файл wp-trackback.php.

Когда может пригодится?

Проверять запрос может пригодится, когда например вы подключаетесь к основному запросу и вам нужно сделать в нем какие-то изменения, только для пингов пришедших с других сайтов.

Задача крайне редкая, поэтому этот условный тег можно отнести к редко используемым.

Как это работает?

Когда вы пишите контент для записи и вставляете туда ссылки, WordPress пытается уведомить сайты (домены внешних ссылок) что вы на них ссылаетесь. Такое уведомление называется:

• Трэкбэком или Пингбэком для того кто получает это уведомление.
• Пингом для того кто отправляет это уведомление.

В этом случае WordPress, на котором публикуется запись с ссылками, отправляет POST запрос в файл wp-trackback.php. Там подгружается ядро WordPress и в основной запрос устанавливается параметр tb=1

require_once( dirname( __FILE__ ) . '/wp-load.php' );
wp( [ 'tb' => '1' ] );

Параметр tb устанавливает свойство WP_Query::is_trackback = true - это означает, что сработает условный тег is_trackback(), что в свою очередь означает, что это запрос трэкбэка (пингбэка). Далее, проверяются переданные POST данные и если все с ними в порядке, в таблицу комментариев добавляется пинг, сообщающий вам что на вашу статью сослались. Тип комментария в БД при этом указывается как pingback: comment_type = pingback.

Управлять отправкой и получением пингов можно в настройках обсуждения:

Хуков нет.

Возвращает

true/false

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

if( is_trackback() ){
	// запрос пинга
}

Заметки

• Global. WP_Query. $wp_query WordPress Query object.

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

Код is trackback: wp-includes/query.php ^{WP 5.3.2}

<?php
function is_trackback() {
	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_trackback();
}

Cвязанные функции

Из метки: Условные теги (типов страниц и запросов)

Еще из метки: Условные теги (все)

Еще из раздела: Комментарии