Блогролл в wordpress – функция wp_list_bookmarks

Опубликовано: 01.09.2018

Блогролл – это список дружественных ссылок проекта. Формироваться он может из различных побуждений: то ли взаимный обмен, то ли дань уважения каким-то гуру из вашей ниши, то ли просто линки на интересные проекты. Иногда места в нем выступают в качестве призов конкурсов или акций, либо могут быть проданы. Кое-какие теоретические мысли по этому поводу есть в статье зачем и как лучше сделать блогролл .

Сейчас разработчики убрали старый механизм, и теперь нужно использовать модуль Link Manager или другие варианты создания списка ссылок для своего блогролла. Виджеты, в принципе, гораздо проще, советую!

Поскольку данный элемент не во всех шаблонах wordpress настроен оптимально (лично для меня), то есть смысл рассмотреть несколько моментов, что могут улучшить ситуацию, в частности поговорим о функции wp_list_bookmarks.

Раньше в WP, если кто не знал, редактировать и добавлять ссылки в блогролл вы можете в разделе админки «Ссылки». Там же можно создавать целые рубрики (группы ссылок) в случае необходимости.

Для каждой ссылки вы можете указать описание, название, урл, определить тип отношения и даже задать изображение и rss адрес. Возможностей вполне достаточно.

Чтобы всеми ими воспользоваться нам нужно изучить и применить функцию wp_list_bookmarks. Она имеет следующие параметры:

categorize – отображение ссылок по категориям или нет (тип boolean, то есть 1 – да, 0 – нет); category – перечень ID отображаемых категорий, если значение не определено, то выводятся все категории в блогролле; exclude_category – список ID категорий, которые исключены и не отображаются; category_name – имена и названия категорий, что должны быть выведены в блогролее; category_before – текст перед каждой категорией, по умолчанию это <li id="[category id]" class="linkcat">; category_after– текст после категорий, по умолчанию </li>; class – класс для тега li каждой из категорий, по дефолту – linkcat; category_orderby – параметр сортировки категорий: по имени (name), по id (id), по тексту ссылки в url  (slug), количеству (count) и некий term_group; category_order – тип сортировки по увеличению или уменьшению; title_li – текст заголовка. Очень важный параметр – по умолчанию отображается значение Bookmarks и только есть параметр categorize = 0, тогда будет показан заголовок. Когда title_li установлен в значение null (0), то блогролл не будет «оборачиваться» в теги ul; title_before и title_after – текст до и после заголовка категории; show_private– отображение приватных ссылок; include и exclude – перечень ID ссылок через запятую, которые нужно включить или соответственно исключить из отображения. При использовании этого параметра игнорируются category, category_name; orderby – параметр сортировки ссылок в блогролле – id, url, name (по умолчанию), target, description, owner (пользователи, добавившие ссылку через bookmarks Manager), rating, updated, rel, notes, rss, length (длинна ссылки), rand (случайная выборка); order – характер сортировки ссылок по уменьшению или увеличению; limit – максимальное число ссылок для отображения, по умолчанию «-1» (все ссылки); before и after – текст перед и после каждой ссылки, по дефолту это теги списка li; link_before и link_after – текст до и после закладок внутри ссылки (тега a); category_before и category_after – код до и после каждой категории, по дефолту li; between – код между изображением и описанием ссылки, по умолчанию это \n – перевод на новую строку; show_images– задает отображать картинки ссылок или нет; show_description – показывать описание ссылки или скрывать; show_name – отображает текст ссылки (работает если show_images = true); show_rating – показывать рейтинг ссылок; show_updated – выводить дату последнего обновления; hide_invisible – прятать невидимые ссылки или нет; echo – отображать ссылки в блогролле.

Вот такой совсем небольшой списочек настроек у функции wp_list_bookmarks.

Теперь парочку практических примеров для закрепления материала. В данном блоге я использую код :

<?php wp_list_bookmarks ( 'orderby=name&categorize=0&title_li=Друзья проекта&title_before=<div class="h2title">&title_after=</div>&category_before=&category_after=' ) ; ?>

<?php wp_list_bookmarks('orderby=name&categorize=0&title_li=Друзья проекта&title_before=<div class="h2title">&title_after=</div>&category_before=&category_after='); ?>

Здесь закладки отображаются по имени, отключено отображение по категориям (у меня всего одна), что дает возможность избавиться от вывода названия этой самой категории в качестве заголовка блока. Вместо этого у меня выводится текст «Друзья проекта», который заключен в div с нужным мне стилем. Также я убрал все стили перед и после категории.

Еще прикольные примеры из кодекса (там все подробно на английском есть). Вывод рейтинга и даты обновления:

<ol> <?php wp_list_bookmarks ( 'between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1' ) ; ?> </ol>

<ol> <?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?> </ol>

Здесь описания закладок отображаются с новой строки, без использования картинок, сортировка по id.

Следующий пример — замена заголовка на изображение :

<?php wp_list_bookmarks ( 'categorize=0&title_li=<img src="' . get_bloginfo ( "stylesheet_directory" ) . '/images/blogroll.gif" alt="blogroll" />' ) ; ?>

<?php wp_list_bookmarks('categorize=0&title_li=<img src="'.get_bloginfo("stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />'); ?>

Выводи специальную картинку вместо текстового заголовка блогролла. Да красивых и оригинальных дизайнов – то, что нужно.

rss