get_category_link()

Извлекает URL-адрес ссылки на категорию
Функция WordPress
INT 1.0.0
WordPress Icon

Описание функции

Функция get_category_link() используется для получения URL-адреса категории.

Функция принимает идентификатор или объект категории в качестве параметра и возвращает URL-адрес категории. Если категория не существует, функция вернет пустую строку.

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

get_category_link( int|object $category ): string

Функция get_category_link() принимает один обязательный параметр:

  • $category (int|object) — Идентификатор или объект категории. Обязательный параметр.

Функция get_category_link() возвращает URL-адрес категории в виде строки. Если категория не существует, функция вернет пустую строку.

<?php
$category_id = 5; // Идентификатор категории
$category_link = get_category_link( $category_id ); // Получение URL-адреса категории по идентификатору
if ( $category_link ) {
  echo 'URL-адрес категории: ' . $category_link;
} else {
  echo 'Категория не существует.';
}
?>

В приведенном выше примере мы указываем идентификатор категории и затем вызываем функцию get_category_link() с этим идентификатором в качестве параметра. Затем мы проверяем, существует ли URL-адрес категории, и выводим его, если он существует. Если категория не существует, выводится сообщение «Категория не существует».

Примеры использования

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


$category_id = 5;
$category_link = get_category_link($category_id);
echo $category_link;

В данном примере мы получаем ссылку на категорию с ID равным 5. Функция get_category_link() принимает в качестве параметра ID категории и возвращает ссылку на эту категорию. Результатом выполнения кода будет вывод ссылки на категорию с ID 5.

Генерация ссылки на категорию по объекту


$category = get_category(7);
$category_link = get_category_link($category);
echo $category_link;

В данном примере мы получаем объект категории с ID равным 7 с помощью функции get_category(). Затем мы передаем этот объект в функцию get_category_link() для получения ссылки на эту категорию. Результатом выполнения кода будет вывод ссылки на категорию с ID 7.


$category_link = get_category_link(get_the_category()[0]);
echo $category_link;

В данном примере мы используем функцию get_category_link() внутри шаблона WordPress. Мы получаем первую категорию текущего поста с помощью функции get_the_category() и передаем ее в функцию get_category_link() для получения ссылки на эту категорию. Результатом выполнения кода будет вывод ссылки на первую категорию текущего поста.

Создание пользовательской функции для получения ссылки на категорию


function custom_get_category_link($category_id) {
    $category_link = get_category_link($category_id);
    return $category_link;
}
$category_id = 10;
$category_link = custom_get_category_link($category_id);
echo $category_link;

В данном примере мы создаем пользовательскую функцию custom_get_category_link(), которая принимает в качестве параметра ID категории и возвращает ссылку на эту категорию с помощью функции get_category_link(). Затем мы вызываем эту функцию, передавая ей ID категории 10, и выводим полученную ссылку. Результатом выполнения кода будет вывод ссылки на категорию с ID 10.

Вопросы и ответы

Как получить URL ссылки на категорию?

Для получения URL ссылки на категорию в WordPress можно использовать функцию get_category_link(). Она принимает один обязательный параметр — идентификатор или объект категории. Возвращает функция строку с URL ссылкой на категорию.


$category_id = 5;
$category_link = get_category_link($category_id);
echo $category_link;

Как проверить существование категории перед получением ссылки?

Перед вызовом функции get_category_link() можно проверить существование категории с помощью функции term_exists(). Она принимает идентификатор или название категории и возвращает идентификатор, если категория существует, или 0, если категория не найдена.


$category_id = 5;
if (term_exists($category_id, 'category')) {
    $category_link = get_category_link($category_id);
    echo $category_link;
} else {
    echo 'Категория не существует.';
}

Как получить пустую строку, если категория не существует?

Если нужно получить пустую строку, если категория не существует, можно использовать функцию get_category() для получения объекта категории. Если категория не найдена, функция вернет значение null, и затем можно проверить это значение и присвоить пустую строку.


$category_id = 5;
$category = get_category($category_id);
$category_link = $category ? get_category_link($category) : '';
echo $category_link;

Как получить ссылку на категорию по ID?

Для получения ссылки на категорию по ее ID в WordPress используется функция get_category_link(). Она принимает один обязательный параметр — ID категории.

Пример использования:


$category_id = 5;
$category_link = get_category_link($category_id);
echo $category_link;

Как получить ссылку на категорию по объекту категории?

Если у вас есть объект категории, вы также можете получить ссылку на нее с помощью функции get_category_link(). В этом случае в качестве параметра нужно передать сам объект категории.

Пример использования:


$category = get_category(5);
$category_link = get_category_link($category);
echo $category_link;

Как получить ссылку на категорию без указания ID или объекта?

Если вы хотите получить ссылку на текущую активную категорию, то можно воспользоваться глобальной переменной $wp_query. В ней содержится информация о текущем запросе, включая активную категорию.

Пример использования:


$category_link = get_category_link($wp_query->get_queried_object());
echo $category_link;

Функция get_category_link() возвращает строку — ссылку на категорию в случае успеха или пустую строку, если категория не существует. Она является полезным инструментом для работы с категориями в WordPress, позволяя получить ссылку на категорию по ее ID или объекту категории. Также, с помощью глобальной переменной $wp_query, можно получить ссылку на текущую активную категорию без указания ID или объекта.

Как обработать ошибку, если категория не существует?

Если категория не существует, функция get_category_link() вернет пустую строку. Для обработки этой ошибки можно использовать условное выражение:


$category_link = get_category_link( $category );
if ( $category_link ) {
    echo 'Ссылка на категорию: ' . $category_link;
} else {
    echo 'Категория не существует.';
}

Как использовать полученную ссылку на категорию в шаблоне?

Полученную ссылку на категорию можно использовать в шаблоне, например, для создания ссылки на страницу категории:


$category_link = get_category_link( $category );
if ( $category_link ) {
    echo '<a href="' . $category_link . '">Ссылка на категорию</a>';
}

Как получить ссылку на категорию с учетом настроек ЧПУ?

Для получения ссылки на категорию с учетом настроек ЧПУ (Человекопонятные URL) нужно передать в функцию get_category_link() объект категории или ID категории:


$category = get_category( $category_id );
$category_link = get_category_link( $category );
if ( $category_link ) {
    echo 'Ссылка на категорию: ' . $category_link;
}

Функция get_category_link() позволяет получить ссылку на категорию в WordPress. Она возвращает строку с URL ссылкой на категорию, если она существует, и пустую строку в противном случае. Для обработки ошибки, если категория не существует, можно использовать условное выражение. Полученную ссылку на категорию можно использовать в шаблоне для создания ссылки на страницу категории. Если требуется получить ссылку с учетом настроек ЧПУ, необходимо передать в функцию объект категории или ID категории.

Связанные элементы

  • Функция get_category(): возвращает объект категории по ID или объекту.
  • Функция get_categories(): возвращает массив объектов всех категорий.
  • Функция get_category_by_slug(): возвращает объект категории по его слагу.
  • Функция get_category_by_path(): возвращает объект категории по его пути.
  • Функция get_category_parents(): возвращает массив родительских категорий для указанной категории.
  • Функция get_category_template(): возвращает путь к шаблону категории.
  • Функция get_the_category(): возвращает массив объектов категорий для текущего поста.
  • Функция get_the_category_list(): выводит список категорий для текущего поста.
  • Хук pre_get_terms: позволяет изменять параметры запроса категорий перед их получением.
  • Класс WP_Term_Query: класс для выполнения запросов категорий.
Обсуждение