PageBlocks 2.6.0. Настройка меню MODX и гибкое управление страницей пользователя

Создание пользовательских пунктов меню в MODX

Инструкция по созданию

1. Перейдите в меню компонента
2. Откройте вкладку «Таблицы»
3. Создайте новую таблицу и добавьте необходимые поля:

4. Добавьте колонки для отображения данных:

public function getMenu(): array
{
    return [
        // ... существующие пункты меню ...
        
        Menu::make('reviews')
            ->title('Отзывы')
            ->description('Список отзывов')
            ->icon('fa-star')
            ->position(1)
            ->parent('components') // Размещаем в разделе компонентов
            ->fields([
                // Добавляем поле с типом "таблица"
                Field::make('reviews')
                    ->label('Отзывы')
                    ->type('table')
                    // Поля таблицы
                    ->fields([
                        Field::make('name')
                            ->label('Имя')
                            ->required(),
                        
                        Field::make('message')
                            ->label('Отзыв')
                            ->type('textarea')
                            ->required(),
                        
                        Field::make('date')
                            ->label('Дата')
                            ->type('date')
                            ->storage('timestamp') // чтобы сохранялась дата в секундах
                            ->dateFormat('Y-m-d, H:i')
                            ->required()
                            ->default(time()),
                    ])
                    // настройка колонок
                    ->columns([
                        Column::make('name')
                            ->label('Имя')
                            ->width(150),
                        
                        Column::make('message')
                            ->label('Отзыв'),
                        
                        Column::make('date')
                            ->label('Дата')
                            ->width(150)
                            ->render('date'),
                    ])
                    // Добавляем поиск
                    ->searchable()
            ]),
            
        // ... другие пункты меню ...
    ];
}

{'!pbTables'|snippet: [
    'modelType' => 'pbMenu', 
    'field_name' => 'reviews', // имя поля таблицы
    'tpl' => '@INLINE <figure class="text-center border pt-3">
              <blockquote class="blockquote">
                <p>{$message}</p>
              </blockquote>
              <figcaption class="blockquote-footer">
                {$name}
                {$date|date:"d-m-Y"}
              </figcaption>
            </figure>'
]}

Расширенные возможности: несколько таблиц во вкладках

Menu::make('feedback')
    ->title('Обратная связь')
    ->icon('fa-comments')
    ->parent('components')
    ->tabs([
        // Первая вкладка с отзывами
        Tab::make('Отзывы')
            ->fields([
                Field::make('reviews_table')
                    ->label('Список отзывов')
                    ->type('table')
                    ->fields([
                        Field::make('name')->label('Имя')->required(),
                        Field::make('message')->label('Текст')->type('textarea'),
                        Field::make('rating')->label('Оценка')->type('number')
                    ])
                    ->columns([
                        Column::make('name')->width(150),
                        Column::make('message'),
                        Column::make('rating')->width(80)
                    ])
            ]),
            
        // Вторая вкладка с заявками
        Tab::make('Заявки')
            ->fields([
                Field::make('requests_table')
                    ->label('Заявки с формы')
                    ->type('table')
                    ->fields([
                        Field::make('phone')->label('Телефон')->required(),
                        Field::make('email')->label('Email'),
                        Field::make('created')->label('Дата')->type('date')
                    ])
                    ->columns([
                        Column::make('phone')->width(150),
                        Column::make('email'),
                        Column::make('created')->width(120)
                    ])
            ])
    ]);

• Используем метод ->tabs() для создания вкладок
• Каждая вкладка (Tab::make()) содержит свою таблицу
• Таблицы полностью независимы друг от друга
• Можно настраивать разные наборы полей и колонок для каждой таблицы
• Количество вкладок не ограничено

Расширение профиля пользователя

1. Блоки

Режим менеджера

• pageblocks_hide_users — список ID пользователей, для которых скрывается вкладка
• pageblocks_hide_user_groups — список групп пользователей, для которых скрывается вкладка
• pageblocks_tab_index — позиция вкладки (по умолчанию 0 — первая позиция)

Режим разработки

public static function getBlocks(): array
{
    return [
        Field::make('Образование') // Автоматическое имя чанка - 'obrazovanie'
            ->chunk('education') // Явное указание имени чанка
            ->fields([
                Field::make('university')
                    ->label('Университет')
                    ->required(),
                
                Field::make('degree')
                    ->label('Степень')
                    ->required(),
                
                Field::make('date_start')
                    ->label('Дата начала обучения')
                    ->type('date')
                    ->width(50)
                    ->required(),
                
                Field::make('date_end')
                    ->label('Дата окончания обучения')
                    ->type('date')
                    ->width(50)
                    ->required(),
            ])
    ];
}

Вывод блоков на фронтенде

{'!pbBlocks'|snippet: [
    'modelType' => 'MODX\Revolution\modUser', // Для MODX2 указываем "modUser"
    'user_id' => $modx->user->id, // ID пользователя
    'fileElements' => 1, // Включение обработки файловых чанков
]}

2. Вкладки

Режим менеджера

• Перейдите на вкладку «Поля пользователя»
• Добавьте новую вкладку с нужными полями

Режим разработки

public static function getTabs(): array
{
    return [
        Tab::make('Профессиональная информация')
            ->fields([
                Field::make('position')
                    ->label('Должность')
                    ->width(40),

                Field::make('skills')
                    ->label('Навыки')
                    ->type('tag')
                    ->width(40)
                    ->options(['PHP', 'JavaScript', 'Дизайн', 'Маркетинг']),

                Field::make('experience')
                    ->label('Опыт работы (лет)')
                    ->type('number')
                    ->width(20)
                    ->min(0)
                    ->max(50)
            ])
    ];
}

Вывод полей на фронтенде

// Вывод skills текущего пользователя
{$modx->user->skills} 

//  Вывод skills определенного пользователя
{1|user:'skills'}

3. Панели

Режим менеджера

Режим разработки

public static function getPanels(): array
{
    return [
        Panel::make('Социальные сети')
            ->position(0)
            ->fields([
                Field::make('telegram')
                    ->label('Telegram')
                    ->prefix('@'),

                Field::make('github')
                    ->label('GitHub')
                    ->prefix('https://github.com/')
                    ->placeholder('username'),

                Field::make('portfolio')
                    ->label('Портфолио')
                    ->placeholder('URL'),
            ])
    ];
}

Заключение