PageBlocks - мощный инструмент для MODX в стиле Laravel!

Tab

Tab::make('Custom tab')
    ->id('extra')
    ->position(2)
    ->fields([
        Field::make('notes')->type('textarea')->label('Заметки'),
        Field::make('status')->type('select')->values([
            'active' => 'Активный',
            'inactive' => 'Неактивный'
        ]),
    ]);

• position(int $position) – Устанавливает позицию вкладки.
Если не указано, вкладка добавляется в конец стандартных.

Tab::make('Основное')->position(1);

• id(string $id) – Указывает идентификатор вкладки (не обязательно).

Tab::make('Настройки')->id('settings');

• fields(array $fields) – Задает список полей, которые будут внутри вкладки.

Tab::make('SEO')->fields([
    Field::make('meta_title')->label('Meta Title'),
    Field::make('meta_description')->type('textarea')->label('Meta Description')
]);

Field

Field::make('name'); // Будет создано текстовое поле с именем 'name'.

Field::make('name')->label('Name');
// или еще короче
Field::make('Name');

• type(string $type) – Устанавливает тип поля (text, number, date, select и т. д.).
• label(string $label) – Задает название (ярлык) поля.
• description(string $description) – Добавляет описание поля.
• help(string $help) – Показывает вспомогательный текст.
• default(mixed $default) – Устанавливает значение по умолчанию.
• required(bool $required = true) – Делает поле обязательным.
• disabled(bool $disabled = true) – Отключает редактирование поля.
• readOnly(bool $readonly = true) – Устанавливает поле только для чтения.
• width(int $width = 100) – Задает ширину поля в процентах.

• height(int $height) – Устанавливает высоту поля (только для textarea и richtext).

• html(string $html) – Позволяет вставить HTML-код в заголовок.

• options(string $options) – Устанавливает параметры маски ввода.

• allowDecimals(bool $allowDecimals = true) – Разрешает использование десятичных чисел.
• decimalSeparator(string $decimalSeparator) – Устанавливает символ-разделитель для десятичных чисел.
• decimalPrecision(int $decimalPrecision) – Определяет количество знаков после запятой.
• allowNegative(bool $allowNegative = true) – Разрешает отрицательные значения.
• minValue(int $minValue) – Устанавливает минимальное значение.
• maxValue(int $maxValue) – Устанавливает максимальное значение.

• multiple(bool $multiple = true) – Включает возможность выбора нескольких значений.
• model(string $model) – Указывает модель для загрузки данных.
• displayField(string $displayField) – Указывает поле модели для отображения значений.
• valueField(string $valueField) – Определяет поле модели, из которого берутся значения.
• where(array $where) – Позволяет задать условия выборки данных.
• sortby(string $sortby) – Устанавливает поле для сортировки.
• sortdir(string $sortdir) – Определяет направление сортировки (ASC или DESC).
• limit(int $limit) – Ограничивает количество загружаемых записей на странице.
• values(array|callable $values) – Устанавливает статический список значений для выбора.
Можно передать массив:

Field::make('status')->values([
    'active' => 'Активный',
    'inactive' => 'Неактивный',
    'pending' => 'В ожидании'
]);

Или использовать функцию-генератор:

Field::make('resource')->values(function() {
    $modx = self::getModx();
    $resources = $modx->getCollection(\modResource::class, [
        'published' => true,
    ]);

    return array_column($resources, 'pagetitle', 'id');
})

• hiddenFormat(string $hiddenFormat) – Устанавливает скрытый формат даты.
• dateFormat(string $dateFormat) – Определяет формат отображаемой даты.
• startDay(int $startDay) – Устанавливает первый день недели (0 – воскресенье, 1 – понедельник).
• minDateValue(int $minDateValue) – Указывает минимальную допустимую дату.
• maxDateValue(int $maxDateValue) – Указывает максимальную допустимую дату.
• hideTime(bool $hideTime = true) – Скрывает выбор времени.
• timeFormat(string $timeFormat) – Определяет формат времени.
• timeIncrement(int $timeIncrement) – Устанавливает шаг изменения времени (например, каждые 15 минут).
• minTimeValue(string $minTimeValue) – Минимально допустимое время.
• maxTimeValue(string $maxTimeValue) – Максимально допустимое время.
• disabledDates(array $disabledDates) – Список недоступных для выбора дат.
• disabledDays(array $disabledDays) – Список заблокированных дней недели (0 – воскресенье, 1 – понедельник и т. д.).

• source(int $source) – Устанавливает источник файлов.
• sourcePath(string $sourcePath) – Определяет путь к файлам.
• openTo(string $openTo) – Указывает папку, в которую откроется менеджер файлов.

• thumbnails(string $thumbnails) – Задает шаблон эскизов изображений.

Field::make('gallery')
        ->label('Images')
        ->type('gallery')
        ->source(1)
        ->sourcePath('/assets/images/')
        ->thumbnails('{"webp":{"w":120,"h":90,"q":90,"zc":"1","bg":"000000","f":"webp"}}')

• keyLabel(string $keyLabel) – Определяет заголовок для ключа.
• valueLabel(string $valueLabel) – Определяет заголовок для значения.

• columns($columns) – Устанавливает колонки таблицы.
• searchable(bool $searchable = true) – Разрешает поиск по таблице.
• filters(array $filters) – Добавляет фильтры к таблице.
• fields(array $fields) – Определяет список полей внутри таблицы.
Принимает массив полей, которые будут использоваться в таблице:

Field::make('products')->fields([
    Field::make('name')->label('Название'),
    Field::make('price')->type('number')->label('Цена'),
    Field::make('stock')->type('number')->label('Остаток')
]);

• hidden(string $field, string $operator, mixed $value) – Скрывает текущее поле в зависимости от значения другого поля.
• $field – Название поля, от которого зависит текущее.
• $operator – Оператор сравнения (>, <, >=, <=, =, !=, ><, !><, IN, NOT IN).
• $value – Значение, с которым сравнивается поле.

Field::make('discount')->type('number')->hidden('has_discount', '!=', 1);

В этом случае поле discount будет скрыто, если has_discount не равно 1.

Column

Field::make('products')->type('table')->columns([
    Column::make('name')->label('Название')->sortable()->width(200),
    Column::make('price')->label('Цена')->sortable()->width(100),
    Column::make('createdon')->label('Дата добавления')->render('date')->sortable(),
    Column::make('published')->label('Опубликовано')->render('boolean'),
    Column::make('image')->label('Изображение')->render('image')->width(150),
]);

• label(string $label) – Устанавливает заголовок колонки.
• id(string $id) – Устанавливает уникальный идентификатор колонки.
• render(string $render) – Определяет способ отображения данных. Доступные значения:
• sortable(bool $sortable = true) – Включает или отключает сортировку по этой колонке.
• width(int $width) – Устанавливает ширину колонки в пикселях. Если не указано, ширина будет определяться автоматически.

Block

Block::make('Основная информация')
    ->chunk('main_chunk')
    ->description('Основные данные ресурса')
    ->fields([
        Field::make('title')->label('Заголовок'),
        Field::make('content')->type('textarea')->label('Контент'),
    ]);

• chunk(string $chunk) – Устанавливает чанк, к которому будет привязан блок.
• description(string $description) – Устанавливает описание блока.
• fields(array $fields) – Задает список полей, которые будут внутри блока.

Проблемы:

1. Не работает удаление строк для поля с типом keyvalue в MODX3
2. Ошибка в JavaScript после сохранения ресурса, если в текстовые поля ресурса были добавлены теги, но при этом все данные сохраняются.

Предстоящие задачи:

• Исправление проблем, что выше описаны
• Разработка модели User для управления профилями пользователей.
• Создание конструктора pbResources, упрощающего создание коллекций ресурсов.
• Интеграция Eloquent ORM для удобной работы с базой данных.
• Расширение возможностей шаблонизатора Fenom добавлением необходимых модификаторов.
• Реализация класса Validation для валидации данных, поступающих в REST API.
• Создание класса Request для упрощения работы с HTTP-запросами.