Багато змінилося з часу безумства, яке було http://drupal.org/node/1092444 . На щастя, тематизація та налаштування форматів відображення для файлових об'єктів тепер набагато простіші та простіші.
Наступна документація стосується Media 2.x та Entity Entity , хоча значна частина роботи працює з Media 1.x з незначними змінами (наприклад, у Media 1.x, посилання на сторінку "Типи файлів" знаходиться в Конфігурації замість структури ).
Відображення медіа
Файл Entity і медіа модулі працюють разом , щоб забезпечити уніфікований спосіб для зберігання, управління і відображення медіа в Drupal. Вони дозволяють користувачеві створювати файлові поля, які можна налаштувати для зберігання та відображення багатьох різних типів носіїв інформації, включаючи зображення, відео та аудіо. серед інших. Для відображення цих різних типів носіїв потрібні формати файлів, які часто надаються модулем, що забезпечує тип медіа, і трохи додаткової конфігурації.
Визначення
Спочатку я поясню пару рухомих частин, а потім перейдіть до налаштування відображення файлів на сайті.
Типи файлів
Файли групуються у типи файлів . Кожен тип файлу визначається списком типів mime , універсальним способом визначення форматів файлів в Інтернеті. Типовими типами файлів є програми, звук, зображення, текст, відео та інше. В даний час немає можливості визначити нові типи файлів в інтерфейсі.
Перегляд режимів
Режими перегляду використовуються для того, щоб сказати Drupal 7 (а незабаром і 8), що фрагмент вмісту знаходиться у певному контексті. Потім вміст може бути змінено або відображено так, що найкраще відповідає цьому контексту. Два режими перегляду, які, мабуть, знайомі людям, - це тизер і повний режим за замовчуванням . Режими власного перегляду можна визначити за допомогою модулів, таких як режим перегляду сутності , екранного набору або у спеціальному модулі з hook_entity_info_alter().
The Good Stuff, або: Керування відображенням вашого файлового поля
Відображення поля файлу керується за типом файлу . Перейдіть до структури -> Типи файлів. Ви побачите список доступних типів файлів із посиланнями на "Керування полями", "Керування дисплеєм" та "Керування відображенням файлів" для кожного.
Управління полями
Модуль Entity File створює всі файли, що повністю заповнюються, такими ж, як вузли та умови таксономії. Як і в розділі "Типи вмісту", ви можете додавати спеціальні поля до кожного типу файлів.
Керування дисплеєм
Знову, як, наприклад, у "Типи вмісту", ви можете керувати відображенням спеціальних полів для кожного типу файлів. Цей розділ не контролює форматування самих файлів , лише відображення полів, приєднаних до файлової сутності.
У цьому розділі ви також побачите перемикач для "Спеціальні налаштування дисплея". При розширенні ви можете вмикати та вимикати режими перегляду, доступні для цієї сутності. Тут потрібно перевірити режим перегляду, щоб він був доступний у "Керування відображенням файлів". На даний момент рекомендується використовувати лише власні режими перегляду, визначені користувачем, і такі режими подання за замовчуванням; решта залишилася від інтеграції модулів стилів і згодом буде видалена :
- "Тизер" (На даний момент не включений за замовчуванням. Ви можете додати його з виправленням у випуску вище або визначити його як власний режим перегляду)
- "Повний"
- "Попередній перегляд" (використовується в контекстах адміністратора, наприклад, для заповнювачів у полях WYSIWYG, у браузері "Медіа" та у віджеті "Медіа-поле")
Управління відображенням файлів
У "Керуванні відображенням файлів" ви можете налаштувати формати форматів для типів файлів (так!). Багато модулів медіа-провайдера додають сюди власні формати; наприклад, Media: Youtube та Media: Vimeo забезпечують формат "попереднього перегляду" та "відео".
Форматори можна вмикати та налаштовувати для кожного режиму перегляду, включеного у розділі "Керування дисплеєм" типу файлу. Наприклад, користувач може захотіти відображати зображення Media: Vimeo для попереднього перегляду, коли вузол переглядається як тизер, відео Vimeo, коли переглядається повний вузол, і відео з різними налаштуваннями форматора ширини та висоти, коли вузол переглядається за допомогою нестандартний режим перегляду під назвою "відеогалерея". Багато форматорів (зокрема "Зображення") дозволяють користувачеві вибирати стилі зображень, визначені ними в Конфігурація -> Стилі зображення.
Оскільки кілька медіа-провайдерів можуть використовувати одне і те ж поле, формати форматів розташовуються в каскаді зверху вниз. Drupal використовуватиме перший форматер, який можна застосувати до виводу поля. Якщо у відеополі увімкнено формати "Медіа: Youtube Video", "Media: Vimeo Video" та "Значок великого файлу" в режимі перегляду "Повний", Drupal використовуватиме форматор Youtube, якщо тип mime файлу - video/youtubeVimeo форматер, якщо тип mime є video/vimeo, і повернутися до великої піктограми файлу, якщо тип mime є video/{anything else}.
Налаштування Файлового поля для відображення за допомогою параметрів "Керування відображенням файлів"
Для того, щоб поле файлу відображалося за допомогою форматів, визначених у "Керуванні відображенням файлів", воно повинно бути встановлено для відображення "наданого файлу". Перейдіть на сторінку "Керування дисплеєм" для типу вмісту, який містить ваше файлове поле. Виберіть "Відображений файл" як формат поля файлу для всіх режимів перегляду, в яких ви хочете використовувати формати, визначені в "Керування відображенням файлів".
Подальші теми
Ви можете створити власні функції тем і файли шаблонів для ще більшого контролю з перекриттями гачок теми . Тематичні пропозиції, надані модулем Entity File:
file__{file type}
file__{file type}__{view mode}
file__{mime type}
file__{mime type}__{view mode}
file__{file id}
file__{file id}__{view mode}
Замініть всі '/' та '__' у типах mime на '_' для тематичних функцій та '-' для файлів шаблонів.
Деякі модулі медіа-провайдера замінюють їх власними шаблонами та пропозиціями щодо гачок теми. Ви можете переглянути всі доступні пропозиції щодо гачок тематики за допомогою модуля розробника теми Devel , Помічник бідного матері The Mothership або, сподіваємось, отримати додаткову інформацію в документах постачальника.
Outro
Сподіваюсь, це допомагає. Я планую додати це до документації щодо засобів масової інформації, тому, якщо я щось пропустив, десь помиляюся, або в розділі потрібне уточнення, будь ласка, дайте мені знати.
І кілька коротких відповідей на конкретні питання ОП:
- Media 1.x vs 2.x: хоча 2.x нестабільний, він настільки ж надійний, як і багато стабільних модулів версій на Drupal.org. Я думаю, що варто використовувати для надзвичайно вдосконалених функцій, але оскільки робота над підтримкою в черзі випуску повільна, і як і в будь-якій гілці розробників, нові оновлення можуть порушити вашу реалізацію. Все-таки я використовую це на виробництві.
- ЗМІ знаходяться на стадії розробки. Деякі речі не працюють так, як ви сподівалися б (наприклад, інтеграція WYSIWYG без зображення). Але він все ще краще працює, ніж це робить комбінація модулів, які ви повинні встановити, щоб робити те, що без нього. І стає краще.