Функция IS_PAGED() в WordPress: описание, использование и примеры

# Функция IS_PAGED() │ WP 1.5.0

Функция is_paged() проверяет, отображается ли страница с нумерацией (например, /page/2, /page/3). Это условная тег-функция.

## Описание функции

Эта функция работает только на архивных страницах, таких как категории, теги, архивы авторов, главная страница блога и страницы с датами. Другими словами, она подходит для тех страниц, которые можно разделить на несколько.

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

- Функция не применяется к записям и страницам, разделённым с помощью тега <!--nextpage-->.
- Возвращает true, если запрос относится к странице с нумерацией, и false в противном случае.

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

Чтобы проверить, является ли текущая страница страницей с нумерацией, используйте следующий синтаксис:

```php
if (is_paged()) {
    // Код, который выполняется для страниц с нумерацией
}

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

Пример 1: Скрытие блоков боковой панели на страницах с нумерацией

Пример 2: Проверка, на какой странице нумерации мы находимся

Если вам нужно узнать, на какой конкретной странице нумерации вы находитесь, используйте get_query_var('paged').

if (get_query_var('paged') == 3) { 
    // Код, который срабатывает на третьей странице нумерации
}

Пример 3: Проверка, разделены ли записи на страницы

Вы можете использовать шорткод <!--nextpage-->, чтобы разделить текст записи на несколько страниц. Например, URL второй страницы будет выглядеть так: http://example.com/privet-mir/2/.

$paged = get_query_var('page');
// $paged = $wp_query->get('page'); // Или так...

if ($paged < 2) {
    // Это первая страница или запись не разделена на страницы
} else {
    // Это 2, 3, 4 ... страница разделённой записи.
}

Пример 4: Проверка, разделена ли запись на страницы

the_post();

if (!empty($GLOBALS['multipage'])) {
    // Запись разделена на страницы
}

Пример 5: Узнаём, сколько страниц у записи

the_post();

if (!empty($GLOBALS['numpages'])) {
    if ($GLOBALS['numpages'] === 1) {
        // Не разделена
    } else {
        // Запись разделена на страницы
        echo "Количество страниц: {$GLOBALS['numpages']}";
    }
}

Примечания

• Глобальная переменная: $wp_query - это объект запроса WordPress.

Изменения

• С версии 1.5.0: Введена функция is_paged().

Код функции is_paged()

Вот как реализована функция в коде WordPress:

function is_paged() {
global $wp_query;

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

return $wp_query->is_paged();

}

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

• Условные теги помогают дополнительно проверять различные типы страниц и запросов. Например:
  • is_404()
  • is_admin()
  • is_archive()
  • is_category()
  • is_tag()
  • и многие другие...

Эти функции могут быть полезны для создания более сложной логики отображения контента на вашем сайте.