Теги для работы с закладками WordPress — теги для работы с ссылками на другие ресурсы

Ромчик
1

Создание своей темы для 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

Понравилась статья? Поделись с друзьями.
  • Add to favorites
  • Добавить ВКонтакте заметку об этой странице
  • Twitter
  • Facebook
  • Мой Мир
  • LiveJournal
  • Одноклассники
  • Блог Я.ру
  • MySpace
  • FriendFeed
  • В закладки Google
  • Google Buzz
  • Яндекс.Закладки
  • Reddit
  • StumbleUpon
  • Technorati
  • del.icio.us
  • БобрДобр
  • LinkedIn
  • Memori.ru
  • Сто закладок
  • Blogger

  • Теги для работы с категориями WordPress | Все о WEB программировании - 04.03.2012 в 15:57

    […] Мы с Вами продолжаем изучать теги для шаблонов WordPress. В прошлой статье мы с Вами рассмотрели теги для работы с закладками. А […]

  • ©2012-2017 По всем вопросам обращайтесь через форму обратной связи

    Яндекс.Метрика