Тег шаблона: wp_list_authors

15.02.2010
Описание

Этот тег шаблона выводит список авторов блога. Имена авторов являются также ссылкой на их записи (только если у автора есть опубликованные записи). Опционально тег может выводить число записей у авторов и ссылку на их персональную RSS ленту.

Использование
<?php wp_list_authors( $args ); ?>
По умолчанию
 <?php $args = array(
    'optioncount'   => false, 
    'exclude_admin' => true, 
    'show_fullname' => false,
    'hide_empty'    => true,
    'echo'          => true,
    'feed'          => [empty string], 
    'feed_image'    => [empty string],
    'style'         => list,
    'html'          => [empty string]
 ); ?>

Функция по умолчанию:

  • не выводит число записей у авторов
  • исключает из списка администратора блога (только главного с логином "admin")
  • выводит имя автора, как указано в его профиле в опции "Отображать как"
  • исключает из списка авторов без опубликованных записей
  • выводит результаты
  • не выводит картинку и ссылку на RSS ленту авторов
  • выводит список в list формате (в тегах <li> и </li>)
  • выводит элементы списка как HTML
Параметры

optioncount

(boolean) (необязательный) вывод числа записей у авторов.

  • 1 (true)
  • 0 (false) - по умолчанию

exclude_admin

(boolean) (необязательный) - исключение из списка администратора блога (исключается только администратор с логином "admin").

  • 1 (true) - по умолчанию
  • 0 (false)

show_fullname

(boolean) (необязательный) - вывод полного имени авторов (имя фамилия).

  • 1 (true)
  • 0 (false) - по умолчанию

hide_empty

(boolean) (необязательный) - скрытие авторов без опубликованных записей.

  • 1 (true) - по умолчанию
  • 0 (false)

echo

(boolean) (необязательный) - вывод результатов работы тега.

  • 1 (true) - по умолчанию
  • 0 (false)

feed

(строка) (необязательный) - текст для ссылки на RSS ленту автора. если текст не указан, то и ссылка не будет выводиться.

feed_image

(строка) (необязательный) - урл картинки для ссылки на RSS ленту автора. при заданном параметре feed_image параметр feed будет игнорироваться.

style

(boolean) (необязательный) - стиль отображения списка авторов блога. на момент публикации этой статьи (версия WordPress 2.9.1) использование значения none у параметра style невозможно, список авторов просто не будет показан вообще.

  • list - по умолчанию
  • none

html

(boolean) (необязательный) - определение формата выводимого списка. если значение параметра равно true, то список будет выведен в HTML разметке, а если значение будет false, то список будет выведен как чистый текст (авторы будут перечислены через запятую и без ссылок на их записи). если значение параметра html задано как false, то параметр style будет полностью проигнорирован.

  • 1 (true) - по умолчанию
  • 0 (false)
Примеры

1. Вывод списка авторов с полными именами и числом записей

Данный код выведет список авторов блога с их полными именами (если они заданы, в противном случае будут показаны отображаемые имена) и число записей каждого автора. Также, по умолчанию, не будет выведен как автор администратор блога, не будут выведены авторы без опубликованных записей и не будут показаны ссылки на RSS ленты авторов.

<?php wp_list_authors('show_fullname=1&optioncount=1'); ?>
Примерный вывод данного кода будет таким:
 
Василий Пупкин (45)
DedMazai (12)
Геннадий Васильев (26)

2. Вывод списка авторов блога с ссылкой на их RSS ленты.

Данный код выведет список авторов блога, включая администратора блога. Будут использованы отображаемые имена, не будет показано число записей у авторов и будут выведены ссылки на RSS ленты авторов с анкором "RSS лента".

<?php wp_list_authors('exclude_admin=0&optioncount=0&feed=RSS лента'); ?>
Примерный вывод данного кода будет таким:
 
admin (RSS лента)
Pupkin (RSS лента)
DedMazai (RSS лента)
Gena (RSS лента)
Лог изменений

Функция добавлена в версии 1.2.0
Параметры style и html были добавлены в версии 2.8

Исходный файл

Функция wp_list_authors() находится в wp-includes/author-template.php

Связанные теги|функции
Рубрики: Теги шаблоновФункции WordPressУсловные теги

Понравился пост? Подпишись на обновления по Обновления блога по RSSRSS или Обновления блога на TwitterTwitter !

Комментарии (всего 13 комментариев)
Написать комментарий

(обязательно)

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

Для вставки кода используйте кнопку "Код", по умолчанию используется синтаксис подсветки языка "php", вы можете поменять его на любой другой поддерживаемый GeSHi язык, например "javascript", "css", "html4strict", "sql" и тд. Используйте предпросмотр!
 


Подписаться на уведомления без комментирования.