Условный тег: in_category

02.05.2012
Описание

Тег проверяет принадлежность записи к указанной рубрике. Этот условный тег является boolean-функцией, то есть он возвращает только true или false.

Использование
<?php if ( in_category($category, $post) ) { ... } ?>
Параметры

$category

(строка) (обязательный) - ID, название или ярлык рубрики (или массив из них).

По умолчанию значения нет.

$post

(строка) (необязательный) - ID записи.

По умолчанию значения нет.

Значения

boolean

Возвращает true если запись принадлежит к указанной рубрике и false в противном случае.

Примеры

1 Проверка на принадлежность записи к указанной рубрике

<?php 
    if( in_category('arsenal') )  
        echo "Эта запись опубликована в рубрике 'Арсенал'"; 
    else
        echo "Эта запись не опубликована в рубрике 'Арсенал'";
?>

2 Использование параметра $post

<?php 
    if( in_category('arsenal', '405') )  
        echo "Запись '405' опубликована в рубрике 'Арсенал'"; 
    else
        echo "Запись '405' не опубликована в рубрике 'Арсенал'";
?>

3 Использование массива параметров $category

<?php 
    if( in_category(array('arsenal', 'tottenham')) )  
        echo "Это рубрика 'Арсенал' или рубрика 'Тоттенхэм'"; 
    else
        echo "Эта запись опубликована в других рубриках";
?>

Внимание! Функция in_category() не проверяет принадлежность записи к родительским рубрикам, если запись опубликована в дочерней рубрике. Если запись опубликована в дочерней рубрике 'Клубы -> Арсенал', то проверка записи через in_category('Клубы') вернет false.

Лог изменений

Функция добавлена в версии 1.2.0
Возможность указывать рубрику через ее название появилась в версии 2.7.0
Возможность указывать рубрику через ее ярлык появилась в версии 2.7.0
Возможность использования массива была добавлена в версии 2.7.0
Возможность использования функции вне цикла вывода записей была добавлена в версии 2.7.0
Параметр $post был добавлен в версии 2.7.0

Исходный файл

Функция in_category() находится в wp-includes/category-template.php

Связанные теги|функции
Рубрики: Теги шаблоновФункции WordPressУсловные теги

Понравился пост? Подпишись на обновления по Обновления блога по RSSRSS или Обновления блога на TwitterTwitter !

Комментарии

Комментариев пока еще нет.

Написать комментарий

(обязательно)

(обязательно, не публикуется)

Для вставки кода используйте кнопку "Код", по умолчанию используется синтаксис подсветки языка "php", вы можете поменять его на любой другой поддерживаемый GeSHi язык, например "javascript", "css", "html4strict", "sql" и тд. Используйте предпросмотр!
 


Подписаться на уведомления без комментирования.