Доброго времени суток. В данной статье мы продолжаем рассматривать теги для шаблонов WordPress. Так в прошлой статье Теги для работы с автором (авторами) постов WordPress  мы с Вами рассмотрели теги для работы с автором (авторами) постов. А сегодня мы остановимся на тегах для работы с закладками. Тут хотелось бы немного уточнить, что подразумевается под термином “закладки”. Закладки в WordPress — это ссылки, которые Вы можете добавлять из админки WordPress, перейдя по Ссылки. Ну, что ж, хватит лирики и давайте приступим.

Прежде, чем начнем изучать теги для работы с ссылками создадим рубрику “test” и добавим в нее пару ссылок. Теперь нам надо узнать их ID. Для этого зайдите в phpmyadmin или другим клиентом для работы с базой MySQL, перейдите в базу данных вашего ресурса и зайдите в таблицу <префикс>_links. В этой таблице хранятся ссылки, которые Вы добавляете на Вашем ресурсе через админку. И в поле link_id посмотрите ID только, что добавленных ссылок.
Теги для работы с ссылками:

• wp_list_bookmarks
• get_bookmark
• get_bookmark_field
• get_bookmarks

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