Основные понятия
У Drupal свой словарь. Эти слова встречаются в панели, в документации и в именах классов, поэтому с ними нужно познакомиться до первого модуля. Всё перечисленное в этом уроке настраивается в панели, без кода.
Материалы и их типы
Материал (по-английски node) — единица содержимого: статья, страница, новость. У каждого материала есть номер, заголовок, автор и дата создания. Страница материала открывается по адресу /node/1, где 1 — номер.
Тип материала задаёт набор полей. В стандартной установке их два: «Статья» с машинным именем article и «Страница» — page. Машинное имя — короткое имя из латинских букв, по которому к типу обращаются из кода.
Типы находятся в разделе «Структура → Типы материалов», адрес /admin/structure/types. Создайте две-три статьи через «Содержимое → Добавить материал → Статья»: они понадобятся в следующих уроках.
Поля
Поле — часть материала: текст, число, дата, картинка, ссылка на другой материал. У статьи после установки есть поля body (текст), field_image (картинка) и field_tags (метки). Поля, добавленные в панели, получают имена с приставкой field_.
Поля добавляют на вкладке «Управлять полями» нужного типа материала. Там же, на вкладке «Управление отображением», задают порядок и вид полей на странице.
Таксономия
Таксономия — словари терминов для группировки содержимого: рубрики, метки, города. Словарь tags уже создан и связан со статьями полем field_tags. Словари находятся в разделе «Структура → Таксономия».
Блоки
Блок — кусок страницы вне основного содержимого: меню, форма поиска, список свежих статей. Тема делит страницу на области — шапка, боковая колонка, подвал, — а администратор размещает в них блоки на странице «Структура → Схема блоков», адрес /admin/structure/block.
Представления
Представление (модуль Views) — конструктор списков. В нём выбирают, что показать, по каким условиям отобрать и как отсортировать, а Drupal сам строит запрос и страницу. Главная страница со списком статей — тоже представление. Раздел «Структура → Представления».
Сущности
Сущность (entity) — общее название всего, что Drupal хранит как отдельные записи.
| Сущность | Машинное имя | Что это |
|---|---|---|
| Материал | node | Статьи, страницы |
| Пользователь | user | Учётные записи |
| Термин таксономии | taxonomy_term | Рубрики и метки |
| Файл | file | Загруженные файлы |
| Комментарий | comment | Комментарии к материалам |
У всех сущностей общий способ загрузки, сохранения и поиска — он разобран в главе «Данные». Разновидность сущности называют бандлом (bundle): для материала это тип материала, для термина — словарь.
Частая ошибка
Заголовки в панели можно перевести и переименовать, а машинные имена — нет. Тип «Статья» в коде всегда article, поле с картинкой — field_image. Обращение по отображаемому названию не сработает. Машинное имя видно в списке типов материалов и на вкладке «Управлять полями».