Описание функции wp_list_bookmarks()
Функция wp_list_bookmarks() генерирует HTML-список закладок (ссылок), которые могут быть использованы для отображения на сайте. Она позволяет настраивать параметры отображения, такие как порядок, категории и множество других параметров. Это полезно для создания раздела с ссылками на сторонние ресурсы или внутренние страницы.
Функция может быть использована в любой части темы или плагина, где требуется вывод ссылок.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки вывода закладок
Возможные значения:
category: ID категории закладок
orderby: name, id, url, description, rating
order: ASC, DESC
limit: Максимальное количество выводимых закладок
before: HTML перед каждой закладкой
after: HTML после каждой закладки
Возвращаемое значение
Тип: void
Описание: Функция выводит HTML-код на экран, не возвращая его
Возможные значения:
• HTML-код списка закладок
• При отсутствии закладок вывод пустого результата
Примеры использования
Выводит все закладки без дополнительных параметров
wp_list_bookmarks();
Список закладок будет отображен по умолчанию
Выводит 10 закладок, отсортированных по имени в порядке возрастания
$args = array(
'orderby' => 'name',
'order' => 'ASC',
'limit' => 10
);
wp_list_bookmarks($args);
Используется сортировка для удобства
Проверка наличия закладок перед выводом
if ( ! have_rows('bookmarks') ) {
echo 'Закладки отсутствуют';
} else {
wp_list_bookmarks();
}
Избегает вывода пустого списка
Вывод заголовка и закладок из конкретной категории
<div class='bookmarks'>
<h2>Полезные ссылки</h2>
<?php wp_list_bookmarks(array('category' => 5)); ?>
</div>
Отображает закладки только из категории с ID 5
Безопасность
Валидация входных данных: Параметры проходят внутреннюю валидацию
Санитизация: Автоматическая очистка параметров WordPress
Рекомендации: Санитизируйте выводимые данные с помощью esc_html()
— Связанные функции
Получает массив закладок
Добавляет новую закладку
— Хуки
Фильтрует закладки перед выводом
— Примечания
– Ограничения
Не поддерживает пользовательские типы закладок по умолчанию
– Частые проблемы
- Пустой вывод при отсутствии закладок в базе данных
- Ошибки при неверном указании ID категории
