Decap CMS конфигурация коллекций folder files виджеты

Конфигурация коллекций Decap CMS: folder, files, виджеты — полная настройка за 1 день.

Мы часто сталкиваемся с ситуацией, когда CMS после настройки превращается в «чёрный ящик»: редакторы путаются в полях, контент сохраняется не там, slug-и конфликтуют. Всё упирается в один YAML-файл — config.yml. Правильная конфигурация коллекций Decap CMS — это не просто список полей, а архитектура контента. Если её продумать заранее, вы сэкономите часы правок и нервов. За 6 лет работы над проектами с Decap CMS мы выработали подходы, которые помогут избежать типичных ошибок. Например, настройка коллекций для интернет-магазина с каталогом товаров, категорий и брендов заняла 6 часов. После внедрения редакторы создают товары в 2 раза быстрее, а количество ошибок при публикации сократилось на 40%.

Два типа коллекций: folder vs files

collections: # Folder collection
  - name: blog
    label: Блог
    folder: content/blog
    create: true
    delete: true
    slug: "{{slug}}"
    fields:
      - { label: Заголовок, name: title, widget: string }
      - { label: Контент, name: body, widget: markdown }
  # Files collection
  - name: pages
    label: Страницы
    files:
      - label: Главная страница
        name: home
        file: content/home.yaml
        fields:
          - { label: Заголовок hero, name: hero_title, widget: string }
          - { label: Подзаголовок, name: hero_subtitle, widget: text }
      - label: О компании
        name: about
        file: content/about.md
        fields:
          - { label: Заголовок, name: title, widget: string }
          - { label: Контент, name: body, widget: markdown }

Настройка коллекций для разных типов контента

Для информационного сайта достаточно двух коллекций: статьи (folder) и страницы (files). Для интернет-магазина понадобится каталог товаров, категории, бренды. Правило: один тип контента — одна коллекция. Не пытайтесь уместить товары и статьи в одну folder, иначе загромоздите интерфейс. Folder collection лучше Files collection для блога, так как позволяет создавать новые записи без правки конфига.

Виджеты: полный набор для реальных проектов

fields: # Базовые
  - { label: Строка, name: title, widget: string, required: true }
  - { label: Текст, name: description, widget: text }
  - { label: Число, name: order, widget: number, value_type: int, default: 0 }
  - { label: Булево, name: featured, widget: boolean, default: false }
  - { label: Дата, name: date, widget: datetime, format: "YYYY-MM-DD" }
  # Выбор из списка
  - label: Категория
    name: category
    widget: select
    options:
      - { label: Новости, value: news }
      - { label: Кейсы, value: cases }
      - { label: Аналитика, value: analytics }
  # Медиафайл
  - { label: Обложка, name: cover, widget: image, required: false }
  # Markdown-редактор
  - label: Контент
    name: body
    widget: markdown
    modes: [rich_text, raw]
  # Список строк
  - { label: Теги, name: tags, widget: list, required: false }
  # Вложенный объект (SEO)
  - label: SEO
    name: seo
    widget: object
    collapsed: true
    fields:
      - { label: Meta title, name: title, widget: string, required: false }
      - { label: Meta description, name: description, widget: text, required: false }
      - { label: OG Image, name: og_image, widget: image, required: false }
  # Список объектов (преимущества)
  - label: Преимущества
    name: features
    widget: list
    fields:
      - { label: Иконка, name: icon, widget: string }
      - { label: Заголовок, name: title, widget: string }
      - { label: Описание, name: description, widget: text }

Важность правильной конфигурации виджетов

Неправильный выбор виджета ведёт к проблемам с редактированием. Например, для длинных текстов используйте markdown, а не text — иначе редактор не сможет форматировать. Для числовых значений обязательно указывайте value_type и default, чтобы не было пустых полей. Мы гарантируем, что после нашей настройки редакторы не столкнутся с такими проблемами.

Сортировка и фильтрация

Для удобства редакторов добавьте sortable_fields и view_filters. Это позволит сортировать записи по дате, заголовку или кастомному полю, а также фильтровать по статусу.

---
- name: team
  label: Команда
  folder: content/team
  create: true
  sortable_fields: ['name', 'position', 'order']
  view_filters:
    - label: Только активные
      field: active
      pattern: true
    - label: Менеджеры
      field: department
      pattern: management
  view_groups:
    - label: По отделу
      field: department
---

Связанные коллекции через relation

Поле relation принимает параметры: collection — имя коллекции-источника, search_fields — поля для поиска, value_field — что сохранится в файле. Например: widget: relation, collection: team, search_fields: ['name'], value_field: name. В Markdown-файле сохранится имя автора как строка. Если нужен ID — меняем value_field: "{{slug}}".

Продвинутые настройки: nested и conditional

- name: docs
  label: Документация
  folder: content/docs
  create: true
  nested:
    depth: 3
  summary: "{{title}}"
  meta:
    path:
      label: Путь
      widget: parent-path
  fields:
    - label: Тип блока
      name: type
      widget: select
      options: [text, video, gallery]
    - label: Текст
      name: text
      widget: markdown
      condition:
        field: type
        value: text
    - label: URL видео
      name: video_url
      widget: string
      condition:
        field: type
        value: video

i18n коллекций

i18n:
  structure: multiple_files
  locales: [ru, en]
  default_locale: ru
collections:
  - name: services
    label: Услуги
    folder: content/services
    create: true
    i18n: true
    fields:
      - { label: Заголовок, name: title, widget: string, i18n: true }
      - { label: Слаг, name: slug, widget: string, i18n: duplicate }
      - { label: Контент, name: body, widget: markdown, i18n: true }

Распространённые ошибки и как их избежать

Что входит в настройку коллекций Decap CMS

• Разработка схемы контента под ваш проект (5–8 типов контента).
• Настройка виджетов, relation, nested, i18n.
• Проверка на реальных данных (до 50 записей).
• Документация для редакторов (описание каждого поля).
• Поддержка 2 недели после сдачи — правим недочёты.

Как мы внедряем конфигурацию коллекций Decap CMS?

1. Проводим интервью с редакторами — выясняем, какие поля используются чаще всего и что вызывает затруднения.
2. Проектируем схему коллекций: определяем типы, виджеты и связи между коллекциями.
3. Пишем config.yml, тестируем на staging-окружении — создание, редактирование, удаление записей.
4. Документируем каждое поле, объясняем назначение виджетов команде редакторов.
5. Передаём в работу с поддержкой 2 недели — оперативно правим под замечания.

Официальная документация Decap CMS

Сроки и стоимость

Базовая настройка (до 5 коллекций, без i18n): 4–8 часов. Средний проект (6–10 коллекций, relation): 1 день. Сложный проект (с i18n, условными полями, 10–15 коллекций): 1–2 дня. Стоимость базовой настройки — от $45–65, сложный проект с i18n и relation — от $180–260. Свяжитесь с нами, чтобы обсудить вашу конфигурацию Decap CMS. Получите консультацию инженера с 6-летним опытом работы с этой CMS. Гарантируем качество и соблюдение сроков.