Уроки WordPress

Если у вас набралась целая коллекция ссылок, и в блогролле они занимают много места, можно вынести их на отдельную страницу. Для этого WordPress предоставляет прекрасные возможности.

Используйте тег wp_list_bookmarks () и отдельный шаблон для статической страницы.

Рассмотрим это подробнее.

Что бы создать отдельный шаблон, сохраните файл темы page.php (если такого нет, то index.php), и дайте ему другое название, например, bookmarks.

В этом новом файле в самом верху указываем:

<?php
/*
Template Name: bookmarks
*/
?>

Далее находим цикл вывода конетнта, который начинается так:

<?php if (have_posts()) : while (have_posts()) : the_post(); ?>

и заканчивается вот так:

<?php endwhile; endif; ?>

Удаляем весь этот цикл, и вместо этого вставляем тег вызова ссылок

<?php wp_list_bookmarks('параметры'); ?>

Из Кодекса WordPress

По умолчанию используются такие параметры:

'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',

Рассмотрим их подробнее.

categorize

(boolean) Ссылки должны отображаться вместе с рубрикой которая им назначена (TRUE)  или нет (FALSE). По умончанию TRUE.

1 (True – по умолчанию)

0 (False)

category

(string) Разделенный запятыми список номеров категорий (ID), которые должны отображаться. Если ничего не определено, будут отображаться все категории, используется по умолчанию.

category_name

(string) Название рубрики, ссылки из которой должны отображаться. Если ничего не определено, будут отображаться все категории, используется по умолчанию.

category_before

(string) Текст, который должен быть перед названием рубрики. По умолчанию '<li id=[category id]«„ class=“linkcat»>' .

category_after

(string) Текст, который должен быть после названия рубрики. По умолчанию '<'/li>' .

class

(string) CSS-class, который назначается каждому элементу li рубрик. По умолчанию 'linkcat' .

category_orderby

(string) Способ сортировки категорий. По умолчанию 'name'. Можно использовать:

'name' (по умолчанию)

'id'

'slug'

'count'

'term_group' (пока не используется)

category_order

(string) Сортировка рубрик по возрастанию или по убыванию для параметра category_orderby. Можно использовать:

ASC (По умолчанию – по возрастанию)

DESC

title_li

(string) Название списка ссылок. По умолчанию '__ ('Bookmarks')',  по идее используя русскую локализацию сразу будет выводиться заголовок «Закладки». Используется только если аргумент categorize равен 0 (иначе будут использоваться заголовки рубрик). Если присвоить значение (0), заголовок не будет показан, и список не будет обрамлен  тегами <ul>, </ul>.

title_before

(string) Текст, который отображается перед описанием каждой рубрики, если парамтер 'categorize'  - TRUE. По умолчанию '<h2>'.

title_after

(string) Текст, который отображается после описания каждой рубрики, при условии что параметыр 'categorize' — TRUE. По умолчанию '</h2>'.

show_private

(boolean) Должна ли рубрика отображаться, даже если она считается приватной. Игнорировать настройи админа и показывать личные рубрики (TRUE) или НЕ показывать личные рубрики (FALSE). По умолчанию FALSE.

1 (True)

0 (False – по умолчанию)

include

(string) Разделенные запятыми номера закладок (id), которые необходимо показывать. Напрмер,

'include=1,3,6'

значит, что будут показаны закладки с is 1, 3, и 6. Если используется параметр include, игнорируются параметры category, category_name, и exclude. По умолчанию отображаются все ссылки.

exclude

(string) Разделенные запятыми номера закладок (id), которые необходимо исключить. Напрмер,

'exclude=4,12'

означает, что надо будут исключены из показа закладки с номерами 4 и 12. По умолчанию ничего не исключается.

orderby

(string) Параметр для сортировки ссылок. По умолчанию 'name', пока вы не оставите значение пустым '', в этом случае сортировка будет просизодить по 'id'. Можно использовать:

'id'

'url'

'name'

'target'

'description'

'owner' – Пользователи, которые добавляют ссылки через админку.

'rating'

'updated'

'rel' – Отношение к ресурсу (XFN).

'notes'

'rss'

'length' – Длина ссылок.

'rand' – Показывать закладки в произвольном порядке.

order

(string) Сортировка списка по возрастанию или убыванию для параметра orderby. Можно использовать:

ASC (По умолчанию – по возрастанию)

DESC

limit

(integer) Максимальное количество закладок, которые можно отображать. По умолчанию -1 (все закладки).

before

(string) Текст, который выводится перед каждой закладкой. По умолчанию '<li>'.

after

(string) Текст, который выводится после каждой закладки. По умолчанию '</li>'.

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) Показывать закладки, даже когда в админке есть настройка не показывать их. (TRUE) – подчиняться настройкам в админке, (FALSE) – не подчиняться. По умолчанию TRUE.

1 (True – по умолчанию)

0 (False)

echo

(boolean) Показывать ссылки (TRUE) или возвращать их для использования в PHP (FALSE). По умолчанию TRUE.

1 (True — default)

0 (False)

Например, показывать все ссылки упорядоченным списком по id, описания с новой строки, не использовать картинки, показывать рейтинг и дату последнего изменения.

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

После того, как шаблон готов, мы загружаем его в папку с темой, далее идем в Админку создаем новую статическую страницу WordPress и в выпадающем меню Шаблон выбираем для нее шаблон bookmarks.

Анастасия, 30 Июл 2008. Рубрика: Разработка шаблонов. Комментарии RSS 2.0. Вы можете оставить трекбек.