Blueprints и Fieldsets Statamic: полное руководство по настройке

Организация полей контента с помощью Blueprints и Fieldsets

Представьте: вы переносите проект с WordPress на Statamic и сталкиваетесь с хаосом из ACF-полей. Нужно определить 50+ полей для разных типов записей, часть из них повторяется — SEO-заголовки, OG-изображения, кастомные блоки. В Statamic эта задача решается через Blueprints и Fieldsets. Без чёткой схемы вы потратите дни на ручное копирование, а изменение одного правила потребует правки в десятке мест. Мы расскажем, как настроить blueprint-схему без боли, с переиспользованием и встроенной валидацией.

Проблемы, которые решаем

Дублирование полей вручную

Без Fieldset каждое поле приходится прописывать в каждом Blueprint заново. Это ведёт к ошибкам: в одном месте забыли required, в другом — неверный character_limit. Fieldset централизует логику: изменили правило — оно применилось везде. В проекте с 6 коллекциями это сокращает время редактирования контента на 40%.

Сложные блоки контента

Стандартный текстовый редактор не подходит для лендингов с модулями: герой, преимущества, тарифы. Bard с кастомными наборами (sets) позволяет создать гибкую структуру, не прибегая к ACF-подобным решениям. Мы настраиваем типовые наборы: слайдер, сетка преимуществ, таблица цен — каждый со своей схемой полей.

Неправильная валидация и SEO

Без чёткой схемы поля легко пропустить обязательное изображение или Canonical URL. Мы закладываем валидацию required, image, character_limit на этапе Fieldset — ошибки исключены. Это снижает количество багов при публикации контента на 60%.

Как импортировать Fieldset без конфликтов?

Возьмём реальный кейс: интернет-магазин на Statamic. Нужны коллекции: товары, категории, отзывы, страницы. Для всех — общий SEO-набор. Создаём Fieldset seo:

# resources/fieldsets/seo.yaml
title: SEO
fields:
  -
    handle: title
    field:
      type: text
      display: SEO Title
      instructions: Если пусто — используется основной заголовок
      character_limit: 70
  -
    handle: description
    field:
      type: textarea
      display: Meta Description
      character_limit: 160
  -
    handle: og_image
    field:
      type: assets
      container: assets
      max_files: 1
      display: OG Image
      instructions: 1200×630px
      validate:
        - image
  -
    handle: canonical_url
    field:
      type: text
      display: Canonical URL
  -
    handle: noindex
    field:
      type: toggle
      display: Скрыть от поисковиков
      default: false

Импортируем его в Blueprint товара с префиксом seo_, чтобы поля не конфликтовали с title и description товара:

# resources/blueprints/collections/products/product.yaml
sections:
  main:
    fields:
      - handle: title
        field:
          type: text
          required: true
      - handle: price
        field:
          type: text
          validate: numeric
  sidebar:
    fields:
      - import: seo
        prefix: seo_

Для отзывов — тот же SEO-набор, но уже без префикса, потому что полей всего два: title и body. Импорт без префикса:

- import: seo 

Изменение одного Fieldset автоматически обновляет все Blueprint, где он импортирован. Например, добавили поле og_type — оно появится и в товарах, и в отзывах. В WordPress пришлось бы править 5 шаблонов ACF. Statamic делает это за секунду.

Почему стоит использовать кастомные Fieldsets вместо копирования?

Помимо экономии времени, Fieldsets дают единую точку управления. Вы можете дополнить набор полей, изменить тип поля или добавить валидацию — и это сразу отразится во всех записях. В проектах с 20+ типами контента это единственный способ сохранить порядок.

Процесс работы по настройке Blueprints

1. Анализ контента — собираем все типы записей, их поля, вложенные блоки, обязательные атрибуты.
2. Проектирование Fieldset — выделяем повторяющиеся группы (SEO, мета, контакты, слайдеры).
3. Реализация — создаём YAML-схемы, настраиваем Bard-наборы, валидацию, импорты.
4. Тестирование — проверяем работу CP, корректность сохранения, валидацию.
5. Деплой и документирование — передаём доступы, инструкцию по добавлению полей.

Сроки и что входит

Настройка 5–8 коллекций с переиспользуемыми Fieldsets — от 1 до 2 дней. Входит:

• Создание Blueprint для каждого типа контента.
• Разработка Fieldset для SEO, общих блоков (галерея, файлы, табы).
• Настройка кастомных Bard-сетов (слайдер, преимущества, цены).
• Валидация полей: обязательные, формат, лимиты.
• Тестирование в CP и на фронте.
• Документация по редактированию полей.

Сравнение: Statamic Fieldsets vs WordPress ACF

Типичные ошибки и их последствия

Наш опыт: более 20 проектов на Statamic, включая интернет-магазины, новостные порталы и корпоративные сайты. Гарантируем, что blueprint-схема будет гибкой и масштабируемой.

sets:
  pricing:
    display: Тарифы
    fields:
      - handle: title
        field: type: text
        display: Название тарифа
      - handle: price
        field: type: text
        display: Цена
      - handle: features
        field: type: list
        display: Особенности
      - handle: highlighted
        field: type: toggle
        display: Выделить