Описание функции get_category_link()
Функция get_category_link() возвращает URL-адрес страницы категории на основе её ID. Это полезно, когда необходимо создать ссылку на страницу определенной категории в теме или плагине WordPress.
Функция используется в шаблонах для вывода ссылок на категории и в других местах, где требуется доступ к URL категорий.
Параметры
$category
Тип: int
Обязательный: Да
Описание: ID категории, для которой необходимо получить ссылку
Возможные значения:
Возвращаемое значение
Тип: string
Описание: URL-адрес страницы категории
Возможные значения:
• Полный URL-адрес для существующей категории
• Пустая строка в случае ошибки или если категория не найдена
Примеры использования
Базовый пример получения ссылки на категорию с ID 1
$category_link = get_category_link(1);
if ($category_link) {
echo 'Ссылка на категорию: ' . esc_url($category_link);
}
Ссылка на категорию: http://example.com/category/news/
Пример обработки случая, когда категория не существует
$category_link = get_category_link(999);
if (!$category_link) {
echo 'Категория не найдена';
}
Вывод: Категория не найдена
Безопасность
Валидация входных данных: ID категории проходит валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте esc_url() для вывода URL-адресов
— Связанные функции
Получает список категорий
Получает объект категории по ID
— Примечания
– Ограничения
Функция возвращает пустую строку для несуществующих категорий
– Частые проблемы
- Некорректный ID категории может привести к пустому результату
