Skip to content

Что где лежит ​

Три вопроса, которые легко спутать друг с другом, и ответ на все три — здесь: что обязан дать PageBlocks, что лежит внутри pbShop и что приезжает отдельным бесплатным пакетом.

PageBlocks обязателен ​

pbShop — не самостоятельное приложение. Без установленного PageBlocks он пишет ошибку в лог и выключается; урезанного режима нет. Таблицы и конструктор полей, маршрутизация, контроллеры, файловые шаблоны, миграции, шаблонизатор, почтовый слой, уменьшение картинок через Glide и хранилище файлов — всё оттуда.

Зависимость объявлена в пакете, и установщик её держит:

php        >= 8.2
MODX       >= 3.0.0
PageBlocks >= 3.0

Сначала PageBlocks, и именно пакетом

Проверка зависимостей ищет установленный транспортный пакет. PageBlocks, разложенный по каталогам руками, её не пройдёт, сколько бы файлов ни лежало на диске: оба продукта ставят пакетами.

Порядок важен и в другую сторону. Поставьте pbShop на PageBlocks старее, чем он ждёт, — и витрина ответит пятисотой, а менеджер останется живым, то есть всё будет выглядеть как «магазин в порядке, сломан сайт». Это не умозрительно: 03.10.2026 установка на стенде дала ровно это — Trait ResolvesGuest not found на витрине при работающем менеджере. Сначала новый PageBlocks, потом магазин.

Предрелизная версия не мешает: pageblocks-3.0.0-alfa7 режется по дефису, в сравнение попадает 3.0.0, а alfa7 до него не доходит.

Одной функции мало минимума ​

Галерея товара — это поле galleryfield в конструкторе продукта, а картинки лежат в pb_files самого PageBlocks. Своей таблицы под них у магазина нет — см. Каталог. Два следствия, которые лучше прочитать, чем обнаружить:

  • galleryfield — платный тип поля PageBlocks. На бесплатной редакции поле в форме не нарисуется, и загружать будет некуда. Это осознанный выбор: своя галерея означала бы второй механизм хранения файлов на том же сайте.
  • Витрина к этому готова: при пустой галерее шаблон печатает одиночную картинку ровно как до появления поля.
  • Само поле приехало с PageBlocks alfa36 — этот выпуск и вышел, чтобы его оживить. На платформе старше галерее негде жить.

Что в самом магазине ​

Всё, что является функцией магазина, а не чужим API: каталог, варианты и опции, корзина, оформление, заказы и подписки, склад, цены на валюту, промокоды, слой документов, гриды менеджера, события и слои драйверов оплаты, доставки и касс — с теми драйверами, что перечислены ниже.

Что приезжает бесплатным пакетом ​

Пакетов два, оба бесплатные, и правило, по которому в них попадают, — одна фраза: домашний рынок получает всё, другие регионы — по две, непроверяемое уезжает в пакет.

ПакетЧто внутри
pbShopPayЮKassa, Т‑Банк (Тинькофф), CloudPayments, ЮMoney, PayAnyWay
pbShopShipСДЭК, Почта России

То есть ЮKassa есть — просто не в коробке

Ровно ради этого вопроса страница и написана. Пять российских шлюзов уехали 16.10.2026, и причина не в качестве кода: четыре из пяти написаны и покрыты тестами. Причина в том, что живого шлюза они не увидят никогда — российского мерчант-аккаунта с нашей стороны не будет по решению владельца. Раньше это был долг, который однажды закроется; для этих пяти это постоянное состояние.

Непроверяемый код в платном ядре — гарантия, которую мы не можем дать. Тот же код в бесплатном пакете с честной табличкой статуса — нормальная best-effort поставка с выставленными заранее ожиданиями. Второй довод обычный: ЮKassa меняет API по своему расписанию, и в ядре каждая такая правка была бы релизом всего магазина для того, кому она не нужна.

Пакет регистрирует свои драйверы из своего bootstrap.php, который MODX исполняет сам. Ядро о них не знает ничего — ни класса, ни ключа. Своих таблиц ни один из двух не несёт: способ оплаты и способ доставки — сущности ядра, а драйвер лишь обслуживает их.

Удаление пакета строки способов не удаляет, а гасит. Удалить — значит потерять вписанные ключи мерчанта; оставить включёнными — значит отдать покупателю Unknown payment driver на оформлении.

Документация этих двух пакетов — своя; этот сайт про ядро.

Что уехало вниз в PageBlocks ​

  • Избранное — это pbFavorites. В магазине остался 90-строчный поставщик товара для него, и больше ничего. Зависимость мягкая: нет pbFavorites — сердечко просто не печатается.
  • Вход и регистрация — это pbAuth либо сам сайт. Магазин печатает «Войти» / «Кабинет» / «Выйти» в шапке витрины, беря адрес из настроек, а если их нет — из именованных маршрутов pbAuth. Нет ни того ни другого — ссылки не будет вовсе: «Войти», ведущий на 404, хуже, чем его отсутствие.
  • Отзывы и рейтинг — не наши и здесь их нет. Им место в компоненте уровня PageBlocks: они нужны и блогу.

Честный статус драйверов ​

Драйвер в коробке — это обещание его чинить. Это не обещание, что через него хоть раз прошли деньги или посылка с нашей стороны, и подмена одного другим — это как раз способ получить тикет. Поэтому с той же легендой, что у внутренней описи:

  • ✅ — пройдено руками на живом контрагенте;
  • 🟢 — код есть, протокол написан по документации; живой службы мы не видели.

🟢 здесь — нормальное состояние, и это не оправдание

Боевого договора у нас нет ни с одной службой доставки, с кассой тоже, а из платёжных шлюзов настоящий платёж за спиной стоит ровно у одного. Договор с перевозчиком не заключают ради проверки драйвера, а песочницу ОФД без договора не выдают.

Что 🟢 всё-таки значит: подпись, формат запроса и разбор колбэка написаны по собственным эталонным материалам шлюза и покрыты тестом, а не пересказом документации. Чего не значит: что первая живая операция пройдёт. Заложите свой пробный платёж до открытия магазина.

Платёжные драйверы ядра ​

КлючШлюзСостояниеРекуррент
manualофлайн, подтверждает менеджер✅—
billсчёт юрлицу, PDF✅—
maibmaib (Молдова)✅ единственный с настоящим платежом за спиной; подпись покрыта тестом✅
liqpayLiqPay / ПриватБанк🟢 подпись сверена с эталоном из их SDK⛔ намеренно, расписание у шлюза
monobankMonobank Acquiring🟢 колбэк подписан ECDSA, смена ключа покрыта✅ токен карты
wayforpayWayForPay🟢 HMAC‑MD5; тест держит порядок полей — на нём подпись и ломается✅
fondyFondy🟢 эталон настоящий — документация печатает и склейку, и хеш✅
portmonePortmone🟢 уведомление не подписано вовсе; вердикт берётся повторным чтением⛔ намеренно
stripeStripe🟢 Checkout Session; «complete ≠ оплачено» покрыто✅
paypalPayPal🟢 Orders v2, оплата в два шага⛔ нужен vault и отдельное согласие

Пять из десяти умеют повторное списание — на них и держатся подписки, см. Подписки и крон.

Драйверы доставки в ядре ​

КлючСлужбаСостояние
—тариф таблицей: цена на валюту, пороги по весу, бесплатно от суммы✅ покрывает самовывоз и курьера, API не нужен
novaposhtaНова Пошта🟢 расчёт, справочник отделений, ТТН и трекинг
ukrposhtaУкрпошта🟢 расчёт, классификатор адресов, ТТН и трекинг

ТТН выписывают оба. Что именно обещает ✅ в первой строке и чего не обещает: способности магазина — слой драйверов, реестр, выбор пункта выдачи, снимок заказа, откат на таблицу — проходятся руками без живого перевозчика. А 🟢 у двух драйверов — это про договоры, и их у нас нет.

Кассы ​

КлючКассаСостояние
atolАТОЛ Онлайн v4 (54‑ФЗ, Россия)🟢 выписано из рабочего клиента АТОЛа, а не из пересказа
checkboxCheckbox (ПРРО, Украина)🟢 аккаунта ПРРО у нас нет

См. Чеки.

Дальше ​

pbShop — магазин для сайтов на PageBlocks