Новые возможности PageBlocks: улучшенная работа с блоками, таблицами, полями и мультиязычностью

Блоки

Block::make('Slider')
    ->group('Table')
Block::make('Services')
    ->group('Service')

Cинхронизация многоразовых блоков.

Таблицы

• Пагинация
• Поиск
• Значения по умолчанию для столбцов таблицы

Поля

Поле JsonGrid

Field::make('Team')
    ->type('jsongrid')
    ->fields([
        Field::make('Name'),
        Field::make('Age')
            ->type('number'),
        Field::make('Skills'),
        Field::make('Location')
            ->type('select')
            ->options([
                'New York',
                'San Francisco',
                'London',
                'Berlin',
                'Sydney',
                'Toronto'
            ]),
    ]),

Переключаемое поле

Field::make('Danger')
    ->type('toggle')
    ->checked()
    ->danger(),
Field::make('Warning')
    ->type('toggle')
    ->checked()
    ->warning(),
Field::make('Green')
    ->type('toggle')
    ->checked(),

Сниппеты

• modx – стандартный парсер MODX.
• pdoTools – парсер от pdoTools.
• pbFenom – встроенный шаблонизатор Fenom в PageBlocks.

• chunksPath – путь к чанкам (по умолчанию chunks).
• fields – определяет, какие поля получать из базы.
• exclude – исключает определённые поля из выборки.
• tpl.wrapper.nameField – чанк-обёртка для поля
• tpl.item.nameField – чанк для каждой итерации, если значение поля массив

{'!pbResources'|snippet: [
    'resources' => '1,2,3',
    'tables' => 'seo_list as list'
    'tpl' => 'pb-seo-card',
    'tpl.wrapper.list' => '@INLINE <ul class="text-start">{$list}</ul>',
    'tpl.item.list' => '@INLINE <li>{$title}</li>'
]}

• _idx – индекс текущего элемента.
• _total – общее количество элементов.
• _first – первый элемент в списке.
• _last – последний элемент в списке.

• pbBlocks – для вывода блоков.
• pbTables – для вывода таблиц.
• pbCollections – для вывода коллекций. Будет удален в версии 2.6.0. Вместо этого используйте pbTables
• pbFiles для вывода файлов.
• pbResources – для вывода ресурсов.
• pbLang – для вывода языков.
• pbMenu – для вывода меню.
• pbMap – для вывода карты.
• pbRelationship – для вывода отношений.
• pbJson – для обработки JSON. Можно использовать как модификатор Fenom.

Вкладка Поля ресурса

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

$rows = $modx->getCollection(\pbTableValue::class, [
    'collection_id' => 1 // id коллекции
]);
foreach ($rows as $row) {
    $row->set('collection_id', 0);
    $row->set('field_id', 70); // заменяем на нужный id поля
    $row->set('field_name', 'products'); // заменяем на имя поля
    $row->save();
}

Builders

Поддержка UTM-меток

public static function getUTM(): array
{
    return [
        UTM::make('test')->label('Test')->params('utm_param=test&utm_email=1'),
        UTM::make('test2')->label('Test2')->params('utm_param=test&utm_email=2'),
    ];
}

Конструктор панелей

public static function getPanels(): array
{
    return [
        Panel::make('Comments')
            ->position(0) // Пусть это будет самая первая панель
            ->collapsible() // Панель можно свернуть
            ->fields([
                Field::make('Comments')
                    ->type('table')
                    ->fields([
                        Field::make('Author')->required(),
                        Field::make('Comment')->type('textarea')->required(),
                    ])
                    ->columns([
                        Column::make('Author'),
                        Column::make('Comment'),
                    ]),
            ])
    ];
}

Добавлена поддержка разрешений доступа к блокам, панелям, вкладкам и полям.

Block::make('Slider')
    ->permissions([
        'resource' => '1,2,3', // Доступно для ресурсов с ID 1, 2 или 3
        'template' => '1,2', // Доступно для шаблонов с ID 1 или 2
        'parent' => '2,3' // Доступно для ресурсов, у которых родитель с ID 2 или 3
    ]);

Группировка столбцов в таблице и renderIf

->columns([
    Column::make('Background')
        ->render('color'),
    Column::make('Color')
        ->width(100)
        ->render('color'),
    Column::make('Title')
])

->columns([
    Column::make('Colors')
        ->group([
            Column::make('Background')
                ->render('color')
                ->withLabel(), // Автоматический заголовок
            Column::make('Color')
                ->render('color')
                ->withLabel('Color text'), // Кастомный заголовок
        ]),
    Column::make('Title')
        ->label('Title / Image')
        // Добавляем условие для колонки
        ->renderIf([
            Column::make('Title'),
            Column::make('Image')->render('image'),
        ])
        ->default('---') // Если нечего отображать, используем значение по умолчанию
])

• Проверяет поочерёдно указанные столбцы.
• Если Title существует — отображает его.
• Если Title пустой, но есть Image — отображает изображение.
• Если оба пустые — показывает default('---').

Роутинг

Необязательные параметры

Route::get('/{alias?}', [ResourceController::class, 'index']);

• / — главная страница
• /some-alias — страница с указанным алиасом

public $classKey = \modResource::class;
public function index(string $alias = '', array $request = [])
{
    $where = [
        'published' => 1,
        'deleted' => 0,
    ];
    if (empty($alias)) {
        $where['id'] = $this->modx->getOption('site_start', null, 1, 1);
    } else {
        $where['alias'] = $alias;
    }

    if (!$resource = $this->modx->getObject($this->classKey, $where)) {
        abort(404, 'Resource not found.');
    }

    $this->modx->resource = $resource;
    
    return response()->view('templates/base');
}

Ограничения регулярных выражений

Route::get('/{context}/{alias?}', [ResourceController::class, 'context']);

Route::get('/{context}/{alias?}', [ResourceController::class, 'context'])
    ->where('context', '[a-z]{2}');

• /en/
• /en/some-alias

Мультиязычность

1. Включить системную настройку pageblocks_context_aware.
2. В настройке pageblocks_contexts указать нужные языки.

[{"key":"web","value":"Russian"}, {"key":"en","value":"English"}]

<ul class="navbar-nav ms-auto d-flex align-items-center list-unstyled mb-0">
{'!pbLang' | snippet: [
    'tpl' => '@INLINE <li class="nav-item"><a class="nav-link {$activeCls}" lang="{$key}" href="{$url}">{$value}</a></li>'
    'showCurrent' => 1
]}
</ul>