Многое изменилось с тех пор, как было безумие http://drupal.org/node/1092444 . К счастью, создание тем и настройка форматов отображения для файловых объектов теперь стало намного проще и проще.
Следующая документация относится к Media 2.x и File Entity , хотя большая часть из них работает с Media 1.x с небольшими изменениями (например, в Media 1.x ссылка на страницу «Типы файлов» находится в разделе «Конфигурация», а не «Структура»). ).
Отображение медиа
Файл Entity и медиа модули работают вместе , чтобы обеспечить унифицированный способ для хранения, управления и отображения медиа в Drupal. Они позволяют пользователю создавать файловые поля, которые можно настроить для хранения и отображения множества различных типов мультимедиа, включая изображения, видео и аудио. среди других. Для отображения этих различных типов мультимедиа в полях файлов требуются средства форматирования, часто предоставляемые модулем, предоставляющим тип мультимедиа, и немного дополнительная настройка.
Определения
Сначала я объясню пару движущихся частей, а затем приступлю к настройке отображения файлов на сайте.
Типы файлов
Файлы сгруппированы в типы файлов . Каждый тип файла определяется списком типов пантомимы , универсальный способ определения форматов файлов в Интернете. Типы файлов по умолчанию: Приложение, Аудио, Изображение, Текст, Видео и Другое. В настоящее время нет способа определить новые типы файлов в пользовательском интерфейсе.
Режимы просмотра
Режимы просмотра используются, чтобы сообщить Drupal 7 (и скоро 8), что часть контента находится в определенном контексте. Затем содержимое может быть изменено или отображено так, чтобы лучше всего соответствовать этому контексту. Большинству людей, вероятно, знакомы два режима просмотра: тизер по умолчанию и полный режим. Пользовательские режимы просмотра могут быть определены с помощью таких модулей, как Entity View Mode , Display Suite или в пользовательском модуле с hook_entity_info_alter()
.
Хороший материал, или: Управление отображением вашего файлового поля
Отображение поля файла управляется для каждого типа файла . Перейдите к Структуре -> Типы файлов. Вы увидите список доступных типов файлов со ссылками на «Управление полями», «Управление отображением» и «Управление отображением файлов» для каждого.
Управление полями
Модуль File Entity делает все файлы полными объектами, такими же как узлы и термины таксономии. Как и в разделе «Типы содержимого», вы можете добавлять настраиваемые поля для каждого типа файла.
Управление дисплеем
Опять же, как и в «Типах содержимого», вы можете управлять отображением пользовательских полей для каждого типа файла. Этот раздел не управляет форматированием самих файлов , только отображением полей, прикрепленных к объекту файла.
В этом разделе вы также увидите переключатель «Пользовательские настройки отображения». После расширения вы можете включать и отключать режимы просмотра, доступные для этого объекта. Здесь необходимо проверить режим просмотра, чтобы он был доступен в «Управлении отображением файлов». В настоящее время рекомендуется использовать только пользовательские режимы просмотра, определенные пользователем, и следующие режимы просмотра по умолчанию; остальные остаются от интеграции модуля Styles и в конечном итоге будут удалены :
- «Тизер» (в настоящее время не включен по умолчанию. Вы можете добавить его с патчем в вышеприведенном выпуске или определить как режим пользовательского просмотра)
- "Полный"
- «Предварительный просмотр» (используется в контекстах администратора, например, для заполнителей в полях WYSIWYG, в браузере мультимедиа и в виджете полей мультимедиа)
Управление отображением файлов
В «Управлении отображением файлов» вы можете настроить форматеры для ваших типов файлов (да!). Многие модули медиа-провайдеров добавляют сюда свои собственные форматеры; например, Media: Youtube и Media: Vimeo предоставляют форматтер «Предварительный просмотр» и «Видео».
Форматтеры можно включить и настроить для каждого режима просмотра, включенного в разделе «Управление отображением» своего типа файлов. Например, пользователь может захотеть отобразить предварительное изображение Media: Vimeo, когда узел просматривается как тизер, видео Vimeo, когда просматривается полный узел, и видео с другими настройками форматирования ширины и высоты, когда узел просматривается с настраиваемый режим просмотра, называемый «видео галерея». Многие средства форматирования (в частности, «Изображение») позволяют пользователю выбирать стили изображения, определенные в «Конфигурация» -> «Стили изображения».
Поскольку несколько поставщиков мультимедиа могут использовать одно и то же поле, средства форматирования располагаются сверху вниз. Drupal будет использовать первый форматер, который можно применить к выводу поля. Если в поле видео включены средства форматирования «Мультимедиа: Youtube видео», «Мультимедиа: Vimeo Video» и «Большой значок типа файла» для режима просмотра «Полный», Drupal будет использовать форматер Youtube, если для типа файла mime выбран тип video/youtube
Vimeo. formatter, если тип mime video/vimeo
, и отступите к большому значку типа файла, если тип mime video/{anything else}
.
Настройка отображения поля файла с помощью настроек «Управление отображением файла»
Чтобы поле файла отображалось с использованием форматеров, определенных в «Управлении отображением файлов», его необходимо настроить для отображения «визуализированного файла». Перейдите на страницу «Управление отображением» для типа содержимого , содержащего поле вашего файла. Выберите «Rendered file» в качестве формата поля файла для всех режимов просмотра, в которых вы хотите использовать средства форматирования, определенные в «Manage File Display».
Дальнейшее Тематическое
Вы можете создавать пользовательские функции темы и файлы шаблонов для еще большего контроля с переопределением перехватов темы . Тематические предложения, предоставляемые модулем File Entity:
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 Theme Developer , помощника Mothership's Poor Themer's Help или, надеемся, обратитесь к документации поставщика для получения дополнительной информации.
Outro
Надеюсь это поможет. Я планирую добавить это в документацию по медиа, поэтому, если я что-то пропустил, где-то ошибся или какой-то раздел требует уточнения, пожалуйста, дайте мне знать.
И несколько коротких ответов на конкретные вопросы ОП:
- Media 1.x против 2.x: хотя 2.x нестабилен, он так же надежен, как и многие стабильные модули версий на Drupal.org. Я думаю, что это стоит использовать для значительно улучшенных функций, но из-за того, что в очереди проблем слишком много работы по поддержке, медленная, и, как и в любой ветке разработки, новые обновления могут нарушить вашу реализацию. Тем не менее, я использую его на производстве.
- Медиа находится в разработке. Некоторые вещи работают не так, как вы надеетесь (например, интеграция без изображения WYSIWYG). Но он все равно работает лучше, чем комбинация модулей, которые вы должны установить, чтобы сделать то, что он делает без него. И это становится лучше.