Теги для работы с автором (авторами) постов WordPress
Доброго времени суток. Мы с Вами продолжаем изучать теги для шаблонов 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-рассылку данного блога.
А пока все. Всем удачной разработки.
[…] теги для шаблонов WordPress. Так в прошлой статье Теги для работы с автором (авторами) постов WordPress мы с Вами рассмотрели теги для работы с автором […]
Спасибо за информацию! Все получилось! Скажите, а как можно исключить администратора из отображаемых авторов, после поста. Т.е. если написал админ, то информация о нем не отображается, а если другой пользователь, то показывается.
Мы знаем, что администратор имеет логин Admin, тогда просто if the_author_meta(‘user_login’) != ‘Admin’:
Спасибо за полезную информацию. Скажите, возможно ли каким то образом добавить к php the_author_link атрибуты «rel» и «target»?
@Андрей
Использовать get_the_author_link(), которая вернет ссылку, а возвращенный результат уже отредактировать как надо.