pbStudio: Чистый контроллер или FetchIt — два способа обработки форм

• pbStudio: Создаём сайт с PageBlocks – настройка и главная страница
• pbStudio: Меню и страница «О нас»
• pbStudio: Чистый контроллер или FetchIt — два способа обработки форм
• pbStudio: Портфолио, Услуги и Контакты
• pbStudio: Подключаем мультиязычность

1. Обработка формы через чистый контроллер

use PageBlocks\App\Http\Controllers\FormController;

Route::post('/form/submit', [FormController::class, 'handle']);

<?php

namespace PageBlocks\App\Http\Controllers;

use Boshnik\PageBlocks\Facades\Request;
use Boshnik\PageBlocks\Support\Mail;

class FormController extends Controller
{
    public function handle(Request $request)
    {
        // Валидация формы
        $validated = $request->validate([
            'honeypot' => 'empty', // антиспам: поле должно быть пустым
            'formname' => 'required|string',
            'name' => 'required|string|max:255',
            'email' => 'required|email',
            'file' => 'required|file|mimes:pdf,doc,docx,jpg|min:100|max:2048',
            'message' => 'nullable|string', // необязательное текстовое поле
        ]);

        // Сохраняем файл в папку assets/images/files
        $validated['file'] = $request->file('file')->store('assets/images/files');

        // Добавим IP
        $validated['ip'] = $request->ip();

        // Сохраняем форму в таблицу значений
        $form = $this->modx->newObject(\pbTableValue::class, [
            'model_type' => 'pbMenu', // Тип модели
            // 'model_type' => 'MODX\Revolution\modDocument', Если таблица на странице ресурса
            // 'model_type' => 'MODX\Revolution\modUser', Если таблица на странице пользователя
            'field_name' => 'forms', // Имя поля таблицы
            'createdon' => time(),
            'values' => json_encode($validated), // Сериализованные данные формы
        ]);

        if (!$form->save()) {
            $this->modx->log(modX::LOG_LEVEL_ERROR, 'Не удалось сохранить форму: ' . print_r($validated, true));
        }

        // Отправка письма менеджеру
        Mail::to('pageblocks@boshnik.com')
            ->subject('Отправка резюме')
            ->view('chunks/email/manager', $validated)
            ->attach($validated['file'])
            ->send();

        // Отправка письма пользователю
        Mail::send($validated['email'], 'Ваше резюме принято', 'Мы скоро с вами свяжемся!');
        // или через хелпер:
        // mail($validated['email'], 'Ваше резюме принято', 'Мы скоро с вами свяжемся!');

        // Если запрос был через AJAX — возвращаем JSON
        if ($request->expectsJson()) {
            return response()->json([
                'success' => true,
                'message' => 'Форма успешно отправлена',
                // 'redirect' => '/contacts', Если нужен редирект
            ]);
        }

        // В противном случае — редирект
        return response()->redirect('/contacts');
    }
}

Menu::make('Forms')
    ->title('Формы')
    ->description('Сохраненные формы')
    ->fields([
        // Создаем таблицу с именем forms
        Field::make('Forms')
            ->type('table')
            ->fields([
                
                Field::make('formname')
                    ->type('hidden'),
                
                Field::make('createdon')
                    ->label('Date')
                    ->type('date')
                    ->width(50)
                    ->storage('timestamp')
                    ->dateFormat('Y-m-d, H:i')
                    ->readOnly(),
                
                Field::make('IP')
                    ->width(50)
                    ->readOnly(),
                
                Field::make('Name'),
                
                Field::make('Email'),
                
                Field::make('Message')
                    ->type('textarea')
                    ->height(50),
                
                Field::make('File')->type('file'),
            ])
            // Показываем колонки
            ->columns([
                Column::make('Name'),
                Column::make('Email'),
                Column::make('Createdon')
                    ->render('date')
                    ->format('Y-m-d, H:i'),
                Column::make('Editedon')
                    ->render('date')
                    ->format('Y-m-d, H:i'),
                Column::make('IP')
            ])
            // Добавляем фильтры
            ->filters([
                Filter::make('formName')
                    ->label('Form name')
                    ->type('select')
                    ->options([
                        'Job' => 'Job',
                    ]),
                Filter::make('createdon')
                    ->label('Date'),
            ]),
    ])

<ul>
    <li><b>Name</b>: {$name}</li>
    <li><b>Email</b>: {$email}</li>
    {if $message}
        <li><b>Message</b>: {$message}</li>
    {/if}
</ul>

{*Form*}
<script src="/assets/components/pageblocks/js/web/pageblocks.js" defer></script>

{*SweetAlert2*}
<script src="https://cdn.jsdelivr.net/npm/sweetalert2@11" defer></script>

<script>
    document.addEventListener('DOMContentLoaded', () => {
        PageBlocks.Message = {
            success(message) {
                Swal.fire({
                    position: 'top-end',
                    title: message,
                    showConfirmButton: false,
                    timer: 1500
                });
            },
            error(message) {
                Swal.fire({
                    position: 'top-end',
                    title: message,
                    showConfirmButton: false,
                    timer: 1500
                });
            }
        };
        // Close modal
        document.addEventListener('pageblocks:success', (e) => {
            const modal = e.detail.form.closest('.modal');
            if (modal) {
                bootstrap.Modal.getInstance(modal)?.hide();
            }
        });
    });
</script>

<input type="hidden" name="_token" value="{csrf_token}">

2. Обработка формы через FetchIt

{*FetchIt*}
 <script src="/assets/components/fetchit/js/fetchit.min.js"></script>
 <script async src="/assets/components/fetchit/lib/notyf.min.js"></script>

{*Notyf*}
 <link rel="preload" href="/assets/components/fetchit/lib/notyf.min.css" as="style" onload="this.onload=null;this.rel='stylesheet'">
 <noscript><link rel="stylesheet" href="/assets/components/fetchit/lib/notyf.min.css"></noscript>

use PageBlocks\App\Http\Controllers\FetchItController;

Route::post('/assets/components/fetchit/action.php', [FetchItController::class, 'action']);

<?php

namespace PageBlocks\App\Http\Controllers;

class FetchItController extends Controller
{
    public function action()
    {
        $FetchIt = $this->modx->services->get('FetchIt');
        if (!isset($_POST)) {
            $site_start = $this->modx->makeUrl($this->modx->getOption('site_start'), '', '', 'full');
            redirect($site_start);
        } elseif (empty($_SERVER['HTTP_X_FETCHIT_ACTION'])) {
            return $FetchIt->error('fetchit_err_action_ns');
        } else {
            return $FetchIt->process($_SERVER['HTTP_X_FETCHIT_ACTION'], array_merge($_FILES, $_REQUEST));
        }
    }
}

<div class="modal fade" id="jobModal" tabindex="-1" aria-hidden="true">
     <div class="modal-dialog modal-dialog-centered">
         <div class="modal-content">
             <div class="modal-header">
                 <h1 class="modal-title fs-5">Присоединяйся к команде PageBlocks</h1>
                 <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
             </div>
             {'!FetchIt' | snippet : [
                 'snippet' => 'FormIt',
                 'form' => 'jobForm',
                 'hooks' => 'FormItSaveForm,email',
 
                 'emailTpl' => 'jobEmail',
                 'emailSubject' => 'Тема письма',
                 'emailTo' => 'Superboshnik@gmail.com',
 
                 'formName' => 'Job',
                 'formFields' => 'name,email,message',
                 'fieldNames' => 'name==Name,email==Email,message==Message',
 
                 'validate' => 'name:required,email:required,file:required',
                 'validationErrorMessage' => 'В форме содержатся ошибки!',
                 'successMessage' => 'Сообщение успешно отправлено',
             ]}
         </div>
     </div>
 </div>

Заключение:

• Собственный контроллер — максимум гибкости, отправка писем, валидация, сохранение файлов и данных в таблицу PageBlocks.
• FetchIt + FormIt — быстро и просто, если нужно использовать уже знакомые компоненты.