Доброго времени суток. Мы с Вами продолжаем изучать теги для шаблонов WordPress. В прошлом материале мы рассмотрели основные теги для шаблонов WordPress. Сегодня мы остановимся на тегах для работы с автором(авторами) постов в WordPress. Теги для работы с автором постов WordPress позволяют нам: выводит автора поста, выводит ссылку на ресурс автора, выводить дополнительную информацию об авторе и многое другое.

Теги авторов:

• the_author
• get_the_author
• the_author_link
• get_the_author_link
• the_author_meta
• the_author_posts
• the_author_posts_link
• wp_dropdown_users
• wp_list_authors
• get_author_posts_url

the_author ()
Данный тег выводит автора поста. Тег должен использоваться внутри механизма The Loop. Если необходимо получить данные для дальнейшей обработки, то необходимо использовать тег get_the_author. Может принимать параметр $post-id — id поста.
Пример:

<p>This post was written by <?php the_author(); ?></p>

Наверх

get_the_author()
Данный тег возвращает автора поста для дальнейшей обработки. Необходимо использовать в механизме The Loop.
Пример:

<?php $author = get_the_author(); ?>

Наверх

the_author_link()
Этот тег выводит ссылку на сайт автора сообщения. Данный адрес устанавливается в админке WordPress. Используется в механизме The Loop. Если Вам необходимо получить ссылку на сайт автора для дальнейшей обработки, то используйте функцию get_the_author_link();
Пример:

<p>Written by:
<?php the_author_link(); ?></p>

Наверх

get_the_author_link()
Данная функция возвращает ссылку на сайт автора для дальнейшего использования.

Наверх

the_author_meta()
Отображает мета данные автора. Принимает два параметра $field, $userID, где $field может принимать следующие значения:

• user_login
• user_pass
• user_nicename
• user_email
• user_url
• user_registered
• user_activation_key
• user_status
• display_name
• nickname
• first_name
• last_name
• description
• jabber
• aim
• yim
• user_level
• user_firstname
• user_lastname
• user_description
• rich_editing
• comment_shortcuts
• admin_color
• plugins_per_page
• plugins_last_view
• ID

и $userID — id пользователя. Если данная функция используется в механизме The Loop, то указывать $userID ненадо.
Пример:

<p>The email address for user id 25 is <?php the_author_meta('user_email',25); ?></p>

Выводит e-mail автора под id=25.

Наверх

the_author_posts()
Показывает общее количество сообщений, написанных данным автором. Используется внутри механизма The Loop.
Пример:

<p><?php the_author(); ?> has blogged <?php the_author_posts(); ?>
posts</p>

Наверх

the_author_posts_link()
Выводит ссылку на все сообщения автора. Должен использоваться в механизме The Loop.
Пример:

<p>Other posts by <?php the_author_posts_link(); ?></p>

Наверх

wp_dropdown_users()
Создает выпадающий список авторов данного ресурса. Принимает в качестве параметра массив $args, следующего вида:

<?php $args = array(
    'show_option_all'         => null, // string
    'show_option_none'        => null, // string
    'hide_if_only_one_author' => null, // string
    'orderby'                 => 'display_name',
    'order'                   => 'ASC',
    'include'                 => null, // string
    'exclude'                 => null, // string
    'multi'                   => false,
    'show'                    => 'display_name',
    'echo'                    => true,
    'selected'                => false,
    'include_selected'        => false,
    'name'                    => 'user', // string
    'id'                      => null, // integer
    'class'                   => null, // string
    'blog_id'                 => $GLOBALS['blog_id'],
    'who'                     => null // string
); ?>

где:

• show_option_all — вызывает html выпадающего списка для того, чтобы выбрать всех пользователей
• show_option_none — вызывает html выпадающего списка для того, чтобы не выбирать ни одного пользователя
• hide_if_only_one_author — скрывать, если только один пользователь

• orderby — сортировка по полю, принимает следующие значения: ID, user_nicename, display_name — по умолчанию

• order — порядок сортировки, может прнимать следующие значения: ‘ASC’ — по умолчанию, ‘DESC’

• include — перечисляются через запятую индентификаторы пользователей, которые будут включены в список. По умолчанию все включены.
• exclude — перечисляются через запятую индентификаторы пользователей, которы не будут включены в выпадающий список. По умолчанию исключенных нет.
• multi — пропускать атрибут ID  в выбранном элементе, по умолчанию: false.

• show — какое поле показывать в списке, принимает следующее значение: ‘ID’, ‘user_login’, ‘display_name’ — по умолчанию

• echo — показывать пользователей(true) или вернуть результат (false) для дальнейшей обработки.
• selected — id пользователя, который будет выбран. По умолчанию: пусто.
• include_selected — всегда включает выбранный индентификатор пользователя. По умолчанию: false.
• name — имя пользователя, которое будет выбрано в выпадающем списке. По умолчанию: user.
• id — атрибута выбранного элемента.
• class — class выбранного элемента.
• blog_id — id блога (только для мультисайта). По умолчанию: текущий.
• who — каких пользователей запрашивать, в настоящее время поддерживает только авторов.

Наверх

wp_list_authors()
Отображает список авторов сайта ввиде ссылки на посты. Опционально этот тег выводит сообщенея каждого автора и ссылку на RSS. В качестве параметра может принимать массив вида:

<?php $args = array(
    'orderby'       => 'name',
    'order'         => 'ASC',
    'number'        => null,
    'optioncount'   => false,
    'exclude_admin' => true,
    'show_fullname' => false,
    'hide_empty'    => true,
    'echo'          => true,
    'feed'          => [empty string],
    'feed_image'    => [empty string],
    'feed_type'     => [empty string],
    'style'         => list,
    'html'          => true ); ?>

где:

• orderby — поле, которое используется для сортировки результатов, может принимать следующие значения: name — по умолчанию, email, url, registered, id, user_login, post_count

• order — порядок сортировки, принимает следующие значения: ASC — по умолчанию, DESC

• number — максимальное количество отображаемых пользователей, по умолчанию: ограничений нет
• optioncount — отображать или нет количество опубликованных сообщений пользователя, принимает: 1(true) — по умолчанию или 0(false)
• exclude_admin — исключить администратора из списка, принимает 1(true) — по умолчанию или 0 (false)
• show_fullname — отображать полное имя автора (имя и фамилию), может принимать два значения 1(true) и 0(false) — по умолчанию
• hide_empty — отображать или не отображать список авторов, если он пуст. Принимает два значения 1(true) — по умолчанию и 0(false)
• echo — отобоажать или возвращать для дальнейшей обработки результат, может принимать два значения 1(true) — по умолчанию и 0(false)
• feed — текст ссылки на RSS поток для каждого автора
• feed_image — путь/файл картинки

• feed_type — тип потока. Может принимать следующие значения: — по умолчанию, rss2, atom, rss, rdf

• style — стиль в котором будет отображаться список авторов, может принимать следующие значения: list — по умолчанию, none

• html — как перечислять элементы как html или как список. Мржет принимать два значения 1(true) — по умолчанию,как html или 0(false) как текст

Пример:

<?php wp_list_authors('show_fullname=1&optioncount=1&orderby=post_count&order=DESC&number=3'); ?>

Наверх

get_author_posts_url()
Получает адрес автора по заданному ID автора. Может принимать два параметра $author_id и $author_nicename, где $author_id — ID автора, $author_nicename — ник пользователя.

Наверх

На этом рассмотрение тегов автора(авторов) постов для темы WordPress мы закончили. А в следующем материале мы рассмотрим теги закладки для шаблонов WordPress. Так, что не пропускайте выхода новых постов, подписавшись на RSS-рассылку данного блога.
А пока все. Всем удачной разработки.