Настройка Builder Plugin для October CMS

Настройка Builder Plugin для October CMS

Builder — официальный плагин RainLab для визуальной разработки плагинов October CMS. Позволяет создавать модели, базы данных, контроллеры и формы без написания кода. Полезен для быстрого прототипирования, но финальный код стоит доработать вручную.

Установка

php artisan plugin:install rainlab.builder
php artisan october:migrate

Возможности Builder

Database — создание таблиц через визуальный конструктор. Поддерживает все типы столбцов Laravel, индексы, внешние ключи. Генерирует файл миграции.

Models — создание Eloquent-моделей с настройкой полей, правил валидации, отношений, scope-методов.

Backend Controllers — CRUD-контроллеры с настройкой поведений (list, form, reorder).

Menus — добавление пунктов навигации в backend.

Versions — управление версиями и миграциями плагина.

Пример: создание плагина через Builder

1. Перейти в Backend → Builder → Выбрать плагин
2. Database → Add Table → указать название, добавить столбцы
3. Models → Add Model → выбрать таблицу, настроить $fillable, правила
4. Controllers → Add Controller → выбрать модель, настроить list columns и form fields через YAML

Сгенерированный columns.yaml:

# models/Product/columns.yaml
columns:
    name:
        label: Название
        searchable: true
        sortable: true
    price:
        label: Цена
        type: number
        sortable: true
    is_active:
        label: Активен
        type: switch
    created_at:
        label: Создан
        type: timesince

fields.yaml:

# models/Product/fields.yaml
fields:
    name:
        label: Название
        type: text
        required: true
        span: left
    slug:
        label: Slug
        type: text
        preset:
            field: name
            type: slug
        span: right
    price:
        label: Цена (руб.)
        type: number
        span: left
    description:
        label: Описание
        type: richeditor
        size: large
    image:
        label: Изображение
        type: fileupload
        mode: image
        imageWidth: 1200
        imageHeight: 630

tabs:
    fields:
        seo_title:
            tab: SEO
            label: SEO заголовок
            type: text
        seo_description:
            tab: SEO
            label: SEO описание
            type: textarea

Ограничения Builder

Builder не умеет: создавать кастомные компоненты с нетривиальной логикой, настраивать сложные отношения Many-to-Many, добавлять кастомные виджеты и поведения. После генерации скелета — дорабатываем код вручную.

Создание CRUD-плагина через Builder — 2–4 часа. Последующая ручная доработка — 1–3 дня.