Изучаем теги шаблонов: часть шестая

Изучаем теги шаблонов: часть первая
Изучаем теги шаблонов: часть вторая
Изучаем теги шаблонов: часть третья
Изучаем теги шаблонов: часть четвертая
Изучаем теги шаблонов: часть пятая
Изучаем теги шаблонов: часть шестая

В шестой статье из нашей серии мы прошлись по пятой порции тегов шаблонов в 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” был подготовлен дружной командой проекта Сайтостроение от А до Я.