ЗАВАНТАЖИТИ ВИХІДНІ ФАЙЛИ

Ця стаття є другою з серії про роботу із зображеннями у вкладеннях WordPress.

У цій серії статей я розповідаю:

  • Про призначення вкладень категорій і класифікацій;
  • Запити медіафайлів за категоріями / таксономиям, щоб ви могли вивести їх в користувальницькому циклі;
  • Про використання запитів таксономій / категорій для зображень, щоб виводити їх на сторінках архівів;
  • Про додавання зображень для термінів категорій або класифікацій в якості «спеціального зображення» категорії або терміна.

У першій частині я показала, як створюються нові таксономії для вкладень. У другій і третій частинах я покажу вам, як створити власний цикл для виведення вкладень через шаблон. У цій статті я створю файл шаблону для документів і цикл, який виводить посилання на мультимедійні файли для кожного документа.

Примітка: Якщо ви хочете застосовувати існуючі категорії та теги до медіафайлів, прочитайте статтю про те, як призначати категорії і теги для вкладень.

Що вам знадобиться

  • Встановлена система WordPress;
  • Доступ по FTP (або встановлений локальний сервер);
  • Редактор коду.

У першій частині я створила плагін, щоб зареєструвати таксономії, а в цій статті я створю власну тему (дочірню від теми twentyfourteen) з новим файлом шаблону, стилями і файлом функцій.

Якщо ви створюєте власну тему, використовуючи кроки, які я описую, то ви повинні активувати плагін, створений нами у першій частині — новий файл шаблону без нього працювати не буде.

Ви можете просто скопіювати код з плагіна в файл функцій вашої теми. Але краще, щоб користувальницькі типи записів додавалися через плагіни, так як в цьому випадку вони не залежать від теми. Код, розглянутий у цій статті, включає в себе плагін та нову дочірню тему, яка буде працювати тільки якщо у вас встановлена тема twentyfourteen.

1. Створення дочірньої теми

Створіть нову папку в директорії з темами, назвіть її відповідно і додайте в папку новий файл style.css.

Примітка: Якщо ви додаєте шаблон в існуючу тему, ви можете пропустити цей крок.

У таблицю стилів додайте наступний код:

/*
Theme Name: WPTutsPlus Advanced Use of Attachments — Part 2
Theme URI: http://rachelmccollin.co.uk/wptutsplus-advanced-use-of-attachments-in-wordpress/
Description: Theme to accompany Part 2 in tutorial series on advanced use of attachments
Author: Rachel McCollin
Author URI: http://rachelmccollin.co.uk
Template: twentyfourteen
Версія: 1.0.0
Tags: light, medium, two-columns, right-sidebar, responsive-layout, accessibility-ready
Text Domain: twenty-fourteen-child
*/
@import url(«../twentyfourteen/style.css»);

Ми створили нову дочірню тему twentyfourteen. Більше ніяких стилів додавати не потрібно.

2. Створення файлу шаблону

Для відображення вкладень в таксономії document-категорія, яку ми створили у першій частині цієї серії, потрібно створити файл шаблону таксономії.

У папці нової дочірньої теми додайте файл taxonomy-document-category.php.

Після цього потрібно додати розмітку, в яку «обертається» власний цикл. Її код можна скопіювати з файлу батьківського теми, або взяти з наведеного нижче прикладу.

Примітка: Якщо ви використовуєте власну тему, скопіюйте код одного з файлів шаблонів вашої теми, але без вмісту циклу:

Document Category — ‘ . $queried_object->name . ‘

‘; ?>

Зверніть увагу, що для виведення заголовка сторінки всередині елемента h1 я використовувала get_queried_object.

3. Додавання вкладення в основний запит з допомогою parse_query

За замовчуванням основної WordPress запит не включає в себе вкладення. Один із способів обійти це — додати новий запит в файл шаблону, використовуючи WP_Query, але я рекомендую використовувати основний запит, так як WordPress все одно буде виконувати його. Для цього можна використовувати фільтр parse_query.

Створіть у папці теми файл functions.php, і додайте в нього наступний код:

query_vars[‘post_type’] = array( ‘attachment’ );
$wp_query->query_vars[‘post_status’] = array( null );
return $wp_query;
}
}
add_action(‘parse_query’, ‘wptutsplus_add_attachments_to_tax_query’);

У цьому коді використаний фільтр parse_query для додавання вкладень в основний запит WordPress, коли на екрані відображається архів однієї з двох класифікацій, що застосовуються до вкладень.

4. Створення користувальницького циклу

Файл шаблона, створеного в кроці 2, після закриття тега додайте наступний код:

Тут я використала функцію wp_get_attachment_url(), яка виводить посилання безпосередньо на вкладення. Якщо хочете, щоб замість цього виводилися посилання на сторінки вкладень, то потрібно використовувати get_attachment_link().

Збережіть код і зайдіть в розділ панелі адміністрування «Бібліотека медіафайлів». На своєму сайті я додала кілька документів, які скачала з Вікіпедії:

На наведеному нижче скріншоті показано моя сторінка архіву терміна ‘Open Source’ таксономії document-category. Якщо я кликну по будь-якому з цих посилань, то відкриється сам документ:

Розширене використання вкладень WordPress: Створення запитів для вкладень

Висновок

З цієї статті ви дізналися, як використовувати застосовувані до вкладень таксономії, щоб створювати користувальницькі шаблони і виводити список посилань на завантажені документи.

У наступній статті я покажу, як створити власний шаблон для виведення зображень з даним терміном таксономії gallery-category.

Переклад статті «Advanced Use of Attachments in WordPress: Creating Custom Queries for Attachments» був підготовлений дружною командою проекту Сайтостроение від А до Я.