WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

the_category() WP 0.71

Выводит ссылки на рубрики, к которым принадлежит пост в виде HTML li списка или в произвольном формате.

Функцию нужно использовать внутри Цикла 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 поста, категории которого нужно вывести.
По умолчанию: false - текущий пост ($post->ID)

Примеры

#1 Список категорий поста разделенных запятой:

<p>Категории: <?php the_category(', '); ?></p>

Получим: Категории: WordPress, Computers, Blogging

#2 Используем второй параметр

Пусть, пост находится в категории "Пушкин", которая является дочерней категорией категории "Поэты", тогда:

<?php the_category(' > ', 'multiple'); ?>

Выведет: Поэты > Пушкин

#3 А если во втором параметре написать 'single'

<?php the_category(' > ', 'single'); ?>

Получим: Поэты > Пушкин (ссылка будет вести на категорию "Пушкин")

Код the category: wp-includes/category-template.php WP 5.2.2

<?php
function the_category( $separator = '', $parents = '', $post_id = false ) {
	echo get_the_category_list( $separator, $parents, $post_id );
}

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

Из раздела: Для записей

Еще из тегов шаблона: Записи: посты, страницы, ...

29 комментов
Полезные 1 Вопросы 2 Все
  • oleg cайт: fr7913y2.bget.ru

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

    Ответить10 мес назад #
  • @ Александр

    Добрый день. Не хочет работать функция по 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;
    }
    Ответить7 мес назад #
  • Можете подсказать такой ответ - данным кодом я могу вывести название рубрик и подрубрик без ссылок:

    $category = get_the_category(); 
    echo $category[0]->cat_name;

    А как я могу получить ТОЛЬКО Названия ПОДРУБРИК?

    Ответить4 мес назад #
  • Антон

    Я настроил вывод последних комментариев в виджете PHP и критерием вывода сделал заголовок post_title: AND post_title = 'Страница один'. Вопрос в чем, подскажите как мне указать сразу несколько тайтлов , чтобы последние комменты собирались сразу с нескольких страниц.

    Ответить2 мес назад #
Здравствуйте, !     Войти . Зарегистрироваться