Вивчаємо теги шаблонів: частина шоста

Вивчаємо теги шаблонів: частина перша
Вивчаємо теги шаблонів: частина друга
Вивчаємо теги шаблонів: частина третя
Вивчаємо теги шаблонів: частина четверта
Вивчаємо теги шаблонів: частина п’ята
Вивчаємо теги шаблонів: частина шоста

У шостий статті з нашої серії ми пройшлися по п’ятій порції тегів шаблонів WordPress. Ось така плутанина вийшла! У сьогоднішній, сьомої статті з цієї серії, ми розглянемо теги, пов’язані з авторами і завантаженими файлами.

Отримуємо URL архіву записів автора: get_author_posts_url()

Тег повертає URL на архів записів автора.

Параметри

Цей тег шаблону приймає два параметри:

• $author_ID (integer, обов’язковий): ID автора. За замовчуванням: поточний автор;
• $author_nicename (string, необов’язковий): нік автора, який можна використовувати в посиланнях і т. д. За замовчуванням: ».

Застосування

Виводимо посилання на архів записів автора: the_author_posts_link()

Тег виводить посилання на архів автора.

Параметри

Цей тег шаблону не приймає параметрів.

Застосування

Отримуємо і виводимо посилання на сайт автора: get_the_author_link() і the_author_link()

Теги повертають і виводять посилання на сайт автора.

Параметри

Ці теги шаблону не приймають параметрів.

Застосування

Отримуємо і виводимо метадані автора: get_the_author_meta() і the_author_meta()

Ці теги витягують і виводять метадані автора.

Параметри

Обидва тега шаблонів приймають два значення:

• $field (string, обов’язковий): Поле, з якого потрібно отримати дані (‘login‘, ‘nicename‘, ‘email‘, ‘url‘, ‘registered‘ або ‘status‘). За замовчуванням: »;
• $user_ID (integer, необов’язковий): ID користувача. За замовчуванням: Global $authordata.

Застосування

Отримуємо і виводимо кількість записів автора: get_the_author_posts() і 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 через кому, які потрібно виключити з списку. За замовчуванням: ».

Застосування

‘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‘ або «). За замовчуванням: ».

Застосування

‘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‘: альтернативний текст.

Застосування

‘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.

Застосування

ID ‘large’ );
// Виводимо посилання на поточне вкладення.
the_attachment_link();
?>

Отримуємо ID мініатюри запису: get_post_thumbnail_id()

Цей тег отримує ID мініатюри посту.

Параметри

Тег приймає лише один параметр:

• $post_ID (integer, необов’язковий): ID запису. За замовчуванням: поточний запис.

Застосування

Отримуємо зображення з вкладення: wp_get_attachment_image()

Цей тег отримує HTML-код зображення з певного вкладення ().

Параметри

Цей тег шаблону приймає чотири параметри:

• $ attachment_ID (integer, необов’язковий): ID вкладення. За замовчуванням: поточне вкладення;
• $size (string, необов’язковий): Розмір зображення. За замовчуванням: ‘thumbnail‘;
• $icon (bool, необов’язковий): Використовувати іконку. За замовчуванням: FALSE;
• $attr (string або array, необов’язковий): Масив включає в себе наступні аргументи:

— ‘src‘: джерело зображення;
— ‘class‘: CSS-клас (або класи, розділені пробілами);
— ‘alt‘: альтернативний текст.

Застосування

‘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.

Застосування

Отримуємо метадані зображення у вкладенні: wp_get_attachment_metadata()

Отримує метадані прикріпленого файлу.

Параметри

Цей тег шаблону приймає два параметри:

• $ attachment_ID (integer, необов’язковий): ID вкладення. За замовчуванням: 0;
• $unfiltered (bool, необов’язковий): Якщо TRUE, то буде застосовано фільтр wp_get_attachment_metadata. За замовчуванням: FALSE.

Застосування

ID ) );
?>

Отримуємо наступне зображення з тієї ж записи: next_image_link()

Тег створює посилання на наступну картинку, прикріплену до запису.

Параметри

Цей тег шаблону приймає два параметри:

• $size (string, необов’язковий): Розмір зображення. За замовчуванням: ‘thumbnail‘;
• $text (string або bool, необов’язковий): Текст посилання. За замовчуванням: FALSE.

Застосування

Отримуємо попереднє зображення з тієї ж записи: previous_image_link()

Тег виводить посилання на попередню картинку, прикріплену до запису.

Параметри

Цей тег шаблону приймає два параметри:

• $size (string, необов’язковий): Розмір зображення. За замовчуванням: ‘thumbnail‘;
• $text (string або bool, необов’язковий): Текст посилання. За замовчуванням: FALSE.

Застосування

На завершення

Сподіваємося, вам сподобалася шоста «порція» тегів шаблонів. Найближчим часом ми опублікуємо ще кілька статей з цієї серії.

Якщо у вас виникли питання або зауваження, обов’язково напишіть про це в коментарях. І якщо вам сподобалася ця стаття, то не забудьте поділитися нею з друзями!

Переклад статті «The Tuts+ Guide to Template Tags: Sixth Batch» був підготовлений дружною командою проекту Сайтостроение від А до Я.