Описание функции wp_get_archives()
Функция wp_get_archives() выводит список архивов записей на основе различных критериев, таких как дата публикации, тип записи и т. д. Она может использоваться для создания виджетов или в темах для отображения архива постов. Функция поддерживает различные форматы отображения и может быть настроена с помощью параметров
Вывод может быть в виде списка, выпадающего меню или другого формата, в зависимости от заданных параметров
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив параметров для настройки вывода архивов
Возможные значения:
type: monthly, daily, weekly
limit: максимальное количество архивов для отображения
format: html, option
before: строка перед выводом каждого архива
after: строка после вывода каждого архива
show_post_count: 1,
echo: 1,
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает, выводит результат напрямую
Возможные значения:
• HTML-код списка архивов
• HTML-код выпадающего меню
Примеры использования
Выводит стандартный список архивов
wp_get_archives();
Использует настройки по умолчанию
Выводит архивы за последние 12 месяцев в формате HTML
$args = array(
'type' => 'monthly',
'limit' => 12,
'format' => 'html'
);
wp_get_archives($args);
Выводит архивы по месяцам
Создает выпадающее меню с архивациями по месяцам
$args = array(
'type' => 'monthly',
'format' => 'option'
);
wp_get_archives($args);
Каждый месяц будет представлен как опция в выпадающем меню
Безопасность
Валидация входных данных: Параметры проверяются внутри функции
Санитизация: Функция очищает выводимые данные
Рекомендации: При необходимости используйте esc_html() для форматирования выводимых данных
— Связанные функции
Получает массив архивов без вывода
Получает последние записи блога
— Хуки
Фильтрует параметры перед выводом архивов
Фильтрует выводимые результаты архивов
— Примечания
– Ограничения
Функция не поддерживает пользовательские типы записей по умолчанию
– Частые проблемы
- Ошибка вывода при некорректных параметрах
- Проблемы с отображением при отсутствии записей