get_category_link() │ WP 1.0.0

Получает корректную ссылку на страницу категории по переданному ID категории.

Для функции работает специальный хук category_link, который используется в основной функции получения URL терминов:

$termlink = apply_filters( 'category_link', $termlink, $term->term_id );

Работает на основе: get_term_link()

Основа для: get_tag_link()

1 раз — 0.0038219 сек (очень медленно) | 50000 раз — 3.29 сек (быстро) | PHP 7.4.25, WP 5.9.2

Хуков нет.

Возвращает

Строку. Ссылку (УРЛ) на страницу категории.

Использование

$cat_link = get_category_link( $category_id );

$category_id(число) (обязательный): ID категории, ссылку на которую нужно получить.

Примеры

#1 Выведем на экран ссылку на категорию 'Домашние животные':

<?php
// Получим ID категории
$category_id = get_cat_ID( 'Домашние животные' );

// Теперь, получим УРЛ категории
$category_link = get_category_link( $category_id );
?>

<!-- выведем ссылку на категорию -->
<a href="<?php echo $category_link; ?>">Домашние животные</a>

Заметки

Смотрите: get_term_link()

Список изменений

С версии 1.0.0

Введена.

Код `get_category_link() get category link` ^{WP 6.5.2}

wp-includes/category-template.php

function get_category_link( $category ) {
	if ( ! is_object( $category ) ) {
		$category = (int) $category;
	}

	$category = get_term_link( $category );

	if ( is_wp_error( $category ) ) {
		return '';
	}

	return $category;
}