Описание функции get_year_link()
Функция get_year_link() генерирует URL для архива записей за указанный год. Она используется для создания ссылок на страницы архивов, которые отображают все записи, опубликованные в данном году.
Функция полезна для тем и плагинов, которые требуют отображения архивов записей по годам.
Параметры
$year
Тип: int
Обязательный: Да
Описание: Год, для которого необходимо получить ссылку на архив записей
Возможные значения:
Возвращаемое значение
Тип: string
Описание: URL-ссылка на архив записей за указанный год
Возможные значения:
• Полный URL-адрес архива, например, ‘https://example.com/2023/’
• Пустая строка если год не указан
Примеры использования
$year_link = get_year_link(2023);
// Вывод ссылки
echo $year_link; // 'https://example.com/2023/'
Проверка на наличие ошибки при получении ссылки
$year = 2025;
if ($year_link = get_year_link($year)) {
echo $year_link;
} else {
echo 'Ошибка получения ссылки';
}
Безопасность
Валидация входных данных: Параметр year проходит валидацию внутри функции
Санитизация: Функция автоматически очищает входные данные
Рекомендации: Используйте esc_url() для безопасного вывода URL
— Связанные функции
Получает ссылку на архив записей за указанный месяц
Получает ссылку на архив записей за указанный день
— Примечания
– Ограничения
Функция возвращает пустую строку при неверных данных
– Частые проблемы
- Некорректный год может привести к пустому результату
- Необходимо учитывать настройки постоянных ссылок для правильного формирования ссылки
