Функция IS_SINGLE() в WordPress

Введение

Функция is_single() в WordPress позволяет проверить, отображается ли страница отдельного поста. Она является условным тегом, который используется для определения, отображается ли конкретный пост. Обратите внимание, что посты с типами "attachment" и "page" не учитываются.

Зачем это нужно?

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

Как использовать

Синтаксис функции

is_single( $post = '' );

Параметры:

• $post: Целочисленный ID поста, заголовок поста или слаг, который позволяет идентифицировать конкретный пост. Вы можете передать массив нескольких значений для проверки нескольких постов.

Пример:

// Проверяем, является ли текущий пост постом с ID 17
if( is_single( 17 ) ){
    // Действия, если пост с ID 17 отображается
}

Возвращаемое значение

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

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

1. Проверка на любой отдельный пост

if( is_single() ){
    // Действия, если отображается любой отдельный пост
}

2. Проверка конкретного поста по ID

if( is_single( '17' ) ){
    // Действия для поста с ID 17
}

3. Проверка поста по заголовку

if( is_single( 'Irish Stew' ) ){
    // Действия для поста с заголовком "Irish Stew"
}

4. Проверка поста по слагу

if( is_single( 'beef-stew' ) ){
    // Действия для поста со слагом "beef-stew"
}

5. Проверка нескольких постов

if( is_single( [ 17, 'beef-stew', 'Irish Stew' ] ) ){
    // Действия, если отображается один из постов из списка
}

6. Работа с древовидной структурой

Для постов, которые имеют древовидную структуру, можно передать путь к посту:

if( is_single( 'music/flamenko' ) ){
    // Действия для поста 'flamenko', который является дочерним к 'music'
}

Заметки

• Если ваш сайт не переводит кириллицу в латиницу, имейте в виду, что при создании по��та его имя может измениться на специальные символы. Правильный способ проверки слага:

is_single( sanitize_title('моя-страница') ); // корректно

Не делайте:

is_single('моя-страница'); // некорректно

Заключение

Функция is_single() — это мощный инструмент, который позволяет легко проверять, отображается ли пост на вашем сайте. Используйте эту функцию для управления контентом и оформления страниц, основываясь на том, какой пост видит ваш посетитель.

Изменения

Функция была введена в WordPress начиная с версии 1.5.0 и улучшена в следующих версиях.