🚀 PageBlocks 2.8.0 — большой шаг вперёд

Что такое pbQuery?

• Компактный код:
  

  $rows = query(modResource::class)
        ->where(['id:BETWEEN' => [10, 20]])
        ->fetchAll();

  Всё понятно сразу: выбираем ресурсы с id от 10 до 20.
• Дополнительные операторы: поддержка BETWEEN, FIND_IN_SET, сортировки в порядке указанных ID.
• JSON-поля: можно не только читать, но и сортировать по данным внутри JSON.
• Union: легко объединять выборки, например ресурсы из разных шаблонов.
• Модификация данных: методы create, insert, updateOrCreate упрощают работу с моделями.
• Шаблоны вместо сниппетов: вывод данных можно сразу рендерить через tpl(), tplWrapper().
• Кеширование: встроенное кеширование запросов ускоряет работу сайтов с высокой нагрузкой.

Примеры:

1. Работа с JSON-полями и сортировка по ним

$rows = query(modResource::class)
    ->select('id, pagetitle, properties->seosuite->uri as seouri')
    ->fetchAll();

// или сортировка по JSON-полю values->price
$rows = query(modResource::class)
    ->orderBy('price', 'DESC') // подразумевается values->price
    ->get();

2. Подзапросы (subqueries) — удобно и читабельно

$resources = query(modResource::class)
    ->alias('resource')
    ->select('id, pagetitle')
    ->select(['children_count' => function ($q) {
        $q->selectRaw('COUNT(*)')
          ->whereColumn(['parent' => 'resource.id']);
    }])
    ->fetchAll();

SELECT `resource`.`id`, `resource`.`pagetitle`, (
    SELECT COUNT(*) 
    FROM `modx_site_content` AS `modResource` 
    WHERE `modResource`.`parent` = `resource`.`id` 
) as `children_count` 
FROM `modx_site_content` AS `resource`

$query = query(modResource::class)
    ->select('id, pagetitle')
    ->orderBy(function ($q) {
        $q->table(\modUser::class)
          ->select('createdon')
          ->whereColumn(['modUser.id' => 'modResource.createdby']);
    }, 'DESC')
    ->fetchAll();

SELECT `modResource`.`id`, `modResource`.`pagetitle` 
FROM `modx_site_content` AS `modResource` 
ORDER BY (
    SELECT `modUser`.`createdon` 
    FROM `modx_users` AS `modUser` 
    WHERE `modUser`.`id` = `modResource`.`createdby` 
) DESC

3. BETWEEN в where

$rows = query(modResource::class)
    ->where(['id:BETWEEN' => [10, 20]])
    ->fetchAll();

4. FIND_IN_SET без лишнего кода

$rows = query(modResource::class)
    ->where(['tags:FIND_IN_SET' => 42])
    ->fetchAll();

5. UNION — объединение запросов

query(modResource::class)
    ->select(['id', 'pagetitle'])
    ->where(['template' => 1])
    ->union(function ($query) {
        $query->table(modResource::class)
            ->select(['id', 'pagetitle'])
            ->where(['template' => 2]);
    })
    ->fetchAll();

(SELECT `modResource`.`id`, `modResource`.`pagetitle`
 FROM `modx_site_content` AS `modResource`
 WHERE `modResource`.`template` = 1)
UNION
(SELECT `modResource`.`id`, `modResource`.`pagetitle`
 FROM `modx_site_content` AS `modResource`
 WHERE `modResource`.`template` = 2)

6. Модификация данных — удобные методы (create/insert/update/firstOrCreate и т.д.)

// Создать объект через xPDO (будет newObject + save)
$created = query(modResource::class)->create([
    'pagetitle' => 'New Resource',
    'context_key' => 'web'
]);

// Быстрая вставка без xPDO-событий (insert via SQL)
query(modResource::class)->insert([
    'pagetitle' => 'Fast Resource',
    'context_key' => 'web'
]);

// firstOrCreate
$u = query(modUser::class)->firstOrCreate(['username' => 'john'], ['email' => 'john@example.com']);

7. Шаблонизация результатов: tpl(), render(), tplWrapper() — заменяет сниппеты

$output = query(modResource::class)
    ->where(['published' => 1])
    ->tpl('tpl.resource.row')        // шаблон на каждый элемент
    ->tplWrapper('tpl.resource.wrapper', 'list') // обёртка для списка
    ->render();                      // возвращает final HTML

8. Кеширование запросов (cache()) и отладка (debug())

// кеширование выборки на 10 минут
$resources = query(modResource::class)
    ->where(['template' => 5])
    ->cache(600) // lifetime = 600s
    ->fetchAll();

// отладка: покажет SQL, время и флаг кеша
$resources = query(modResource::class)
    ->where(['published' => 1])
    ->debug()
    ->fetchAll();

9. Использование в Fenom-шаблонах

{* Fenom template *}
{set $resCount = query('modResource')->where(['published' => 1])->count()}
<p>Всего опубликованных страниц: {$resCount}</p>

{foreach query('modResource')->where(['template' => 4])->orderBy('menuindex')->get() as $page}
  <a href="{$page->get('uri')}">{$page->get('pagetitle')}</a>
{/foreach}

10. Пагинация с pbQuery: серверная и AJAX

• Без JavaScript — стандартная серверная пагинация. При клике на ссылку с номером страницы страница перезагружается, а нужные данные подставляются автоматически.
• С JavaScript — динамическая подгрузка через AJAX с помощью скрипта pb.pagination. Это позволяет обновлять контент без полной перезагрузки страницы, улучшая UX на сайтах с большим количеством данных.

{set $users = query('modUser')
    ->where(['active' => 1])
    ->paginate(15)}

<ul>
    {foreach $users->items() as $user}
        <li>{$user.username}</li>
    {/foreach}
</ul>

<div class="pb-pagination" pb-pagination>
    {$users->links()}
</div>

• $users->items() — массив пользователей для текущей страницы
• $users->links() — HTML для навигации между страницами
• $pageName (по умолчанию 'page') — параметр в query string для текущей страницы, например /products?page=2

Route::get('users/items','UserController@index')->name('user.index');

class UserController extends Controller {
    public function index(Request $request)
    {
        $paginator = query('modUserProfile')
            ->alias('Profile')
            ->select('modUser.id,modUser.username,modUser.active')
            ->select('Profile.fullname,Profile.email,Profile.phone,Profile.country,Profile.city,Profile.lastlogin')
            ->leftJoin('modUser', 'modUser', 'Profile.internalKey = modUser.id')
            ->where(['modUser.active' => 1])
            ->when($request->query, function ($query, $search) {
                $query->where([
                    'modUser.username:LIKE' => "%$search%",
                    'OR:Profile.fullname:LIKE' => "%$search%",
                    'OR:Profile.email:LIKE' => "%$search%",
                ]);
            })
             ->when($request->country, function ($query, $country) {
                $query->where(['Profile.country' => $country]);
            })
            ->when($request->city, function ($query, $city) {
                $query->where(['Profile.city' => $city]);
            })
            ->orderBy('lastlogin', 'desc')
            ->paginate(21)
            ->route('user.index');

        return array_merge($paginator->toArray(), [
            'data' => pbQuery::tpl('file:chunks/user/item.tpl')->render($paginator->items()),
            'links' => $paginator->links(),
        ]);
    }
}

• route('user.index') указывает, куда отправлять AJAX-запрос при клике на номер страницы.
• Метод toArray() возвращает все данные пагинатора для JSON-ответа.
• pbQuery::tpl()->render() позволяет сразу отрендерить элементы через шаблон, а links() — генерирует ссылки на страницы.

class ResourceController extends Controller
{
    public function index(Request $request) {
        
        if ($this->modx->resource->id === 70) {
            // Подключаем наш контроллер пользователей
            $controller = new UserController($this->modx);
            // Получаем данные в виде массива
            $data = $controller->index($request);
        }

        return view('file:templates/base', [
            'data' => $data ?? [],
        ]);
    }
}

• Динамически подгружать данные через AJAX при использовании pb.pagination.
• Одновременно выводить данные на странице без JS, если требуется серверный рендеринг.
• Применять фильтры, поиск и сортировку напрямую через pbQuery, сохраняя код чистым и читаемым.

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

• Экономия времени — больше не нужно писать громоздкий xPDO-код
• Читаемость — цепочечный синтаксис делает код самодокументируемым
• Безопасность — автоматическое экранирование параметров
• Гибкость — поддержка сложных сценариев (JSON, подзапросы, UNION)
• Производительность — встроенное кеширование и оптимизированные запросы

Fenom (View) в PageBlocks — мощная, безопасная и быстрая шаблонизация

Структура файлов (куда складывать расширения Fenom)

App/
└── Helpers/
    └── fenom/
        ├── modifiers.php         ← Модификаторы
        ├── inline_tags.php       ← Псевдо-теги
        ├── block_tags.php        ← Блочные функции
        ├── data.php              ← Глобальные данные
        └── php_functions.php     ← Разрешённые PHP-функции

1. Модификаторы — короткие трансформации прямо в шаблоне

return [
    'upper' => function($value) {
        return mb_strtoupper($value);
    },
    'users' => function () {
        return query('modUser')
            ->alias('user')
            ->select('user.*,profile.*')
            ->where(['active' => 1])
            ->join('modUserProfile', 'profile', 'user.id = profile.internalKey')
            ->get();
    },
];

<h2>{$title|upper}</h2>

{foreach users() as $user}
    <li>{$user->email}</li>
{/foreach}

2. Псевдо-теги — компактные функции для HTML-фрагментов

return [
    'icon' => function($params) {
        $name = array_shift($params);
        $class = $params['class'] ?? '';
        return "<svg class='{$class}'><use xlink:href='#icon-{$name}'/></svg>";
    }
];

{icon 'user' class='avatar-lg'}
<button>{icon 'edit'} Редактировать</button>

3. Блочные функции — условные области с логикой доступа

return [
    'auth' => function($params, $content) {
        if ($this->modx->user->isAuthenticated()) return $content;
        return '';
    },
    'superadmin' => function($params, $content) {
        if ($this->modx->user->id === 1) return $content;
        return '';
    }
];

{auth}
  <a href="/profile">Мой профиль</a>
{/auth}

{superadmin}
  <div class="admin-only">Секретная панель</div>
{/superadmin}

4. Глобальные данные — общие настройки и константы в шаблонах

return [
  'package' => 'MyProject',
  'support_email' => 'support@site.example',
  'assets_url' => '/assets/'
];

<footer>© {$.pb.package} — <a href="mailto:{$.pb.support_email}">support</a></footer>
<img src="{$.pb.assets_url}logo.svg" alt="logo">

5. Разрешённые PHP-функции — безопасный набор и расширения

return [
  'mb_strlen',
  'htmlspecialchars',
  'lcfirst'
];

{$title|truncate:100} — {count($items)} элементов
{$safe = htmlspecialchars($raw_html)}

PageBlocks 3.0.0 — что готовится

1. Универсальные контроллеры вместо множества процессоров

• централизовать логику действий;
• уменьшить дублирование кода;
• упростить расширение функционала.

2. Кастомные таблицы и управление ими в админке

• добавление, редактирование и удаление записей через UI;
• интеграция с pbQuery для удобной работы с данными;
• возможность подключать кастомные модели под конкретные задачи.

3. Рефакторинг полей и новые типы данных

• упрощение работы с типами данных;
• добавление новых полей для гибкой настройки контента;
• улучшенная совместимость с Fenom-шаблонами и pbQuery.

4. Обновление сниппетов и переход на pbQuery

• лаконичные цепочки методов вместо сложного xPDO-кода;
• работа с JSON-полями и подзапросами;
• поддержка фильтров, сортировки и пагинации.