Описание функции get_post_type_archive_link()
Функция get_post_type_archive_link() возвращает URL-адрес архива для записей заданного типа. Эту функцию обычно используют для создания ссылок на архивы пользовательских типов записей, чтобы пользователи могли легко навигировать по контенту сайта.
Функция полезна при создании тем и плагинов, которые добавляют новые типы записей и требуют соответствующих архивов для них.
Параметры
$post_type
Тип: string
Обязательный: Да
Описание: Имя типа записи, для которого нужно получить ссылку на архив
Возможные значения:
Возвращаемое значение
Тип: string|false
Описание: URL-адрес архива типа записи или false в случае ошибки
Возможные значения:
• Строка с URL-адресом при успешном выполнении
• false если архив не существует или тип записи не зарегистрирован
Примеры использования
Базовый пример получения ссылки на архив пользовательского типа записи
$archive_link = get_post_type_archive_link('my_custom_post_type');
if ($archive_link) {
echo 'Ссылка на архив: ' . $archive_link;
} else {
echo 'Архив не найден';
}
Ссылка на архив: http://example.com/my_custom_post_type/
Пример проверки существования архива для несуществующего типа записи
$archive_link = get_post_type_archive_link('non_existing_post_type');
if ($archive_link) {
echo 'Архив существует';
} else {
echo 'Архив не найден';
}
Архив не найден
Безопасность
Валидация входных данных: Функция проверяет, зарегистрирован ли тип записи перед возвратом ссылки
Санитизация: Входные параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_url() для URL-адресов
— Связанные функции
Получает объект типа записи по его имени
Выводит заголовок архива для заданного типа записи
— Примечания
– Ограничения
Возвращает только архивы для публичных типов записей
– Частые проблемы
- Возвращение false, если тип записи не зарегистрирован
- Ошибка в URL при неправильной настройке пермалинков
