PageBlocks 2.3.0

pbResource

• Максимальная гибкость: Возможность добавлять любые поля для ресурсов. Больше никаких TV полей.
• Удобство управления: Ресурсы отображаются в специально созданной таблице, что упрощает их редактирование и исключает избыточность в стандартном дереве.
• Фильтрация и кастомизация: Полный контроль над отображением и управлением данными с помощью кастомных таблиц и фильтров.

Relationship Field

• One to One — Один к одному
• One to Many — Один ко многим
• Many to One — Многие к одному
• Many to Many — Многие ко многим

[[!pbRelationship? 
    &relation_type=`one_to_one`       // Тип отношения
    &primary_table=`pbTable`          // Основная таблица: pbTable или pbResources
    &primary_id=`1`                   // ID основной записи
    &tpl=`relation`                   // Чанк для вывода результатов. Доступны все поля связанного объекта
]]

Dependent Field

• Для холодильников: объём, количество камер, класс энергопотребления.
• Для телефонов: диагональ экрана, объём оперативной памяти, поддержка 5G.

Imask Field

{
    mask: '+{38} (000) 000-00-00'
}

{
    mask: Date,
    pattern: 'd{.}`m{.}`Y',
    blocks: {
        d: { mask: IMask.MaskedRange, from: 1, to: 31 },
        m: { mask: IMask.MaskedRange, from: 1, to: 12 },
        Y: { mask: IMask.MaskedRange, from: 1900, to: 2099 }
    }
}

{
    mask: Number,
    thousandsSeparator: ' ',
    radix: ',',
    scale: 2
}

{
    mask: '0000 0000 0000 0000'
}

Map Field

{'!pbMap' | snippet: [
    'markers' => $map_coords,  // координаты карты
    'options' => $map_options  // опции карты
]}

Gallery Field

{"webp":{"w":120,"h":90,"q":90,"zc":"1","bg":"000000","f":"webp"}}

Другие поля

• TableMultiCombo Field
• MultiCombo Field
• Currency Field
• Heading Field
• Tag Field
• KeyValue Field (улучшенно)

Routing

• Маршруты: App/routes
• Контроллеры: App/Http/Controllers
• Мидлвары: App/Http/Middleware
• Шаблоны для Fenom: App/elements
• Модификаторы для Fenom: App/Helpers/modifiers.php

Примеры маршрутов:

Route::get('/hello', function () { 
    return 'Hello World';
});

Route::get('/resource', [ResourceController::class, 'index']);
Route::get('/resource/{id}', 'ResourceController@show');

Пример контроллера

namespace PageBlocks\App\Http\Controllers;

class ResourceController extends Controller
{
    public $classKey = \modResource::class;

    public function index(string $key, array $request)
    {
        $resources = $this->modx->getIterator($this->classKey, [
            'context_key' => $key,
            'published' => 1,
        ]);
        return $resources;
    }

    public function show($key, $id, array $request)
    {
        return $this->modx->getObject($this->classKey, $id);
    }
}

Response

public function view($id, array $request)
{
    $resource = $this->modx->getObject($this->classKey, $id);
    $data = ['resource' => $resource];

    return response()->view('templates/index', $data);
}

text($text, int $status = 200, array $headers = [])

• $text — текст ответа.
• $status — HTTP-статус (по умолчанию 200).
• $headers — дополнительные заголовки.

return response()->text('Hello World', 200, ['Content-Type' => 'text/plain']);
// или тоже самое:
return response()->text('Hello World');

json(array $data, int $status = 200, array $headers = [])

• $data — массив данных для преобразования.
• $status — HTTP-статус (по умолчанию 200).
• $headers — дополнительные заголовки.

return response()->json(['message' => 'Success']);

view(string $template, array $data = [])

• $template — путь к шаблону, который должен находиться в папке App/elements.
• $data — массив данных, передаваемых в шаблон.

return response()->view('templates/resource', ['title' => 'My Resource']);

redirect(string $url, int $status = 302, array $headers = [])

• $url — адрес для редиректа.
• $status — HTTP-статус (по умолчанию 302).
• $headers — дополнительные заголовки.

return response()->redirect('/new-url', 301);

download(string $file, string $name = null, array $headers = [])

• $file — путь к файлу, от корня сайта.
• $name — имя файла для загрузки (необязательно).
• $headers — дополнительные заголовки.

return response()->download('path/to/file.zip', 'myfile.zip');

Без контроллера:

Route::redirect('/here', '/there');

Route::get('/', function () {
    return view('templates/welcome');
});
// или еще короче
Route::view('/', 'templates/welcome');

Route::get('/', function () {
    return view('templates/welcome');
})->name('welcome');

// теперь мы можем сделать редирект по названию маршрута
Route::get('/wel_come', function () {
    return redirect()->route('welcome');
});

Примеры роутов:

use Boshnik\PageBlocks\Routing\Route;
use PageBlocks\App\Http\Controllers\ConfigController;
use PageBlocks\App\Http\Controllers\ContextController;
use PageBlocks\App\Http\Controllers\ResourceController;

Route::prefix('api')->middleware(['Authenticate'])->group(function () {

    Route::get('/context/', [ContextController::class, 'index']);
    Route::get('/config/', [ConfigController::class, 'index']);

    Route::prefix('{key}')->group(function () {
        Route::get('/menu', [ResourceController::class, 'menu']);

        Route::get('/resource', [ResourceController::class, 'index']);
        Route::get('/resource/{id}', [ResourceController::class, 'show']);
    });
});

1. Контроллер ContextController:
• /api/context/
2. Контроллер ConfigController:
• /api/config/
3. Контроллер ResourceController:
• /api/{key}/menu
• /api/{key}/resource
• /api/{key}/resource/{id}

Route::get('/route/list', function () {
    return Route::getRoutes();
});

Интеграция, вдохновленная Laravel

Ключевые преимущества PageBlocks:

• Отказ от избыточности TV: Забудьте о множестве TV-полей, засоряющих интерфейс и усложняющих структуру. PageBlocks позволяет создавать собственные поля с любыми необходимыми настройками.

• Гибкость и настраиваемость: Вы сами определяете структуру данных, создавая таблицы с необходимыми полями и устанавливая связи между ними.

• Улучшенный интерфейс: Управление данными становится удобнее благодаря табличному представлению, фильтрации и динамическому отображению полей.

• Расширенные возможности ввода: Imask Field, Dependent Field и другие типы полей делают ввод данных более удобным и интуитивным для контент-менеджеров.

• Интеграция с внешними сервисами: Map Field позволяет легко интегрировать карты, а галерея с генерацией превьюшек упрощает управление изображениями.

• Разработка API: Благодаря системе роутинга, создание RESTful API становится простым и интуитивно понятным процессом. Синтаксис, вдохновленный Laravel, позволяет с легкостью применять готовые решения и ускорить разработку.

• Постоянное развитие: Компонент активно развивается и пополняется новыми функциями и возможностями.

Поддержка:

• MODX: 2 / 3
• PHP: ^7.4
• Поля: 37 разнообразных полей