IS_PREVIEW() │ WP 2.0.0

Что такое IS_PREVIEW()?

Функция is_preview() в WordPress используется для определения, является ли текущий запрос предварительным просмотром поста или страницы. Это может быть полезно, если вы хотите выполнять определённые действия, только когда пользователь просматривает предварительный вариант вашего контента.

Использование функции

Функция вызывает метод is_preview() класса WP_Query. Вы можете использовать её в своем коде следующим образом:

is_preview();

Примеры использования

Вот простой пример, как можно использовать is_preview():

if ( is_preview() ){
    // Код, который будет выполняться только на страницах предварительного просмотра
}

Как работает функция

Функция is_preview() проверяет, запущен ли глобальный объект $wp_query, который хранит информацию о текущем запросе. Если объект не установлен, функция вернёт false и выдаст предупреждение.

function is_preview() {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Условные теги запроса не работают до запуска запроса. Ранее они всегда возвращают false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_preview();
}

Что возвращает функция?

Функция возвращает true, если запрос является предварительным просмотром, и false в противном случае.

Важные моменты

• Глобальный объект: Функция использует глобальный объект WP_Query, который содержит данные о текущем запросе.
• Версия: Функция была введена в WordPress версии 2.0.0 и с тех пор используется в других версиях.

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

Ниже представлены другие условные теги, которые могут быть полезны при разработке на WordPress:

• is_404(): Проверяет, является ли страница ошибкой 404.
• is_admin(): Проверяет, открыта ли административная панель.
• is_single(): Проверяет, является ли текущая страница одиночным постом.

Итак, функция is_preview() — это полезный инструмент для проверки, находитесь ли вы на странице предварительного просмотра в WordPress. Используя её, вы можете адаптировать вывод контента и функционал сайта.