WP_list_bookmarks(): вывод закладок с аргументами и примерами

# WP_LIST_BOOKMARKS() │ WP 2.1.0

Функция wp_list_bookmarks() позволяет вывести (или вернуть) все закладки на вашем сайте WordPress. 

## Аргументы по умолчанию

Функция принимает ряд аргументов, кот��рые определяют, как будут отображаться закладки:

- **orderby**: Как сортировать закладки. Принимает поля постов. По умолчанию 'name'.
- **order**: Направление сортировки. Можно выбрать 'ASC' (по возрастанию) или 'DESC' (по убыванию). По умолчанию 'ASC'.
- **limit**: Количество закладок для отображения. Примите 1 или больше, или -1 для всех. По умолчанию '-1'.
- **category**: Идентификаторы категорий, закладки из которых нужно отобразить. По умолчанию пусто.
- **hide_invisible**: Показать или скрыть невидимые закладки. Можно использовать 1 (да) или 0 (нет). По умолчанию 1 (да).
- **show_updated**: Показать время последнего обновления закладки. Принимает 1 (да) или 0 (нет). По умолчанию 0 (нет).
- **echo**: Показать или вернуть закладки. Принимает 1 (да) или 0 (нет). По умолчанию 1 (да).
- **categorize**: Показать закладки по категориям или в одном столбце. Принимает 1 (по категориям) или 0 (в один столбец). По умолчанию 1 (да).
- **show_description**: Показать описания закладок. Принимает 1 (да) или 0 (нет). По умолчанию 0 (нет).
- **title_li**: Что показать перед закладками. По умолчанию 'Закладки'.
- **title_before**: HTML или текст, который добавляется перед title_li. По умолчанию '
'.
- **title_after**: HTML или текст, который добавляется после title_li. По умолчанию '
'.
- **class**: CSS класс или массив классов для title_li. По умолчанию 'linkcat'.
- **category_before**: HTML или текст, который добавляется перед категорией если категории включены. Должен содержать '%id' и '%class'.
- **category_after**: HTML или текст, который добавляется после категории, если категории включены. По умолчанию ''.

## Возвращаемое значение

Функция либо ничего не возвращает (если echo равно true), либо возвращает HTML-код списка закладок (если echo равно false).

## Использование

Пример использования функции:

```php

Где $args — это строка или массив аргументов для вывода закладок.

Примеры использования функции

Пример 1: Список ссылок закладок

Показать список ссылок с заголовком "Ссылки", элементы списка будут обернуты в тег <li>, заголовок — в теге <h2>.

Пример 2: Удаление заголовка из списка

Список без заголовка. Полезно, когда вам нужен свой собственный заголовок.

Пример 3: Ссылки из конкретной категории

Вывод ссылок из категории (например, с идентификатором 2). Испо��ьзует тег <span> для обертки каждой ссылки.

&after=&show_images=1&show_description=0&orderby=url' ); ?>

Пример 4: Замена заголовка изображением

Как заменить заголовок списка изображением.

wp_list_bookmarks( [
    'categorize'   => 0,
    'title_before' => '',
    'title_after'  => '',
    'title_li'     => '',
] );

Пример 5: Показать рейтинги и дату обновления

Список всех закладок с описаниями на новой строке, сортировка по ID закладки и показ времени последнего обновления.

&show_images=0&orderby=id&show_rating=1&show_updated=1'
); ?>

Примечания

• Для более продвинутого использования можно ознакомиться с функцией _walk_bookmarks().

Изменения

Функция была введена в версии 2.1.0.