has_category() WP 3.1.0
Проверяет находится ли текущая (или указанная) запись хоть в одной из указанных категорий.
Работает только для таксономии category
, если нужно проверить если ли у записи элементы другой таксономии, то используйте has_term().
Если не переданы никакие рубрики для сравнения, то функция будет проверять присвоена ли посту хоть одна рубрика.
Работает на основе: has_term()
Основа для: in_category()
1 раз = 0.003414с = очень медленно | 50000 раз = 0.84с = очень быстро | PHP 7.1.5, WP 4.8.1
Хуков нет.
Возвращает
True/false. True - если если у поста есть хоть одна из указанны категорий.
Использование
has_category( $category, $post );
- $category(строка/число/массив)
- name/term_id/slug рубрики или массив из этих значений в которых нужно проверить присутствие записи.
По умолчанию: '' - $post(число/объект)
- Запись (пост), у которого нужно проверить наличие указанных рубрик.
По умолчанию: null
Примеры
#1 Проверим есть ли у поста хоть одна указанная рубрика
$post_id = 6235; if( has_category( array(37,'history'), $post_id) ){ echo "Пост с ID=$post_id находится в рубрики `37` или `history`"; }
Список изменений
С версии 3.1.0 | Введена. |
Код has_category() has category WP 5.6
function has_category( $category = '', $post = null ) {
return has_term( $category, 'category', $post );
}Cвязанные функции
Из метки: Условные теги (все)
- cat_is_ancestor_of()
- comments_open()
- email_exists()
- has_block()
- has_custom_header()
- has_excerpt()
- has_nav_menu()
- has_post_thumbnail()
- has_shortcode()
- has_tag()
- has_term()
- have_comments()
- have_posts()
- in_category()
- in_the_loop()
- is_404()
- is_active_sidebar()
- is_admin()
- is_admin_bar_showing()
- is_archive()
- is_attachment()
- is_author()
- is_blog_admin()
- is_blog_installed()
- is_category()
- is_child_theme()
- is_comment_feed()
- is_customize_preview()
- is_date()
- is_day()
- is_dynamic_sidebar()
- is_embed()
- is_feed()
- is_front_page()
- is_header_video_active()
- is_home()
- is_local_attachment()
- is_main_query()
- is_month()
- is_multi_author()
- is_multisite()
- is_nav_menu()
- is_network_admin()
- is_new_day()
- is_page()
- is_page_template()
- is_paged()
- is_plugin_active()
- is_post_type_archive()
- is_post_type_hierarchical()
- is_preview()
- is_robots()
- is_search()
- is_single()
- is_singular()
- is_ssl()
- is_sticky()
- is_tag()
- is_tax()
- is_taxonomy_hierarchical()
- is_textdomain_loaded()
- is_time()
- is_trackback()
- is_user_admin()
- is_user_logged_in()
- is_year()
- pings_open()
- post_exists()
- post_password_required()
- shortcode_exists()
- taxonomy_exists()
- term_exists()
- term_is_ancestor_of()
- wp_attachment_is()
- wp_attachment_is_image()
- wp_doing_ajax()
- wp_doing_cron()
- wp_is_mobile()
- wp_is_post_autosave()
- wp_is_post_revision()
- wp_script_is()
Еще из раздела: Для записей
- get_object_taxonomies()
- get_objects_in_term()
- get_the_category()
- get_the_category_list()
- get_the_tag_list()
- get_the_tags()
- get_the_taxonomies()
- get_the_term_list()