Entity

Question 1

1. Что такое entity?

Answer 1

Сущность (entity) это объект с набором свойств и методов. Например нода, у неё есть свойства title, status и методы save(), isPublished()

Question 2

2. Какие существуют глобальные типы entity? В чём их различия?

Answer 2

В друпале два вида сущностей - content entity и config entity.

Контент-сущности, это сущности, которые содержат user-generated контент, т.е. ноды, пользователи, комментарии, файлы и т.д. Контент-сущность можно из админки расширять полями и настраивать их отображение.
Конфиг-сущности, это сущности, которые можно описать в коде, например Views, форматы дат, настройки отображения полей, стили изображений. По простому это настройки сайта. Конфиг-сущности можно экспортировать/импортировать/деплоить.

Question 3

3. Какие content entity существуют в Друпале по умолчанию?

Answer 3

node (Node) — также известна как «Тип материала». Предоставляется одноимённым модулем node. Это основная сущность в Drupal, которая, в установочных профилях отличных от минимального, включена по умолчанию. Она используется для создания содержимого на сайте: Страницы, Публикации, Новости, Отзывы и т.д. Это основная сущность для хранения и работы с содержимым из коробки.
user (User) — сущность «Пользователь» предоставляет хранилище данных для пользователей сайта. Как правило хранит, имя пользователя, логин, пароль, email и т.д.

Question 4

a. Что такое node, зачем она нужна и как пользоваться?
b. Что такое taxonomy, зачем она нужна и как пользоваться?
c. Что такое блоки, зачем они нужны и как ими пользоваться?
i. block и block_content - что это, в чём различия?

Answer 4

b. taxonomy - Предоставляется одноимённым модулем taxonomy. Таксономия используется для классификации содержимого сайта.
c. Блоки - это боксы содержимого, отображаемые в регионах.
block - плагины, создаются через код
block_content - контент, создается через админку

Question 5

4. Что такое bundle (content type)? Как создать свой?

Answer 5

Подтип типа сущности, содержащий в себе дополнительный набор полей
Создать:
- через админку
- программно

Question 6

5. Что такое field? Какие типы полей бывают?

a. Как добавить поле в entity type?

Answer 6

Field – поле содержащее дополнительную информацию, привязанную к конкретному экземпляру сущности
Типы
string
boolean
integer
decimal
language
timestamp
changed
datetime
uuid
email
entity_reference
map

hook_entity_base_field_info
hook_entity_bundle_field_info

Question 7

6. Что такое field_base, field_instance?

Answer 7

feld_base – это базовое поле

field_instance – это экземпляр типа поля с отдельными настройками, привязанный к конкретному типу сущности

Question 8

7. Что такое entity display? Зачем они нужны, как создать свой?

Answer 8

Настройка(конфигурационная сущность), которая содержит параметры отображения для атрибутов сущности(какие поля каким образом отображать)

• через админку (admin/structure/display-modes)
• через yml файл
• программно EntityViewMode::create()

Question 9

8. Что такое field format? Как создать свой форматтер?

Answer 9

Field format – это представление содержимого поля для конечного пользователя.
Отвечает за формирования значений нашего поля на вывод, грубо говоря варианты/форматы вывода
Форматттер представляет из себя плагин, имплементирующий FormatterBase

Question 10

9. Что такое entity form display? Зачем они нужны, как создать свой? Чем отличаются от entity display?

Answer 10

Настройка отображения формы редактирования сущности.

• через админку (admin/structure/display-modes)
• через yml файл
• программно EntityFormMode::create()

Question 11

10. Что такое field widget? Как создать свой?

Answer 11

Widget – это визуальный интерфейс ввода дынных в поле.
Отвечает за то, как будет выглядеть форма ввода и редактирования поля, это форма с настройками для нашего поля, которое вы видите в административном интерфейсе сразу после добавления нового поля, а также при его редактировании.
Widget представляет из себя плагин, имплементирующий WidgetBase

Question 12

11. Как создать реакцию на создание сущности? Изменение/удаление?

Answer 12

hook_entity_insert
hook_entity_update
hook_entity_delete

Question 13

12. Как создать свой тип сущности? Когда это следует делать?

Answer 13

Создавать свой тип сущности нужно когода ни один из существующих не удовлетворяет ваши потребности.
ContentEntityBase

Question 14

13. Каким образом можно управлять доступом к сущности?

i. Что такое роли и пермишены? Как создать свои?

Answer 14

Управление доступом

• в админке через роли и пермишены
• через hook_entity_access ($entity, $account)

Создать свои роли и пермишены

• через админку
• через yml файлы
• через create у классов Permission и Role

Question 15

14. Как изменить свойства типа сущности?

a. Как заменить класc?

Answer 15

hook_entity_type_alter () {
$entity_types[‘user’]->setHandlerClass(‘access’, CustomAccessHandler::class);
}
+ написать класс хандлера

Как заменить класс?
my_module_entity_type_build () {
$entity_types[‘node’]->setClass(‘Drupal\my_module\Entity\MyNode’);
}

Question 16

15. Валидаторы, зачем нужны? Как добавить валидатор к типу сущности?
    a. Из чего состоит?
    b. Как создать свой?

Answer 16

Валидатор - защита от некорректного ввода данных.
Состоит:
Ограничение: класс, который хранит в себе настройки ограничений
Валидатор: непосредственно проверяет валидность данных(соответствие ограничениям)
Хук: прицепляет ограничение к типу сущности (hook_entity_type_alter)