Изучаем теги шаблонов: часть шестая
Изучаем теги шаблонов: часть первая
Изучаем теги шаблонов: часть вторая
Изучаем теги шаблонов: часть третья
Изучаем теги шаблонов: часть четвертая
Изучаем теги шаблонов: часть пятая
Изучаем теги шаблонов: часть шестая
В шестой статье из нашей серии мы прошлись по пятой порции тегов шаблонов в WordPress. Вот такая вот путаница получилась! В сегодняшней, седьмой по счету статье из этой серии, мы рассмотрим теги, связанные с авторами и загруженными файлами.
Получаем URL архива записей автора: get_author_posts_url()
Тег возвращает URL на архив записей автора.
Параметры
Этот тег шаблона принимает два параметра:
- $author_ID (integer, обязательный): ID автора. По умолчанию: текущий автор;
- $author_nicename (string, необязательный): ник автора, который можно использовать в ссылках и т. д. По умолчанию: ».
Применение
<?php
// Получаем и выводим ссылку на архив записей автора.
echo '<a href="' . get_author_posts_url() . '">' . __( 'Архив автора', 'translation-domain' ) . '</a>';
?>
Выводим ссылку на архив записей автора: the_author_posts_link()
Тег выводит ссылку на архив автора.
Параметры
Этот тег шаблона не принимает параметров.
Применение
<?php
the_author_posts_link();
?>
Получаем и выводим ссылку на сайт автора: get_the_author_link() и the_author_link()
Теги возвращают и выводят ссылку на сайт автора.
Параметры
Эти теги шаблона не принимают параметров.
Применение
<?php
// Выводим ссылку на автора.
the_author_link();
// Получаем ссылку на автора.
$the_author_link = get_the_author_link();
?>
Получаем и выводим метаданные автора: get_the_author_meta() и the_author_meta()
Эти теги извлекают и выводят метаданные автора.
Параметры
Оба тега шаблонов принимают два параметра:
- $field (string, обязательный): Поле, из которого нужно получить данные (‘login‘, ‘nicename‘, ‘email‘, ‘url‘, ‘registered‘ или ‘status‘). По умолчанию: »;
- $user_ID (integer, необязательный): ID пользователя. По умолчанию: Global $authordata.
Применение
<?php
// Получаем данные о дате регистрации пользователя.
get_the_author_meta( 'registered' );
// Выводим адрес электронной почты конкретного автора.
the_author_meta( 'email', 9 );
?>
Получаем и выводим количество записей автора: get_the_author_posts() и the_author_posts()
Эти теги подсчитывают, сколько записей опубликовал автор, и возвращают или выводят результат на экран.
Параметры
Эти теги шаблонов не принимают параметров.
Применение
<?php
the_author_posts();
?>
Получаем и выводим список авторов: wp_list_authors()
Тег получает или выводит список авторов на сайте.
Параметры
Этот тег шаблона принимает лишь один параметр:
- $args (array, необязательный): Массив включает следующие аргументы:
— ‘orderby‘ (string): сортировка списка по ‘user_nicename‘, ‘user_email‘, ‘user_url‘, ‘user_registered‘, ‘name‘, ‘display_name‘, ‘post_count‘, ‘ID‘, ‘meta_value‘, и ‘user_login‘. По умолчанию: ‘name‘;
— ‘order‘ (string): Сортировать по возрастанию (‘ASC‘) или убыванию (‘DESC‘) порядке. По умолчанию: ‘ASC‘;
— ‘number‘ (integer): Количество авторов, которое будет выводиться. По умолчанию: NULL (неограниченно);
— ‘option_count‘ (bool): Показывать количество постов каждого автора. По умолчанию: FALSE;
— ‘exclude_admin‘ (bool): Исключить из списка администраторов (с учетной записью ‘admin‘). По умолчанию: TRUE;
— ‘show_fullname‘ (bool): Показывать имя и фамилию (TRUE) или только имя (FALSE). По умолчанию: FALSE;
— ‘hide_empty‘ (bool): Не показывать авторов, у которых нет ни одной записи. По умолчанию: TRUE;
— ‘echo‘ (bool): Вывести список авторов (TRUE) или вернуть (FALSE). По умолчанию: TRUE;
— ‘feed‘ (string): Если выставлено непустое значение, то ссылка на рассылку автора будет показана рядом с ником. Введенное значение будет использоваться в качестве текста ссылки. По умолчанию: »;
— ‘feed_type‘ (string): Тип рассылки (‘rss‘, ‘rss2‘, ‘atom‘ или ‘rdf‘). По умолчанию: »;
— ‘feed_image‘ (string): Путь до изображения, которое будет использоваться вместо текста ссылки. По умолчанию: »;
— ‘style‘ (string): Стиль отображения: ‘list’ –неупорядоченный список, ‘none’ – список ссылок, разделенных запятыми. По умолчанию: ‘list’;
— ‘html‘ (bool): Для отображения списка использовать HTML или обычный текст. По умолчанию: TRUE;
— ‘include‘ (string): Список ID через запятую, которые нужно включить в список. По умолчанию: »;
— ‘exclude‘ (string): Список ID через запятую, которые нужно исключить из списка. По умолчанию: ».
Применение
<?php
$args = array(
// Сортировка по дате регистрации.
'orderby' => 'user_registered',
// Выводим количество записей рядом с никами.
'option_count' => true,
// Показываем полное имя.
'show_fullname' => true,
// Показываем авторов, у которых нет записей.
'hide_empty' => false,
// Исключаем Майка.
'exclude' => 31
);
wp_list_authors( $args );
?>
Получаем и выводим выпадающий HTML-список пользователей: wp_dropdown_users()
Тег возвращает и выводит выпадающий список пользователей ().
Параметры
Этот тег шаблона принимает лишь один параметр:
- args (array, необязательный): Массив включает следующие аргументы:
— ‘show_option_all‘ (string): Текст, который отображается в поле выпадающего списка по умолчанию. По умолчанию: »;
— ‘show_option_none‘ (string): Текст, который отображается в поле выпадающего списка по умолчанию при отсутствии пользователей. По умолчанию: »;
— ‘option_none_value‘ (integer или string): значение, которое будет использоваться в ‘show_option_none‘ при отсутствии пользователей. По умолчанию: -1;
— ‘hide_if_only_one_author‘ (string): скрывать выпадающий список, если автор всего один. По умолчанию: »;
— ‘orderby‘ (string): какую колонку использовать для сортировки пользователей. По умолчанию: ‘display_name‘;
— ‘order‘ (string): В каком направлении сортировать пользователей. По умолчанию: ‘ASC‘;
— ‘include‘ (array или string): Массив или список пользователей через запятую, которые нужно отобразить. По умолчанию: »;
— ‘exclude‘ (array или string): Массив или список пользователей через запятую, которых надо исключить. По умолчанию: »;
— ‘multi‘ (bool или integer): Пропускать ли ID элемента SELECT. (это удобно, если вам нужно показать более одного пользователя в выпадающем списке). По умолчанию: 0;
— ‘show‘ (string): Что показывать в пунктах списка. По умолчанию: ‘display_name‘;
— ‘echo‘ (bool или integer): Получать или выводить контент. По умолчанию: 1;
— ‘selected‘ (integer): ID пользователя, выбранного по умолчанию. По умолчанию: 0;
— ‘include_selected‘ (bool): Всегда включать в список пользователей с ID, указанном в параметре selected. По умолчанию: FALSE;
— ‘name‘ (string): Значение атрибута NAME для элемента SELECT. По умолчанию: ‘user‘;
— ‘id‘ (string): ID элемента SELECT. По умолчанию: »;
— ‘class‘ (string): CSS-класс для элемента SELECT. По умолчанию: »;
— ‘blog_id‘ (integer): ID блога. По умолчанию: текущий блог;
— ‘who‘ (string): Каких пользователей выводить (принимаемые значения: ‘authors‘ или ‘‘). По умолчанию: ».
Применение
<?php
$args = array(
// Сортировка по дате регистрации.
'orderby' => 'user_registered',
// Исключаем админа.
'exclude' => 1,
// Мы хотим показать больше одного выпадающего списка пользователей, поэтому не ставьте сюда уникальные ID.
'multi' => 1,
// Не выводить, а просто получить результат.
'echo' => 0,
// Параметр NAME для элемента SELECT.
'name' => 'brands',
// Выводить только авторов.
'who' => 'authors'
);
$brands_dropdown = wp_categories_dropdown( $args );
?>
Получаем и выводим миниатюру изображения для записи: get_the_post_thumbnail() и the_post_thumbnail()
В принципе, заголовок уже обо всем рассказал.
Параметры
get_the_post_thumbnail() принимает три параметра:
- $post_ID (integer, необязательный): ID записи. По умолчанию: текущая запись;
- $size (string, необязательный): Размер изображения. По умолчанию: ‘post-thumbnail‘;
- $attr (string или array, необязательный): Массив включает в себя следующие аргументы:
— ‘src‘: источник изображения;
— ‘class‘: CSS-класс (или классы, разделенные пробелами);
— ‘alt‘: альтернативный текст.
the_post_thumbnail() принимает два параметра:
- $size (string, необязательный): Размер изображения. По умолчанию: ‘post-thumbnail‘;
- $attr (string или array, необязательный): Массив включает в себя следующие аргументы:
— ‘src‘: источник изображения;
— ‘class‘: CSS-класс (или классы, разделенные пробелами);
— ‘alt‘: альтернативный текст.
Применение
<?php
// Получаем миниатюру записи со стандартными настройками.
get_the_post_thumbnail();
// Выводим миниатюру записи с произвольными настройками.
$attr = array(
'class' => 'post-featured-image',
'alt' => __( 'Миниатюра ', 'translation-domain' )
);
the_post_thumbnail( 'medium', $attr );
?>
Получаем и выводим постоянную ссылку на страницу вложения: wp_get_attachment_link() и the_attachment_link()
Эти теги получают и выводят постоянную ссылку на вложения.
Параметры
wp_get_attachment_link() принимает пять параметров:
- $post_ID (integer или Object, необязательный): ID записи. По умолчанию: текущая запись;
- $size (string, необязательный): Размер изображения. По умолчанию: ‘thumbnail‘;
- $permalink (bool, необязательный): Показывать постоянную ссылку на вложение или нет. По умолчанию: FALSE;
- $icon (bool, необязательный): Использовать иконку. По умолчанию: FALSE;
- $text (string или bool, необязательный): Текст ссылки. По умолчанию: FALSE.
the_attachment_link() принимает четыре параметра:
- $post_ID (integer или Object, необязательный): ID записи. По умолчанию: текущая запись;
- $fullsize (bool, необязательный): Использовать полную версию изображения. По умолчанию: FALSE;
- $deprecated (bool, устаревший): Этот параметр устарел, поэтому просто введите TRUE или FALSE;
- $permalink (bool, необязательный): Показывать постоянную ссылку на вложение или нет. По умолчанию: FALSE.
Применение
<?php
// Получаем ссылку на текущее вложение с изображением в полном размере.
wp_get_attachment_link( $post->ID, 'large' );
// Выводим ссылку на текущее вложение.
the_attachment_link();
?>
Получаем ID миниатюры записи: get_post_thumbnail_id()
Этот тег получает ID миниатюры поста.
Параметры
Тег принимает лишь один параметр:
- $post_ID (integer, необязательный): ID записи. По умолчанию: текущая запись.
Применение
<?php
// Получаем ID миниатюры для текущей записи.
$featured_image_ID = get_post_thumbnail_id();
// Выводим ID миниатюры для определенной записи.
echo get_post_thumbnail_id( 39 );
?>
Получаем изображение из вложения: wp_get_attachment_image()
Этот тег получает HTML-код изображения из определенного вложения (<img />).
Параметры
Этот тег шаблона принимает четыре параметра:
- $ attachment_ID (integer, необязательный): ID вложения. По умолчанию: текущее вложение;
- $size (string, необязательный): Размер изображения. По умолчанию: ‘thumbnail‘;
- $icon (bool, необязательный): Использовать иконку. По умолчанию: FALSE;
- $attr (string или array, необязательный): Массив включает в себя следующие аргументы:
— ‘src‘: источник изображения;
— ‘class‘: CSS-класс (или классы, разделенные пробелами);
— ‘alt‘: альтернативный текст.
Применение
<?php
$attr = array(
'class' => 'mytheme-attachment',
);
echo wp_get_attachment_image( $post->ID, 'thumbnail', false, $attr );
?>
Получаем URL изображения во вложении: wp_get_attachment_image_src()
Этот тег возвращает URL изображения, прикрепленного к посту (во вложении).
Параметры
Этот тег шаблона принимает три параметра:
- $ attachment_ID (integer, необязательный): ID вложения. По умолчанию: текущее вложение;
- $size (string, необязательный): Размер изображения. По умолчанию: ‘thumbnail‘;
- $icon (bool, необязательный): Использовать иконку. По умолчанию: FALSE.
Применение
<?php
// Получаем URL определенного вложения.
$special_attachment_url = wp_get_attachment_image_src( 199 );
?>
Получаем метаданные изображения во вложении: wp_get_attachment_metadata()
Получает метаданные прикрепленного файла.
Параметры
Этот тег шаблона принимает два параметра:
- $ attachment_ID (integer, необязательный): ID вложения. По умолчанию: 0;
- $unfiltered (bool, необязательный): Если TRUE, то будет применен фильтр wp_get_attachment_metadata. По умолчанию: FALSE.
Применение
<?php
print_r( wp_get_attachment_metadata( $post->ID ) );
?>
Получаем следующее изображение из той же записи: next_image_link()
Тег создает ссылку на следующую картинку, прикрепленную к записи.
Параметры
Этот тег шаблона принимает два параметра:
- $size (string, необязательный): Размер изображения. По умолчанию: ‘thumbnail‘;
- $text (string или bool, необязательный): Текст ссылки. По умолчанию: FALSE.
Применение
<?php
echo next_image_link( 'medium', __( 'Следующее изображение', 'translation-domain' ) );
?>
Получаем предыдущее изображение из той же записи: previous_image_link()
Тег выводит ссылку на предыдущую картинку, прикрепленную к записи.
Параметры
Этот тег шаблона принимает два параметра:
- $size (string, необязательный): Размер изображения. По умолчанию: ‘thumbnail‘;
- $text (string или bool, необязательный): Текст ссылки. По умолчанию: FALSE.
Применение
<?php
echo previous_image_link( 'medium', __( 'Предыдущее изображение', 'translation-domain' ) );
?>
В завершение
Надеемся, вам понравилась шестая «порция» тегов шаблонов. В ближайшее время мы опубликуем еще несколько статей из этой серии.
Если у вас возникли какие-либо вопросы или замечания, обязательно напишите об этом в комментариях. И если вам понравилась наша статья, то не забудьте поделиться ей с друзьями!
Перевод статьи “The Tuts+ Guide to Template Tags: Sixth Batch” был подготовлен дружной командой проекта Сайтостроение от А до Я.