Статьи

Путеводитель по шаблонам: шестая партия

Февраль 3, 2019

В шестой части серии мы рассмотрели пятую серию тегов шаблонов WordPress. В этой седьмой части мы рассмотрим шестую партию из почти 200 шаблонных тегов. На протяжении всего урока мы будем видеть теги шаблонов об авторах и вложениях.

Получение URL-адреса почтового архива get_author_posts_url() : get_author_posts_url()

Этот шаблонный тег возвращает ссылку на архив сообщений автора.

параметры

Этот тег шаблона принимает два параметра:

  • $author_ID (обязательно — целое число) :
    Идентификатор автора.
    (По умолчанию: текущий автор)
  • $author_nicename (необязательно — строка) :
    «Хорошее имя» автора. («Хорошее имя» — это очищенная версия «имени пользователя», которую можно использовать в URL-адресах и т. Д.)
    (По умолчанию: пусто)

использование

1
2
3
4
5
6
<?php
 
// Getting and displaying current author’s archives link.
echo ‘<a href=»‘ . get_author_posts_url() . ‘»>’ .
 
?>

Отображение ссылки на почтовые архивы the_author_posts_link() : the_author_posts_link()

Этот шаблонный тег выводит ссылку на авторские архивы сообщений.

параметры

Этот шаблон тега не принимает никаких параметров.

использование

1
2
3
4
5
<?php
 
the_author_posts_link();
 
?>

Получение и отображение ссылки на сайт автора: get_the_author_link() & the_author_link()

Эти теги шаблона возвращают или отображают ссылку на сайт автора.

параметры

Эти теги шаблона не принимают никаких параметров.

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Echoes the author link.
the_author_link();
 
// Returns the author link.
$the_author_link = get_the_author_link();
 
?>

Получение и отображение метаданных автора: get_the_author_meta() & the_author_meta()

Эти теги шаблонов извлекают и отображают метаданные автора.

параметры

Оба тега шаблона принимают два параметра:

  • $field (обязательно для заполнения) :
    Поле для извлечения («логин», «ник», «электронная почта», «URL», «зарегистрирован» или «статус»).
    (По умолчанию: пусто)
  • $user_ID (необязательно — целое число) :
    Идентификатор пользователя.
    По умолчанию: Global $authordata

использование

01
02
03
04
05
06
07
08
09
10
<?php
 
// Get current author’s registration date.
get_the_author_meta( ‘registered’ );
 
// Display a specific author’s email address.
the_author_meta( ’email’, 9 );
 
 
?>

Получение и отображение количества сообщений автора: get_the_author_posts() & the_author_posts()

Эти теги шаблонов подсчитывают, сколько сообщений написал автор, и возвращают или отображают результат.

параметры

Эти теги шаблона не принимают никаких параметров.

использование

1
2
3
4
5
<?php
 
the_author_posts();
 
?>

Получение и отображение списка авторов: wp_list_authors()

Этот тег шаблона возвращает или отображает список авторов, пишущих на вашем сайте.

параметры

Этот шаблонный тег принимает только один параметр:

  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'orderby' (строка): как заказать ссылки. Принимает «user_nicename», «user_email», «user_url», «user_registered», «name», «display_name», «post_count», «ID», «meta_value» и «user_login».
      (По умолчанию: «имя»)
    • 'order' (строка): заказывать элементы в порядке возрастания (ASC) или убывания (DESC).
      По умолчанию: «ASC»
    • 'number' (целое число): количество авторов для извлечения.
      (По умолчанию: NULL что означает отсутствие ограничений)
    • 'option_count' (логическое значение): отображать количество сообщений рядом с именами авторов или нет.
      По умолчанию: FALSE
    • 'exclude_admin' (логическое значение): следует ли исключить из списка «admin» (не всех администраторов, а только одного с именем пользователя «admin»).
      (По умолчанию: TRUE )
    • 'show_fullname' (логическое): показывать ли имена и фамилии ( TRUE ) или «отображаемые имена» ( FALSE ).
      По умолчанию: FALSE
    • 'hide_empty' (логическое значение): скрывать авторов без сообщений или без них.
      (По умолчанию: TRUE )
    • 'echo' (логическое): выводить ли вывод ( TRUE ) или возвращать ( FALSE ).
      (По умолчанию: TRUE )
    • 'feed' (строка): если задано непустое значение, ссылки на каналы авторов будут отображаться рядом с ссылками на авторов. Значение будет якорным текстом ссылок.
      (По умолчанию: пусто)
    • 'feed_type' (строка): тип фида (‘rss’, ‘rss2’, ‘atom’ или ‘rdf’).
      (По умолчанию: пусто)
    • 'feed_image' (строка): путь к изображению, чтобы переопределить якорный текст и показать вместо него изображение.
      (По умолчанию: пусто)
    • 'style' (string): Стиль для отображения авторов — ‘list’ для создания неупорядоченного списка или ‘none’ для создания списка ссылок, разделенных запятыми.
      (По умолчанию: «список»)
    • 'html' (логическое): генерировать ли HTML или простой текст.
      (По умолчанию: TRUE )
    • 'include' (строка): список идентификаторов для включения в запятую.
      (По умолчанию: пусто)
    • 'exclude' (строка): разделенный запятыми список идентификаторов для исключения.
      (По умолчанию: пусто)

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<?php
 
$args = array(
 
    // Order by registration date.
    ‘orderby’ => ‘user_registered’,
     
    // Display post counts next to the names.
    ‘option_count’ => true,
     
    // Show full names.
    ‘show_fullname’ => true,
     
    // Show authors who doesn’t have any posts.
    ‘hide_empty’ => false,
     
    // Exclude Mike, he has betrayed us!
    ‘exclude’ => 31
     
);
 
wp_list_authors( $args );
 
?>

Получение и отображение wp_dropdown_users() пользователей HTML: wp_dropdown_users()

Этот тег шаблона возвращает или отображает раскрывающееся меню ( <select> ) пользователей.

параметры

Этот шаблонный тег принимает только один параметр:

  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'show_option_all' (строка): текст для отображения в качестве раскрывающегося списка по умолчанию.
      (По умолчанию: пусто)
    • 'show_option_none' (строка): текст для отображения в качестве раскрывающегося списка по умолчанию, когда не было найдено ни одного пользователя.
      (По умолчанию: пусто)
    • 'option_none_value' (целое или строковое): значение, используемое для ‘show_option_none’, когда пользователей не найдено.
      (По умолчанию: -1)
    • 'hide_if_only_one_author' (строка): скрыть ли раскрывающийся список, если есть только один автор.
      (По умолчанию: пусто)
    • 'orderby' (строка): какой столбец использовать для упорядочения пользователей.
      По умолчанию: «display_name»
    • 'order' (строка): в каком направлении заказывать пользователей.
      По умолчанию: «ASC»
    • 'include' (массив или строка): массив или разделенный запятыми список идентификаторов пользователей, которые нужно показать (и исключить остальные).
      (По умолчанию: пусто)
    • 'exclude' (массив или строка): массив или разделенный запятыми список идентификаторов пользователей, которые нужно исключить из списка.
      (По умолчанию: пусто)
    • 'multi' (логическое или целое): пропускать ли идентификатор элемента SELECT . (Полезно, если вы собираетесь отображать более одного выпадающего списка пользователей.)
      (По умолчанию: 0)
    • 'show' (строка): что отображать в качестве имен элементов списка.
      По умолчанию: «display_name»
    • 'echo' (логическое или целое): отображать или получать содержимое.
      (По умолчанию: 1)
    • 'selected' (целое число): идентификатор пользователя, который будет выбран по умолчанию.
      (По умолчанию: 0)
    • 'include_selected' (логическое значение): всегда ли включать выбранный идентификатор пользователя в раскрывающийся список.
      По умолчанию: FALSE
    • 'name' (строка): значение атрибута NAME для элемента SELECT .
      По умолчанию: «пользователь»
    • 'id' (строка): идентификатор элемента SELECT .
      (По умолчанию: пусто)
    • 'class' (string): CSS-класс для элемента SELECT .
      (По умолчанию: пусто)
    • 'blog_id' (необязательно; целое число): идентификатор блога для извлечения пользователей.
      (По умолчанию: текущий блог)
    • 'who' (строка): какой тип пользователей запрашивать (принимает «авторов» или пустую строку).
      По умолчанию: Emtpy

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<?php
 
$args = array(
     
    // Order by registration date.
    ‘orderby’ => ‘user_registered’,
     
    // Exclude admin.
    ‘exclude’ => 1,
     
    // I’m going to use more than one users dropdown, so don’t put a unique id.
    ‘multi’ => 1,
     
    // Don’t echo, just return the output.
    ‘echo’ => 0,
     
    // NAME parameter of the SELECT tag.
    ‘name’ => ‘brands’,
     
    // Get only authors.
    ‘who’ => ‘authors’
     
);
 
$brands_dropdown = wp_categories_dropdown( $args );
 
?>

Получение и отображение get_the_post_thumbnail() изображения сообщения: get_the_post_thumbnail() & the_post_thumbnail()

Ну, название объясняет все это.

параметры

get_the_post_thumbnail() принимает три параметра:

  • $post_ID (необязательно — целое число) :
    Идентификатор поста.
    (По умолчанию: текущий пост)
  • $size (необязательно — строка) :
    Размер изображения.
    По умолчанию: «post-thumbnail»
  • $attr (необязательно — строка или массив) :
    Массив следующих атрибутов:
    • ‘src’: источник изображения
    • ‘класс’: класс CSS (или классы, разделенные пробелами)
    • ‘alt’: альтернативный текст

И the_post_thumbnail() принимает два параметра:

  • $size (необязательно — строка) :
    Размер изображения.
    По умолчанию: «post-thumbnail»
  • $attr (необязательно — строка или массив) :
    Массив следующих атрибутов:
    • ‘src’: источник изображения
    • ‘класс’: класс CSS (или классы, разделенные пробелами)
    • ‘alt’: альтернативный текст

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
<?php
 
// Get the post’s featured image with default options.
get_the_post_thumbnail();
 
// Display the post’s featured image with custom options.
$attr = array(
    ‘class’ => ‘post-featured-image’,
    ‘alt’ => __( ‘Featured Image’, ‘translation-domain’ )
);
 
the_post_thumbnail( ‘medium’, $attr );
 
?>

Получение и отображение постоянной ссылки на страницу вложения: wp_get_attachment_link() & the_attachment_link()

Эти теги шаблона возвращают или отображают постоянную ссылку вложения, поэтому его можно открыть на другой странице.

параметры

wp_get_attachment_link() принимает пять параметров:

  • $post_ID (необязательно — целое число или объект) :
    Идентификатор поста.
    (По умолчанию: текущий пост)
  • $size (необязательно — строка) :
    Размер изображения.
    (По умолчанию: «эскиз»)
  • $permalink (необязательно — логическое) :
    Независимо от того, чтобы включить постоянную ссылку или нет.
    По умолчанию: FALSE
  • $icon (необязательно — логическое) :
    Независимо от того, чтобы включить значок.
    По умолчанию: FALSE
  • $text (необязательно — строка или логическое значение) :
    Текст для отображения по ссылке.
    По умолчанию: FALSE

И the_attachment_link() принимает четыре параметра:

  • $post_ID (необязательно — целое число или объект) :
    Идентификатор поста.
    (По умолчанию: текущий пост)
  • $fullsize (необязательно — логическое) :
    Использовать ли полноразмерное изображение или нет.
    По умолчанию: FALSE
  • $deprecated (устарело — логическое) :
    Этот параметр устарел, и вы должны просто передать его как TRUE или FALSE (неважно, какой).
  • $permalink (необязательно — логическое) :
    Независимо от того, чтобы включить постоянную ссылку или нет.
    По умолчанию: FALSE

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Get current attachment’s link with a large image.
wp_get_attachment_link( $post->ID, ‘large’ );
 
// Display current attachment’s link.
the_attachment_link();
 
?>

Получение идентификатора get_post_thumbnail_id() изображения сообщения: get_post_thumbnail_id()

Этот тег шаблона получает идентификатор избранного изображения поста.

параметры

Этот шаблонный тег принимает только один параметр:

  • $post_ID (необязательно — целое число) :
    Идентификатор сообщения, из которого можно получить идентификатор миниатюры.
    (По умолчанию: текущий пост)

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Get current post’s featured image’s id.
$featured_image_ID = get_post_thumbnail_id();
 
// Rcho a specific post’s featured image’s id.
echo get_post_thumbnail_id( 39 );
 
?>

Получение изображения вложения: wp_get_attachment_image()

Этот тег шаблона возвращает HTML-код данного изображения вложения ( <img /> ).

параметры

Этот шаблон тега принимает четыре параметра:

  • $attachment_ID (необязательно — целое число) :
    Идентификатор вложения.
    (По умолчанию: текущее вложение)
  • $size (необязательно — строка) :
    Размер изображения.
    (По умолчанию: «эскиз»)
  • $icon (необязательно — логическое) :
    Независимо от того, чтобы включить значок или нет.
    По умолчанию: FALSE
  • $attr (необязательно — строка или массив) :
    Массив следующих атрибутов:
    • ‘src’: источник изображения
    • ‘класс’: класс CSS (или классы, разделенные пробелами)
    • ‘alt’: альтернативный текст

использование

1
2
3
4
5
6
7
8
9
<?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 (необязательно — целое число) :
    Идентификатор вложения.
    (По умолчанию: текущее вложение)
  • $size (необязательно — строка) :
    Размер изображения.
    (По умолчанию: «эскиз»)
  • $icon (необязательно — логическое) :
    Независимо от того, чтобы включить значок или нет.
    По умолчанию: FALSE

использование

1
2
3
4
5
6
<?php
 
// Get a specific attachment’s url.
$special_attachment_url = wp_get_attachment_image_src( 199 );
 
?>

Получение метаданных изображения вложения: wp_get_attachment_metadata()

Этот тег шаблона возвращает метаданные данного вложения.

параметры

Этот тег шаблона принимает два параметра:

  • $attachment_ID (необязательно — целое число) :
    Идентификатор вложения.
    (По умолчанию: 0)
  • $unfiltered (необязательно — логический) :
    Если для этого параметра установлено значение TRUE , фильтр wp_get_attachment_metadata не будет запущен.
    По умолчанию: FALSE

использование

1
2
3
4
5
<?php
 
print_r( wp_get_attachment_metadata( $post->ID ) );
 
?>

Получение следующего изображения того же поста: next_image_link()

Этот тег шаблона возвращает ссылку «следующее изображение» для страниц с вложениями изображений.

параметры

Этот тег шаблона принимает два параметра:

  • $size (необязательно — строка) :
    Размер изображения.
    (По умолчанию: «эскиз»)
  • $text (необязательно — строка или логическое значение) :
    Текст для отображения по ссылке.
    По умолчанию: FALSE

использование

1
2
3
4
5
<?php
 
echo next_image_link( ‘medium’, __( ‘Next Image’, ‘translation-domain’ ) );
 
?>

Получение предыдущего изображения того же поста: previous_image_link()

Этот тег шаблона возвращает ссылку «предыдущее изображение» для страниц с вложениями изображений.

параметры

Этот тег шаблона принимает два параметра:

  • $size (необязательно — строка) :
    Размер изображения.
    (По умолчанию: «эскиз»)
  • $text (необязательно — строка или логическое значение) :
    Текст для отображения по ссылке.
    По умолчанию: FALSE

использование

1
2
3
4
5
<?php
 
echo previous_image_link( ‘medium’, __( ‘Previous Image’, ‘translation-domain’ ) );
 
?>

Вывод

Надеюсь, вам понравилась эта шестая партия шаблонов тегов. Осталось еще две партии, так что следите за обновлениями для новых тегов шаблонов!

Если у вас есть какие-либо вопросы, комментарии или исправления, вы можете поделиться с нами своими мыслями в разделе «Комментарии». И если вам понравилась статья, не забудьте поделиться ею с друзьями!

30
Share: