Налаштування модуля Paragraphs Drupal для гнучкого контенту

Налаштування модуля Drupal Paragraphs для гнучкого контенту

Paragraphs — один з найпопулярніших модулів Drupal. Дозволяє будувати сторінки з переиспользуемих блоків (параграфів): Hero-секція, текст із зображенням, картки, цитата, таблиця, форма. Редактор збирає сторінку з параграфів як конструктор, без програмування.

Встановлення

composer require drupal/paragraphs
drush en paragraphs -y
drush cr

Створення типу параграфа

Структура → Типи параграфів → Додати тип параграфа.

Приклад — параграф «Hero секція»:

• Назва параграфа: Hero секція
• Machine name: hero_section
• Поля:
  • field_hero_title (Text, plain)
  • field_hero_subtitle (Text, plain, long)
  • field_hero_image (Image)
  • field_hero_cta_text (Text, plain)
  • field_hero_cta_url (Link)

Додавання поля Paragraphs до типу контенту

Управління полями → Додати поле → Тип: Параграф (entity reference revisions).

Налаштування:

• Кількість значень: Не обмежено (щоб додавати кілька параграфів)
• Дозволені типи параграфів: вибрати потрібні
• Віджет: Paragraphs Classic або Paragraphs Experimental (з drag-and-drop)

Шаблон параграфа у темі

Файл templates/paragraph/paragraph--hero-section.html.twig:

{% set classes = ['paragraph', 'paragraph--hero-section'] %}

<section{{ attributes.addClass(classes) }}>
    <div class="hero__content">
        {% if content.field_hero_title %}
            <h1 class="hero__title">{{ content.field_hero_title }}</h1>
        {% endif %}

        {% if content.field_hero_subtitle %}
            <p class="hero__subtitle">{{ content.field_hero_subtitle }}</p>
        {% endif %}

        {% if content.field_hero_cta_text and content.field_hero_cta_url %}
            <a href="{{ content.field_hero_cta_url[0]['#url'] }}" class="btn btn--primary">
                {{ content.field_hero_cta_text }}
            </a>
        {% endif %}
    </div>

    {% if content.field_hero_image %}
        <div class="hero__image">
            {{ content.field_hero_image }}
        </div>
    {% endif %}
</section>

Вкладені параграфи

Параграф може містити дочірні параграфи. Наприклад, «Секція з картками» містить кілька параграфів «Картка»:

1. Створити тип card з полями: заголовок, текст, іконка
2. Створити тип cards_section з полем field_cards типу Paragraph, дозволений тип: card
3. Редактор додає секцію → всередину додає картки

Налаштування відображення

Управління відображенням → Display Suite або Layout Builder для візуального розташування полів параграфа.

Paragraphs і ревізії

Paragraphs підтримують ревізії синхронно з батьківським вузлом (entity reference revisions — не просто entity reference). При відкату ноди — відкатуються й параграфи.

Терміни

Розробка 5–8 типів параграфів з шаблонами — 3–5 днів залежно від складності верстки кожного блоку.