Теги шаблонов WordPress - Теги менеджера ссылок.
- get_links_list (Не поддерживается с 2.3)
- wp_get_links (Не поддерживается с 2.3)
- get_links (Не поддерживается с 2.3)
- wp_list_bookmarks (C версии 2.1)
- wp_get_linksbyname (Не поддерживается с 2.1)
- get_linksbyname (Не поддерживается с 2.1)
get_links_list
Не поддерживается с версии 2.3, заменена на wp_list_bookmarks.
wp_get_links
Не поддерживается с версии 2.3, заменена на wp_list_bookmarks.
get_links
Не поддерживается с версии 2.3, заменена на wp_list_bookmarks.
wp_list_bookmarks
Выводит ссылки из панели Администрирование -> Ссылки -> Управление ссылками(Blogroll).
Параметры:
- categorize
- (*boolean*) Выводить ссылки с оглавлением в виде присвоеной им категории (TRUE) или выводить общим списком (FALSE). По умолчанию TRUE. - 1 (True – по умолчанию) - 0 (False)
- category
- (*string*) Список ID категорий для вывода, разделенные запятыми. Если не указано то выводятся все категории. По умолчанию * (все категории).*
- category_name
- (*string*) Имя категории чьи ссылки будут выведены. Если не указано то выводятся все категории. По умолчанию * (все категории).*
- category_before
- (*string*) Текст подставляемый до каждой категории. По умолчанию '
- '
. - 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, оглавление не выводится, также список не обрамляется тегами
- ,
- title_before
- (*string*) Текст выводимый до заголовка каждой категории, если ‘categorize’ равно TRUE. По умолчанию '
'
. - title_after
- (*string*) Текст выводимый после заголовка каждой категории, если ‘categorize’ равно TRUE. По умолчанию ''.
- 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*) Текст размещаемые перед каждой ссылкой. По умолчанию '
- '
. - after
- (*string*) Текст размещаемые после каждой ссылкой. По умолчанию ''.
- category_before
- (*string*) Текст размещаемые перед каждой категории. По умолчанию '
- '
с присваиванием соответствующего id и class. - category_after
- (*string*) Текст размещаемые после каждой категории. По умолчанию ''.
- 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)
Примеры:
Значения по умолчанию
$defaults = array( 'orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '', 'category_name' => '', 'hide_invisible' => 1, 'show_updated' => 0, 'show_description' => 1, 'echo' => 1, 'categorize' => 1, 'title_li' => __('Bookmarks'), 'title_before' => '<h2>', 'title_after' => '</h2>', 'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat', 'category_before' => '<li id="%id" class="%class">', 'category_after' => '</li>' );
При значениях по умолчанию:
<?php wp_list_bookmarks(); ?>
- Ссылки разделяются по категориям с заголовками категорий
- Все ссылки включены
- Сортировка по названию
- An image if one is included
- Пробел между картинкой и текстом
- Описание ссылок выводится
- Рейтинг не показывается
- Если limit не установлен выводятся все ссылки
- Ссылки выводятся
Вывести все ссылки с заголовком “Закладки” и каждая ссылка заключается в теги <li>
. Заголовок заключается в теги <h2>
:
<?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>
Вывести отсортированный список с описанием на новой строке, не используя картинки для ссылок, с сортировкой по id, показать рейтинг и время последнего изменения:
<ol> <?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?> </ol>
wp_get_linksbyname
Не поддерживается с версии 2.1, заменена на wp_list_bookmarks.
get_linksbyname
Не поддерживается с версии 2.1, заменена на wp_list_bookmarks.