Теги для работы с закладками WordPress — теги для работы с ссылками на другие ресурсы
Доброго времени суток. В данной статье мы продолжаем рассматривать теги для шаблонов WordPress. Так в прошлой статье Теги для работы с автором (авторами) постов WordPress мы с Вами рассмотрели теги для работы с автором (авторами) постов. А сегодня мы остановимся на тегах для работы с закладками. Тут хотелось бы немного уточнить, что подразумевается под термином “закладки”. Закладки в WordPress — это ссылки, которые Вы можете добавлять из админки WordPress, перейдя по Ссылки. Ну, что ж, хватит лирики и давайте приступим.
Прежде, чем начнем изучать теги для работы с ссылками создадим рубрику “test” и добавим в нее пару ссылок. Теперь нам надо узнать их ID. Для этого зайдите в phpmyadmin или другим клиентом для работы с базой MySQL, перейдите в базу данных вашего ресурса и зайдите в таблицу <префикс>_links. В этой таблице хранятся ссылки, которые Вы добавляете на Вашем ресурсе через админку. И в поле link_id посмотрите ID только, что добавленных ссылок.
Теги для работы с ссылками:
wp_list_bookmarks()
Эта функция отображает ссылки, которые Вы добавили через админку WordPress в панели ссылок. С помощью данного тега Вы можете контролировать как ссылки сортируются и как отображаются. В качестве параметра данная функция принимает массив аргументов следующего вида:
<!--?php $args = array( 'orderby' =--> 'name', 'order' => 'ASC', 'limit' => -1, 'category' => , 'exclude_category' => , 'category_name' => , 'hide_invisible' => 1, 'show_updated' => 0, 'echo' => 1, 'categorize' => 1, 'title_li' => __('Bookmarks'), 'title_before' => '</pre> <h2>', 'title_after' => '</h2> <pre> ', 'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat', 'category_before' => '</pre> <ul> <li id="%id" class="%class">', 'category_after' => '</li> </ul> <pre> ' ); ?>
где:
- orderby — по какому полю происходит сортировка. (‘id’, ‘url’, ‘name’ — по умолчанию, ‘target’, ‘description’, ‘owner’, ‘rating’, ‘updated’, ‘rel’, ‘notes’, ‘rss’, ‘length’, ‘rand’)
- order — порядок сортировки.
- limit — сколько будет показываться ссылок, по умолчанию -1, т.е. все.
- category — список категорий, из которых будут отображаться ссылки, перечисляются ID категрий и разделяются запятыми. По умолчанию пусто, т.е. из всех категорий.
- exclude_category — перечисляются категории, из которых не будут показываться ссылки. Перечисляются ID категорий через запятую. По умолчанию ничего не содержит.
- category_name — название категории, из которой будут показываться ссылки. По умолчанию из всех категорий.
- hide_invisible — соблюдать (1, т.е. true) настройки из админки или нет. По умолчанию стоит 1.
- show_updated — отображать (true) последние обновления или нет(flase). Обновление отслеживает через pingomatic. По умолчанию flase.
- echo — отображать (true) или возвращать результат для дальнейшей обработки.
- categorize — закладки должны показаны в рамках категорий (true) или нет (false). По умолчанию true.
- title_li — текст для заголовка списка ссылок. По умолчанию Закладки. Если поставить 0, то заголовка не будет.
- title_before — текст перед заголовком. По умолчанию <h2>.
- title_after — текст после заголовка. По умолчанию </h2>.
- category_orderby — по какому полю сортируются категории (‘name’ — по умолчанию, ‘id’, ‘slug’, ‘count’)
- category_order — порядок сортировки по категории.
- class — устанавливаемый класс для каждой категории. По умолчанию: linkcat
- category_before — текст перед категорией. По умолчанию <li id=%id class=%class>
- category_after — текст после категории. По умолчанию </li>
get_bookmark()
Получает данные о ссылке, по ее ID. В качестве параметров принимает $bookmark, $output, $filter, где
- $bookmark — ID ссылки
- $output — вид результата данной функции OBJECT, ARRAY_N, or ARRAY_A По умолчанию OBJECT
- $filter — филтр. По умолчанию raw
Пример:
Если Вы сделали то, что я говорил в начале этого поста, то у Вас есть две ссылки и Вы знаете их ID. Теперь выведем название ссылки по ID (у меня одна ссылка имеет ID=8, а другая ID=9)
<!--?php $bookmark = get_bookmark(8); echo $bookmark--->link_name; ?>
get_bookmark_field()
Получает одну ссылку или поле. Принимает следующие параметры: $field, $bookmark, $context, где:
- $field — имя поля
- $bookmark — ID ссылки
- $context — в контексте того, как поле будет использоваться
get_bookmarks()
Эта функция возвращает массив закладок, которые мы создали в админке в панели ссылок. Принимает массив параметров:
<!--?php $args = array( 'orderby' =--> 'name', 'order' => 'ASC', 'limit' => -1, 'category' => , 'category_name' => , 'hide_invisible' => 1, 'show_updated' => 0, 'include' => , 'exclude' => , 'search' => ); ?>
где:
- orderby — поле по клторому происзодит сортировка (‘id’, ‘url’, ‘name’ — по умолчанию, ‘owner’, ‘rating’, ‘updated’, ‘visible’, ‘length’,’rand’)
- order — тип сортировки
- limit — ограничение количество отображаемых ссылок, по умолчанию -1, т.е. нет ограничения
- category — перечисляем из каких категорий показывать ссылки. Перечисляем ID категорий через запятую. По умолчанию все.
- category_name — название категории, из которой показываем ссылки. По умолчанию пусто, т.е. из всех.
- hide_invisible — соблюдать (1, т.е. true) настройки из админки или нет. По умолчанию стоит 1.
- show_updated — отображать (true) последние обновления или нет(flase). Обновление отслеживает через pingomatic. По умолчанию flase.
- include — перечисляем через запятую ID категорий, из которых отображать ссылки
- exclude — перечисляем через запятую ID категорий, из которых не отображать ссылки
- search — Поиск link_url, link_name или link_description как строку поиска. Это установлено по умолчанию.
Пример:
В начале поста мы создали рубрику test и поместили туда две ссылки. Давайте выведем их в нашу тему.
<!--?php $bookmarks = get_bookmarks( array( 'orderby' =--> 'name', 'order' => 'ASC', 'category_name' => 'test' )); foreach ( $bookmarks as $bm ) { printf( '<a href="%s">%s</a> ', $bm->link_url, __($bm->link_name) ); } ?>
На этом примере мы завершаем рассмотрение тегов для работы с ссылками в WordPress. Если у Вас возникли вопросы — спрашивайте в комментариях и я обязательно отвечу на них.
В следующей статье мы рассмотрим теги для работы с категориями. А на этом все. И не пропускайте выхода новых постов, подписавшись на RSS-рассылку этого блога. Вы также можете найти много полезной информации на странице в facebook
[…] Мы с Вами продолжаем изучать теги для шаблонов WordPress. В прошлой статье мы с Вами рассмотрели теги для работы с закладками. А […]