Типы материалов и поля в Drupal: короткое руководство

За 20–30 минут в Drupal 10 или 11 можно создать тип материала, добавить к нему поля и проверить форму публикации. В результате у вас появится собственная структура записи: например, «Новость» с заголовком, изображением, кратким описанием и датой события — без изменения кода темы.

Что подготовить до начала

Нужен сайт на Drupal 10.x или 11.x, учётная запись с правом управлять типами материалов и доступ к административной панели. Названия пунктов могут немного отличаться после установки модулей или перевода интерфейса.

• Войдите под пользователем с административными правами.
• Определите, какую сущность вы создаёте: отдельный тип записи, а не просто новую страницу.
• Заранее выпишите поля: например, «Краткое описание», «Изображение», «Дата события».
• Решите, какие поля обязательны, а какие можно оставить пустыми.

Проверка: в административном меню доступен раздел Структура, а внутри него — пункт Типы материалов или Content types.

Тип материала и поле — не одно и то же

Тип материала — шаблон структуры записи. Он определяет, какие данные вводит редактор, какие настройки публикации доступны и как материал может отображаться на сайте.

Поле — отдельное значение внутри записи: текст, изображение, ссылка, дата, число или ссылка на другой материал. Один тип материала состоит из стандартных полей Drupal и добавленных вами полей.

Если у записей одинаковая структура, создавайте один тип материала и добавляйте поля. Не делайте отдельный тип для каждой новости.

Термин: машинное имя — системный идентификатор типа материала или поля. В интерфейсе это значение обычно начинается с латинской буквы, используется латиница и подчёркивания. Оно нужно Drupal для хранения настроек и не равно заголовку, который видит посетитель.

Пошагово: создаём тип материала

1. Откройте список типов

В административной панели перейдите в Структура → Типы материалов. Нажмите Добавить тип материала. Если интерфейс на английском, ищите Structure → Content types → Add content type.

В поле названия укажите, например, «Событие». Машинное имя Drupal предложит создать автоматически. Не меняйте его без необходимости: после добавления материалов переименование системных идентификаторов может потребовать отдельной миграции.

Проверка: в списке типов появился «Событие», а рядом доступны операции управления полями, формой и отображением.

2. Настройте основные параметры

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

Сохраните тип материала. Сначала достаточно базовых параметров: дополнительные настройки можно изменить позже.

Проверка: по адресу Добавить материал появился пункт «Событие», а форма открывается без сообщения об ошибке.

3. Добавьте текстовое поле

Откройте Структура → Типы материалов → Событие → Управление полями. Нажмите Добавить поле. Выберите тип Текст (простой) для короткой строки или Текст (форматированный, длинный, с резюме) для описания с форматированием.

Назовите поле «Краткое описание». На следующем экране задайте количество значений. Для одного анонса оставьте значение «Один». Если редактору нужно добавлять несколько одинаковых элементов, например список спикеров, выберите неограниченное количество или ограничение, подходящее вашей структуре.

Проверка: поле видно в таблице управления полями и появляется в форме создания материала «Событие».

4. Добавьте изображение

В управлении полями снова выберите Добавить поле и тип Изображение. Укажите понятное название, например «Обложка». В настройках поля задайте допустимые расширения и максимальный размер файла. Не разрешайте форматы, которые редакторы не используют: это уменьшит число случайных загрузок.

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

Проверка: в форме материала появился загрузчик файла, а после сохранения записи изображение отображается в просмотре или в административной форме.

5. Добавьте дату и настройте порядок полей

Для события добавьте поле типа Дата. Выберите формат, который соответствует задаче: только дата, дата и время или диапазон. Если посетителю важен интервал, например с 10:00 до 18:00, используйте вариант с началом и окончанием, если он доступен в установленной конфигурации Drupal.

На странице управления полями перетащите элементы в нужном порядке: заголовок, краткое описание, обложка, дата. Сохраните изменения.

Проверка: при создании нового «События» поля идут в выбранной последовательности, а дата принимает только подходящий формат.

6. Создайте первую запись

Перейдите в Содержимое → Добавить содержимое → Событие. Заполните обязательные поля, загрузите изображение и нажмите Сохранить. Если запись не должна быть доступна посетителям сразу, снимите статус публикации перед сохранением.

Проверка: Drupal показывает сообщение о сохранении материала, а опубликованная запись открывается по ссылке просмотра.

Что чаще всего ломается

• Нет пункта «Добавить тип материала». У пользователя недостаточно прав. Выйдите и проверьте роль, у которой разрешено администрирование типов материалов.
• «You do not have access to this page». Адрес правильный, но доступ запрещён политикой ролей. Попросите администратора выдать нужное разрешение, а не копируйте права суперпользователя на обычную редакторскую роль.
• «The website encountered an unexpected error. Try again later». Это общее сообщение Drupal. Проверьте отчёты в разделе Отчёты → Последние сообщения журнала и журналы PHP или веб-сервера. Не удаляйте поле из базы вручную.
• Поле создано, но его нет в форме. Проверьте, что вы редактировали поля именно нужного типа материала, а не переиспользуемого представления или другого типа записи. Затем очистите кеш, если изменения не появились сразу.
• Изображение не загружается. Сверьте расширение и размер файла с настройками поля, а также права на каталог файлов. Ошибка может находиться в ограничениях PHP на размер загрузки.

Где подход ломается

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

Не создавайте поля «на будущее». Каждое поле влияет на форму, отображение, экспорт данных и обслуживание сайта. Инвалидация кеша и настройка представлений — отдельные темы; здесь важна только базовая модель материала.

Что делать дальше

После первой записи откройте Управление отображением и настройте, какие поля видны в полном материале и в списках. Затем проверьте права редактора на создание, редактирование и публикацию записей. На рабочем сайте отдельно протестируйте загрузку больших изображений, обязательность полей и вывод пустых значений.

Если тип материала уже используется, перед удалением или переименованием поля сделайте резервную копию и проверьте, где оно участвует: в представлениях, шаблонах, миграциях и интеграциях.