Что где лежит
Три вопроса, которые легко спутать друг с другом, и ответ на все три — здесь: что обязан дать 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 | ✅ | — |
maib | maib (Молдова) | ✅ единственный с настоящим платежом за спиной; подпись покрыта тестом | ✅ |
liqpay | LiqPay / ПриватБанк | 🟢 подпись сверена с эталоном из их SDK | ⛔ намеренно, расписание у шлюза |
monobank | Monobank Acquiring | 🟢 колбэк подписан ECDSA, смена ключа покрыта | ✅ токен карты |
wayforpay | WayForPay | 🟢 HMAC‑MD5; тест держит порядок полей — на нём подпись и ломается | ✅ |
fondy | Fondy | 🟢 эталон настоящий — документация печатает и склейку, и хеш | ✅ |
portmone | Portmone | 🟢 уведомление не подписано вовсе; вердикт берётся повторным чтением | ⛔ намеренно |
stripe | Stripe | 🟢 Checkout Session; «complete ≠ оплачено» покрыто | ✅ |
paypal | PayPal | 🟢 Orders v2, оплата в два шага | ⛔ нужен vault и отдельное согласие |
Пять из десяти умеют повторное списание — на них и держатся подписки, см. Подписки и крон.
Драйверы доставки в ядре
| Ключ | Служба | Состояние |
|---|---|---|
| — | тариф таблицей: цена на валюту, пороги по весу, бесплатно от суммы | ✅ покрывает самовывоз и курьера, API не нужен |
novaposhta | Нова Пошта | 🟢 расчёт, справочник отделений, ТТН и трекинг |
ukrposhta | Укрпошта | 🟢 расчёт, классификатор адресов, ТТН и трекинг |
ТТН выписывают оба. Что именно обещает ✅ в первой строке и чего не обещает: способности магазина — слой драйверов, реестр, выбор пункта выдачи, снимок заказа, откат на таблицу — проходятся руками без живого перевозчика. А 🟢 у двух драйверов — это про договоры, и их у нас нет.
Кассы
| Ключ | Касса | Состояние |
|---|---|---|
atol | АТОЛ Онлайн v4 (54‑ФЗ, Россия) | 🟢 выписано из рабочего клиента АТОЛа, а не из пересказа |
checkbox | Checkbox (ПРРО, Украина) | 🟢 аккаунта ПРРО у нас нет |
См. Чеки.
Дальше
- Настройки — все системные настройки с умолчаниями
- Подписки и крон — самое дорогое умолчание магазина