Описание:
Выводит ссылки из панели Администрирование -> Ссылки -> Управление ссылками (Blogroll).
Использование:
<?php wp_list_bookmarks(); ?>
Пример:
Вывести отсортированный список с описанием на новой строке, не используя картинки для ссылок, с сортировкой по id, показать рейтинг и время последнего изменения:
<ol>
<?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
</ol>
Параметры:
categorize
(boolean) Выводить ссылки с оглавлением в виде присвоеной им категории (TRUE) или выводить общим списком (FALSE). По умолчанию TRUE.
* 1 (True - по умолчанию)
* 0 (False)
category
(string) Список ID категорий для вывода, разделенные запятыми. Если не указано то выводятся все категории. По умолчанию (все категории).
category_name
(string) Имя категории чьи ссылки будут выведены. Если не указано то выводятся все категории. По умолчанию (все категории).
category_before
(string) Текст подставляемый до каждой категории. По умолчанию ‘<li id=”[category id]” class=”linkcat”>’ .
category_after
(string) Текст подставляемый после каждой категории. По умолчанию ‘<’/li>’ .
class
(string) CSS Класс присваемый для тега li каждой категории. По умолчанию ‘linkcat’ .
category_orderby
(string) Сортировка категорий. По умолчанию по ‘name’. Значения:
* ‘name’ (По умолчанию)
* ‘id’
category_order
(string) Порядок сортировки, по возрастанию, убыванию для параметра category_orderby. Значения:
* ASC (По умолчанию)
* DESC
title_li
(string) Текст для заголовка списка ссылок. По умолчанию ‘__(’Закладки’)’, который выведет “Закладки” (__(”) используется для локализации). Используется только когда параметр categorize = 0 (иначе выводятся названия категорий). Если установить значение 0, оглавление не выводится, также список не обрамляется тегами <ul>, </ul>.
title_before
(string) Текст выводимый до заголовка каждой категории, если ‘categorize’ равно TRUE. По умолчанию ‘<h2>’.
title_after
(string) Текст выводимый после заголовка каждой категории, если ‘categorize’ равно TRUE. По умолчанию ‘</h2>’.
show_private
(boolean) Выводить ли категории даже если они приватные. Админские настройки игнорируются и приватные категории выводятся (TRUE) или не выводятся (FALSE). По умолчанию FALSE.
* 1 (True)
* 0 (False - по умолчанию)
include
(string) Разделенный запятыми список ID ссылок для добавления в список. Для примера, ‘include=1,3,6? выводит только ссылки с ID 1, 3, и 6. Если параметр include используется, то параметры category, category_name, и exclude игнорируются. По умолчанию (все Ссылки).
exclude
(string) Разделенный запятыми список ID ссылок для исключения. Для примера, ‘exclude=4,12? исключает из списка ссылки с IDs 4 и 12. По умолчанию (ничего не исключается).
orderby
(string) Значение для сортировки ссылок. По умолчанию по ‘name’. Значения:
* ‘id’
* ‘url’
* ‘name’
* ‘target’
* ‘description’
* ‘owner’ - Пользователь, который добавил закладку через Менеджера закладок.
* ‘rating’
* ‘updated’
* ‘rel’ - отношение к ссылке (XFN).
* ‘notes’
* ‘rss’
* ‘length’ - Длина названия закладки, от самого короткого к самому длинному.
* ‘rand’ - Выводить ссылки в случайном порядке.
order
(string) Порядок сортировки: по возрастанию, убыванию для параметра category_orderby. Значения:
* ASC (По умолчанию)
* DESC
limit
(integer) Максимальное количество выводимых ссылок. По умолчанию -1 (все ссылки).
before
(string) Текст размещаемые перед каждой ссылкой. По умолчанию ‘<li>’.
after
(string) Текст размещаемые после каждой ссылкой. По умолчанию ‘</li>’.
category_before
(string) Текст размещаемые перед каждой категории. По умолчанию ‘<li>’ с присваиванием соответствующего id и class.
category_after
(string) Текст размещаемые после каждой категории. По умолчанию ‘</li>’.
between
(string) Текст между каждой ссылкой/картинка и описанием. По умолчанию ‘\n’ (новая строка).
show_images
(boolean) Показывать картинки к ссылкам (TRUE) или нет (FALSE). По умолчанию TRUE.
* 1 (True - По умолчанию)
* 0 (False)
show_description
(boolean) Показывать описание (TRUE) или нет (FALSE). Доступно когда show_images равно FALSE, или картинка не задана. По умолчанию FALSE.
* 1 (True)
* 0 (False - По умолчанию)
show_rating
(boolean) Показывать рейтинг в виде звездочек/символов (TRUE) или нет (FALSE). По умолчанию FALSE.
* 1 (True)
* 0 (False - По умолчанию)
show_updated
(boolean) Показывать время последнего изменения (TRUE) или нет (FALSE). По умолчанию FALSE.
* 1 (True)
* 0 (False - По умолчанию)
hide_invisible
(boolean) Показывать ссылки параметр Visible установлен в No. Использует админские настройки (TRUE) или нет (FALSE). По умолчанию TRUE.
* 1 (True - По умолчанию)
* 0 (False)
echo
(boolean) Выводить (TRUE) или возвратить (FALSE). По умолчанию TRUE.
* 1 (True - По умолчанию)
* 0 (False)