the_category() WP 0.71
Выводит ссылки на рубрики к которым принадлежит пост.
the_category() нужно использовать внутри Цикла WordPress или использовать параметр post_id (см. описание).
Работает на основе:
get_the_category_list()✈ 1 раз = 0.006019с = очень медленно | 50000 раз = 16.46с = медленно PHP 7.1.2, WP 4.7.3
Хуков нет.
Возвращает
HTML код ссылок на категорию(и).
Использование
<?php the_category( $separator, $parents, $post_id ); ?>
- $separator(строка)
- Разделитель между ссылками.
По умолчанию: выведет ссылки в списке <ul> - $parents(строка)
Как показывать ссылки, если текущая категория является дочерней. Может принимать:
-
multiple - показывать отдельно ссылки на родительскую и дочернюю категории, сохраняя порядок (родитель/предок);
- single - показать одну ссылку, на категорию в которой находится пост, но текстом ссылки станет вся структура вложенности поста в категории (родитель/предок).
По умолчанию: просто выводятся категории, к которым принадлежит пост (никакая связь не учитывается)
-
- $post_id(число)
- ID поста, категории которого нужно вывести. Добавлен в версии 2.5.
По умолчанию: текущий пост ($post->ID)
Примеры
#1 Список категорий поста разделенных запятой:
<p>Категории: <?php the_category(', '); ?></p>
Получим: Категории: WordPress, Computers, Blogging
#2 Используем второй параметр
Пусть, пост находится в категории "Пушкин", которая является дочерней категорией категории "Поэты", тогда:
<?php the_category(' > ', 'multiple'); ?>
#2.1. А если во втором параметре написать 'single':
<?php the_category(' > ', 'single'); ?>
Получим: Поэты > Пушкин (ссылка будет вести на категорию "Пушкин")
Код the_category:
wp-includes/category-template.php
VER 5.0
Cвязанные функции
Из раздела: Для записей
- 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()
- get_the_terms()
Еще из тегов шаблона: Записи: посты, страницы, ...
- body_class()
- get_attachment_link()
- get_post_format()
- get_post_time()
- get_the_date()
- have_posts()
- in_the_loop()
- next_image_link()
- next_post_link()
- next_posts_link()
- post_class()
- post_password_required()
- posts_nav_link()
вообще интересно что функция выводит ссылки на рубрики с сортировкой по алфавиту
в итоге нарушая вложенность категорий и сортировку не изменишь
бред в общем выводит и ни кого это не смущает
Добрый день. Не хочет работать функция по ID поста в function.php. "$catlist" пустой и ничего не выводит. Помогите, пожалуйста.
add_filter( 'wpseo_breadcrumb_output', 'custom_wpseo_breadcrumb_output' ); function custom_wpseo_breadcrumb_output( $output ){ if( is_singular('download') ){ $postinfo = get_post(); $from = '<span class="breadcrumb_last">'.$postinfo->post_title.'</span>'; // EDIT this to your needs $backurl = str_replace("/download", "", get_permalink()); $catlist = the_category('<span class="separator">»</span>', 'multiple', $postinfo->ID); $to = $catlist.'<span class="separator">»</span><a href="'.$backurl.'">'.$postinfo->post_title.'</a><span class="separator">»</span><span class="breadcrumb_last">Скачать</span>'; debug_to_console( $to ); } return $output; }Потому что the_category() сразу выводит на экран результат своей работы, а не возвращает.
А есть подобная функция которая возвращает?
get_the_category_list()