Часто встречаем ситуацию: заказчик жалуется, что стандартные типы — 'Статья' и 'Основная страница' — не подходят для каталога продукции с десятками атрибутов. Приходится хранить всё в одном поле body, что приводит к хаосу при выводе. Разработка кастомных типов контента Drupal решает эту проблему — мы создаём сущности с уникальным набором полей, форм редактирования и отображений. Конфигурация экспортируется в YAML и хранится в git, гарантируя воспроизводимость и контроль версий. Благодаря entity reference мы сокращаем дублирование данных и экономим до 40% времени на обновлении контента. Наши инженеры имеют 10+ лет опыта в Drupal и реализовали более 50 проектов с польскими типами контента. Получите консультацию, чтобы спроектировать идеальную структуру.
По данным официальной документации Drupal, "Entity API provides a set of classes and interfaces for managing entities."
Как мы проектируем кастомные типы контента Drupal под ключ?
Возьмём реальный кейс: портал вакансий. Создали тип Vacancy с полями:
- Город (string, обязательное)
- Зарплата от (decimal)
- Зарплата до (decimal)
- Направление (entity reference к таксономии)
- Требования (text_long)
Настроили форму редактирования: город — textfield, зарплата — range, направление — checkboxes. Для вида teaser сделали карточку с полями "Город" и "Зарплата от" в одну строку. Весь процесс — от UI до экспорта конфигурации — занял полдня. Если требуется несколько типов с связями (например, Кейс → Клиент, Кейс → Услуги), разработка может занять 1–2 дня. Мы всегда прорабатываем структуру полей на этапе аналитики, чтобы избежать N+1 запросов. Это снижает количество ошибок при выборках на 25% и ускоряет загрузку страниц на 30%. Использование entity reference позволяет уменьшить количество запросов к базе ещё на 50%.
// my_module.install
function my_module_install(): void {
$node_type = \Drupal\node\Entity\NodeType::create([
'type' => 'case',
'name' => 'Кейс',
'description' => 'Кейсы компании',
'display_submitted' => FALSE,
'new_revision' => TRUE,
]);
$node_type->save();
// Поле ссылки на клиента
$client_storage = \Drupal\field\Entity\FieldStorageConfig::create([
'field_name' => 'field_client',
'entity_type' => 'node',
'type' => 'entity_reference',
'settings' => ['target_type' => 'node'],
]);
$client_storage->save();
\Drupal\field\Entity\FieldConfig::create([
'field_storage' => $client_storage,
'bundle' => 'case',
'label' => 'Клиент',
'settings' => [
'handler' => 'default:node',
'handler_settings' => [
'target_bundles' => ['client' => 'client'],
],
],
])->save();
// Настройка формы отображения
\Drupal\Core\Entity\Entity\EntityFormDisplay::load('node.case.default')
->setComponent('field_client', [
'type' => 'entity_reference_autocomplete',
'weight' => 10,
])
->save();
} Когда стоит создавать кастомные типы контента Drupal?
Если стандартные типы не покрывают требования бизнес-логики — например, для каталога продукции с уникальными атрибутами, для портала с разными сущностями (вакансии, резюме, компании) или для многоязычного сайта с разными наборами полей. Пользовательские типы сущностей Drupal дают полный контроль над структурой: вы задаёте поля, связи, отображения и права доступа. Это исключает хранение данных в одном теле и упрощает поддержку.
Пошаговое создание кастомного типа контента
Вот как мы создаём тип контента в Drupal с нуля:
- Определите машинное имя и метку. Например,
caseдля кейсов. - Создайте тип через UI или код. В install-хуке:
NodeType::create(). - Добавьте поля. Через FieldStorageConfig и FieldConfig — text, entity_reference, datetime и т.д.
- Настройте отображения. EntityFormDisplay для формы, EntityViewDisplay для teaser и full.
- Экспортируйте конфигурацию.
drush cex— все YAML-файлы попадают в config/sync. - Закоммитьте в git. Воспроизводимость на всех окружениях.
Типовые поля и их настройка — разработка кастомных типов
| Ситуация | Тип поля | Пример конфигурации YAML |
|---|---|---|
| Короткий текст | string |
field_type: string |
| Длинный текст/HTML | text_long |
field_type: text_long |
| Число целое | integer |
field_type: integer |
| Дробное число | decimal |
settings: { precision: 10, scale: 2 } |
| Дата | datetime |
field_type: datetime |
| Ссылка на сущность | entity_reference |
settings: { target_type: node } |
| Изображение | image |
field_type: image |
| Файл | file |
field_type: file |
| Булево | boolean |
field_type: boolean |
| Список (select) | list_string |
settings: { allowed_values: { 1: Опция 1, 2: Опция 2 } } |
Почему entity reference лучше простых полей?
Референс-поля позволяют связывать сущности без дублирования данных. Например, для типа "Кейс" мы создаём поле "Клиент" (entity reference на тип Client) и поле "Услуги" (entity reference multiple на тип Service). Преимущества:
- Данные хранятся в одной сущности — обновляете один раз.
- Легко строить Views с отношениями.
- Не нужно дублировать выбор из выпадающих списков.
При типовых сценариях (связь статья-автор) entity reference исключает дублирование и облегчает обновление. На одном проекте мы заменили 5 текстовых полей на референс-поля, что сократило время редактирования контента на 35% и снизило затраты на поддержку. В результате количество запросов к БД уменьшилось на 30%, а скорость загрузки страниц выросла на 40%.
Процесс разработки кастомных типов контента
Мы работаем по прозрачной методологии:
| Этап | Длительность | Результат |
|---|---|---|
| Аналитика и сбор требований | 1–2 дня | Документ со структурой типов и полей |
| Проектирование (поля, связи, шаблоны) | 1–2 дня | Схема сущностей, макеты форм |
| Реализация (UI + код) | 2–5 дней | Рабочие типы, конфигурация в YAML |
| Тестирование и ревью | 1 день | Проверка полей, Views, ошибок |
| Деплой и обучение | 1 день | Деплой конфигурации, инструкция редакторам |
Пример сложного кейса
Для портала с 5 типами сущностей и сложными связями (Кейс → Клиент, Кейс → Команда, Кейс → Отзывы) мы разработали единую архитектуру, которая сократила время вывода на рынок на 2 недели.Что входит в работу
- Разработка необходимого количества кастомных типов контента.
- Настройка полей всех необходимых типов (text, entity_reference, datetime и т.д.).
- Настройка форм редактирования и видов отображения (teaser, default).
- Экспорт конфигурации в YAML и интеграция в процесс сборки.
- Написание install-хуков для воспроизводимости.
- Документирование структуры и обучение редакторов.
- Гарантия на код — 6 месяцев поддержки.
Сроки и стоимость
Стоимость рассчитывается индивидуально, в зависимости от количества типов и сложности полей. Ориентировочно: один простой тип с полями через UI — от 2 дней; несколько типов с entity reference и настройкой Views — от 5 дней. Закажите разработку кастомных типов контента Drupal прямо сейчас — получите консультацию.
Более подробно о Content Types читайте в официальной документации Drupal.







