Включение стилей изображения по умолчанию с вашей темой

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

Процесс включения стиля изображения в вашу тему аналогичен процессу включения конфигурации по умолчанию в модуль.

• Создайте стиль изображения, который вы хотите включить, используя пользовательский интерфейс
• Экспортируйте стиль изображения как YAML
• Включите экспортированный YAML в каталог config / install вашей темы, следуя соответствующим правилам именования.

Начните с создания стиля изображения с помощью интерфейса администратора в разделе «Конфигурация»> «Мультимедиа»> «Стили изображения» (admin/config/media/image-styles). Как только стиль изображения будет создан и сохранен, конфигурация, которая составляет этот стиль изображения, будет сохранена в активной конфигурации вашего сайта.

Эту конфигурацию можно экспортировать с помощью:

• единый инструмент импорта/экспорта в разделе Конфигурация> Управление конфигурацией> Единый импорт / экспорт> Экспорт (admin/config/development/configuration/single/export).
• из списка выбора типа конфигурации выберите «Стиль изображения»
• затем выберите свой стиль изображения из списка выбора имени конфигурации.

YAML-представление стиля изображения будет отображаться в текстовой области и может быть скопировано и вставлено в файл .yml в каталоге config/install вашей темы. Файлы конфигурации следуют определенной схеме именования. image.style.{имя стиля изображения}.yml. Если вы не уверены, какое имя должен использовать ваш файл, он отображается под текстовой областью с экспортированной конфигурацией.

Обратите внимание, что экспортированная конфигурация будет содержать ключ UUID в качестве первой строки. Этот UUID должен быть удален перед копированием конфигурации в новый файл image.style.{image style name}.yml.

Пример THEMENAME/config/install/image.style.black_white.yml

langcode: en status: true dependencies: { } name: black_white label: 'black & white' effects: 8d4f85cc-9a2d-4a30-af15-21b0833dc06d: uuid: 8d4f85cc-9a2d-4a30-af15-21b0833dc06d id: image_desaturate weight: 1 data: { } third_party_settings: { } 

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

Обратите внимание, что после установки темы редактирование YML-файла стиля изображения в config/install не будет иметь никакого эффекта, равно как и добавление дополнительного YML-файла стиля изображения в config/install.