Налаштування 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 дні.