Theming/Render

Question 1

Что такое “тема”? Как используется?

Answer 1

• Набор файлов, определяющий внешний вид сайта.
• Устанавливается composer require THEMENAME
  Включаются drush en THEMENAME
  Drupal, по умолчанию, поддерживает две темы на выбор: административную — использующихся на всех административных страницах и по умолчанию - используемую на всех остальных страницах сайта.

Question 2

a. Чем она отличается от модуля?

Answer 2

Модуль отвечает за контент. Тема оформления определяет как HTML и CSS стили сайта обернут ваш контент.

Question 3

b. Какая базовая структура темы?

Answer 3

*.info.yml
Тема оформления должна содержать файл описывающий данную тему для Drupal. Это единственный обязательный файл для тем оформления.
*.libraries.yml
Файл .libraries.yml используется для объявления ассетов темы оформления, которые могут быть как JavaScript, так и CSS файлами. В теме объявляются библиотеки, необходимые для данной темы оформления.
*.breakpoints.yml
В данном файле вы можете описывать контрольные точки (breakpoints) для адаптивного дизайна.
*.theme
Файл .theme является PHP файлом, который может содержать различную логику. Например препроцессинг шаблонов, или расширять настройки темы оформления.
logo.svg
Логотип, который будет использоваться по умолчанию как логотип сайта.
templates/
Папка, содержащая в себе все необходимые темплейты с HTML разметкой. Темплейты должны находиться в этой папке, а папка может иметь неограниченное кол-во вложенных с любым другим названием.

Question 4

2. Что такое регион? Как они используются?

Answer 4

• Регион - область страницы, внутри которой располагаются блоки
• Для того чтобы у вас появился новый регион, через который вы сможете выводить блоки, вам нужно:
  • Добавить данные о регионе в файл theme.info.yml
  • Отредактировать page.html.twig, добавив в него вывод нового региона

Question 5

3. Что такое twig? Каковы его возможности?

Answer 5

• Шаблонизатор Twig - компилирующий обработчик шаблонов
  Все Twig шаблоны в Drupal 8 компилируются в php файлы и хранятся в каталоге sites/default/files/php/twig/. Файлы шаблонов при этом кешируются для повторного использования и хранятся в файловой системе для улучшения производительности, перекомпилируются только при очистке Twig кеша.
  Все шаблоны в модулях и темах должны находиться в каталоге /templates.
• Поддерживает:
  Работу с массивами и переменными, циклы, условия, фильтры, экранирование, наследование шаблонов(Можем определять блоки внутри шаблона, а потом в наследуя от этого шаблона другой, переопределять эти блоки.)

Question 6

4. Как подключить JS или CSS?

Что такое assets library?

Answer 6

Создается файл *.libraries.yml(assets library)
в корне темы/модуля. Используется hook_page_attachments
($attachments[‘#attached’][‘library’][] = ‘helloworld/helloworld’;), либо для конкретной страницы render array из метода контроллера($output[‘#attached’][‘library’][] = ‘helloworld/helloworld’;)

Question 7

c. Theme-шаблоны

i. Как его можно переопределить? Какие есть стандарты именования шаблонов?

Answer 7

добавив в папку вашей темы шаблоны, которые соответствуют определенному соглашению об именах.
hook_theme_suggestions_HOOK(array $variables)
hook_theme_suggestions_alter(array &$suggestions, array $variables, $hook)
hook_theme_suggestions_HOOK_alter(array &$suggestions, array $variables)

Question 8

b. Как можно подключить другой шаблон внутри текущего?

Answer 8

{% include ‘sub_template.html.twig’ %}

Question 9

a. Как создать свой регион?

Answer 9

• Добавить данные о регионе в файл theme.info.yml
• Отредактировать page.html.twig, добавив в него вывод нового региона
Все регионы объединены ключем regions