Функция wp_list_bookmarks() предназначена для форматированного вывода внешних ссылок созданных в панели администратора с помощью панели управления ссылками и категориями (рубриками) ссылок (Links). wp_list_bookmarks используется в шаблонах и позволяет определить порядок сортировки и отображения внешних ссылок.

Функция по умолчанию отображает:

* Все ссылки и названия категорий (рубрик)
* Ссылки отсортированы по имени
* Все изображения присутствующие в настройках ссылок
* Пробел между изображением или именем ссылки и текстом ссылки
* Короткое описание ссылки ( description)

<?php wp_list_bookmarks(); ?>

Простой список

Отображает все ссылки. Ссылки “завернуты” в HTML тэг <li> . Название категорий оформлено с помощью тэга <h2> .

[sourcecode language='php']
< ?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>[/sourcecode]

Простой список без названий рубрик

Отображает все ссылки, но названия категорий не отображаются.

[sourcecode language='php']< ?php wp_list_bookmarks('title_li=&categorize=0'); ?>[/sourcecode]

Ссылки определенной рубрики отсортированные по URL

Отображает ссылки рубрики ID 2  “завернутых” в  span тэг, картинка вместо имени ссылки, краткое описание не показывается, сортировка по URL.

[sourcecode language='php']< ?php wp_list_bookmarks('categorize=0&category=2&before=&after=&show_images=1&show_description=0&orderby=url’); ?>[/sourcecode]

Показать рейтинг и время последнего обновления ссылки

Отображает ссылки списком с кратким описанием с новой строки, изображение не используется, сортировка по id ссылки, показываем рейтинг и время последнего обновления ссылки.

[sourcecode language='php']< ?php wp_list_bookmarks('between=
&show_images=0&orderby=id&show_rating=1&show_updated=1′); ?>[/sourcecode]

Параметры

categorize

(boolean) Управляет отображением названий категорий (рубрик ссылок). По умолчанию – True.

• 1 (True – default)
• 0 (False)

category

(string) Номера рубрик ссылки из которых будут отображены (разделять запятыми) . Если не используется, отображаются все ссылки из всех рубрик.

exclude_category

(string) Номера рубрик ссылки из которых не будут отображены (разделять запятыми).

category_name

(string) Имя рубрики, ссылки из которой будут отображены.

category_before

(string) Тэг отображаемый перед названием категории. По умолчанию ‘<li id=”[category id]” class=”linkcat”>’ .

category_after

(string) Тэг отображаемый после  названиякатегории. Defaults to ‘<’/li>’ .

category_orderby

(string) Порядок сортировки рубрик.  По умолчанию ‘name’- по имени. Доступно:

• ‘name’ (Default)
• ‘id’
• ‘slug’
• ‘count’

category_order

(string) Сортировка рубрик . Valid values:

• ASC (Default) Возрастанию
• DESC Убыванию

title_li

(string) Тэг заголовка категории. По умолчанию ‘__(‘Bookmarks’)’. Используется только если categorize установлено как  0. Если устновлено как null (0), заголовки (имена категорий) не отображаются.

title_before

(string) Тэг перед именем категории . Если  ‘categorize’  -  TRUE.  По умолчанию ‘<h2>’.

title_after

(string) Тэг после имени категории . Если  ‘categorize’  -  TRUE.  По умолчанию ‘</h2>’.

show_private

(boolean) Управляет выводом “частных” ссылок. Игнорирует настройки администратора.

• 1 (True) – отображает ссылку
• 0 (False – default) – запрещает показ ссылки

include

(string) Разделенный запятыми список ID ссылок для показа.

exclude

(string) Разделенный запятыми список ID ссылок запрещенных к показу.

orderby

(string) Порядок сортировки ссылок. Доступно:

• ‘id’
• ‘url’
• ‘name’
• ‘target’
• ‘description’
• ‘owner’
• ‘rating’
• ‘updated’
• ‘rel’
• ‘notes’
• ‘rss’
• ‘length’
• ‘rand’

order

(string) Сортировка ссылок. Доступно:

• ASC (Default)
• DESC

limit

(integer) Максимальное количество показываемых ссылок. По умолчанию -1 (все ссылки).

before

(string) Тэг перед названием ссылки. По умолчанию ‘<li>’.

after

(string) Тэг после названия ссылки. По умолчанию ‘</li>’.

link_before

(string) Тэг или текст перед текстом ссылки включая код ссылки. (Версия 2.7 )

link_after

(string) Тэг или текст после текста ссылки. (Версия 2.7 ) )

between

(string) Текст или тэг между изображением и описанием ссылки. По умолчанию ‘\n’ (перевод строки).

show_images

(boolean) Управляет показом изображения. По умолчанию TRUE.

• 1 (True)
• 0 (False)

show_description

(boolean) Should the description be displayed (TRUE) or not (FALSE). Valid when show_images is FALSE, or an image is not defined. Defaults to FALSE.

• 1 (True)
• 0 (False – default)

show_name (2.7)

(boolean) Отображает имя ссылки. Действует только когда show_images  – TRUE. Используется в случае если необходимо кроме картинки показать имя ссылки.

• 1 (True)
• 0 (False – default)

show_rating

(boolean) Управляет показом рейтинга.

• 1 (True)
• 0 (False – default)

show_updated

(boolean) Отображение времени и даты последнего обновления ссылки.

• 1 (True)
• 0 (False – default)

hide_invisible

(boolean) Отображает управлением “невидимых” ссылок.

• 1 (True – default)
• 0 (False)

echo

(boolean) Отображает ссылки (TRUE) или возращает код ошибки PHP (FALSE). По умолчанию TRUE.

• 1 (True – default)
• 0 (False)