Настройки
Все системные настройки, которые ставит магазин, с умолчаниями. Живут в системных настройках MODX по областям, и у всех префикс pbshop_.
Обновление пакета настройки не перезаписывает
Поэтому описанное здесь умолчание — это то, что получает свежая установка. Магазин, работающий с более ранней версии, сохраняет то, что у него было, включая пустое значение, которое настройка носила до появления умолчания.
Основные
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_currency | EUR | валюта магазина по умолчанию. Товар без цены в ней печатается без цены, а это не то же, что ноль |
pbshop_currencies | EUR,USD,RUB | валюты, предлагаемые в переключателе |
pbshop_test_mode | включено | песочница платёжных шлюзов. У кассы свой рубильник |
pbshop_order_number | {year}/{seq:3} | шаблон номера заказа. {year} {yy} {month} {day} {seq}, ведущие нули как {seq:3}. Счётчик обнуляется в пределах того, что стоит до {seq} |
pbshop_return_url | / | куда шлюз возвращает покупателя |
pbshop_return_url_fail | пусто | прерванная оплата. Пусто — на pbshop_return_url |
pbshop_return_url_pending | пусто | платёж, ждущий подтверждения. Тот же откат |
pbshop_test_mode приезжает включённым
Это верное умолчание — эквайер, берущий настоящие деньги сразу после включения, был бы хуже, — но означает, что на боевом магазине его надо снять осознанно. Что с ним делает каждый драйвер, см. в Оплате.
Каталог и витрина
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_route_prefix | shop | префикс витрины. Пустое значение выключает витрину целиком |
pbshop_catalog_limit | 12 | товаров на странице каталога и раздела. 0 — все разом. На сниппеты не влияет: у них свой &limit |
pbshop_sitemap_route | пусто | адрес карты сайта каталога. Выключена по умолчанию, см. SEO |
pbshop_compare_limit | 4 | сколько товаров влезает в сравнение. 0 — «как у нас», а не «сколько угодно» |
pbshop_stock_alerts | включено | подписка «сообщить о поступлении». Кнопка появляется только там, где товару включён учёт остатка и его не хватает, — магазину без склада она не видна вовсе |
pbshop_consent | включено | галочка согласия на обработку данных в обеих формах оформления |
pbshop_consent_url | пусто | адрес политики: id ресурса MODX либо ссылка. Пусто — останется надпись без ссылки |
pbshop_quick_method | пусто | ключ способа оплаты для покупки в один клик. Пусто — первый офлайновый; способ со шлюзом в этой роли не работает вовсе, и тогда кнопки нет |
pbshop_login_url | пусто | адрес «Войти». Пусто — спрашиваем именованные маршруты pbAuth; нет ни того ни другого — ссылки нет вовсе |
pbshop_logout_url | пусто | то же |
pbshop_register_url | пусто | то же |
Пустой pbshop_route_prefix выключает витрину
Вместе с ней уходят все витринные маршруты — каталог, корзина, кабинет, страница заказа, поиск и сравнение. Для этого пустое значение и нужно: магазин, который выводится только сниппетами на собственных страницах сайта.
Обратный случай стоит знать на свежей установке: если на сайте уже есть страница /shop, витрина её перекроет. Лечится сменой префикса.
Шаблоны страниц
Каждая принимает чанк сайта вместо встроенного шаблона. Все понимают те же четыре формы, что &tpl: имя чанка, file:, @FILE и @INLINE.
| Настройка | Что заменяет |
|---|---|
pbshop_catalog_tpl | страницу каталога |
pbshop_category_tpl | страницу раздела |
pbshop_product_tpl | страницу товара |
pbshop_cart_tpl | корзину |
pbshop_account_tpl | кабинет покупателя |
pbshop_order_tpl | страницу заказа |
pbshop_search_tpl | страницу поиска |
pbshop_compare_tpl | страницу сравнения |
pbshop_notice_tpl | страницу с одним сообщением, по ней приходят из письма |
pbshop_layout_tpl | обёртку, в которую заворачиваются встроенные шаблоны. Свой чанк обёртки не получает — там страницу собирает сайт |
Настройки «включить поиск» намеренно нет: поиск — часть каталога, как подбор и постраничность, и поле стоит в шапке каждой страницы витрины. Выключенный поиск означал бы форму, которая ведёт в 404.
Чеки
Настройки кассы, в отличие от платёжного драйвера, — системные: договор с ОФД один на юрлицо, касса одна на все способы. Объяснение целиком — в Чеках.
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_fiscal_driver | пусто | atol либо checkbox. Пусто — фискализации нет, и это умолчание |
pbshop_fiscal_login | пусто | АТОЛ: логин кабинета. Checkbox: логин кассира |
pbshop_fiscal_password | пусто | пароль к нему |
pbshop_fiscal_currency | RUB | валюта, в которой бьются чеки. Checkbox требует UAH — задайте явно |
pbshop_fiscal_test_mode | выключено | тестовый контур кассы. Намеренно отдельно от pbshop_test_mode |
pbshop_fiscal_group | пусто | АТОЛ: код группы |
pbshop_fiscal_inn | пусто | АТОЛ: ИНН продавца |
pbshop_fiscal_address | пусто | АТОЛ: адрес расчётов. Пусто — возьмётся адрес сайта, но он печатается в чеке, так что назовите |
pbshop_fiscal_sno | usn_income | АТОЛ: система налогообложения |
pbshop_fiscal_email | пусто | АТОЛ: почта продавца, печатается в чеке |
pbshop_fiscal_vat_code | 1 | ставка по умолчанию, 1 — без НДС. У товара своя задаётся полем конструктора и главнее |
pbshop_fiscal_licence_key | пусто | Checkbox: ключ лицензии кассы. Обязателен — нет ключа, нет смены, нет чеков |
pbshop_fiscal_pin | пусто | Checkbox: вход по пин-коду вместо логина. Требует ключа лицензии |
pbshop_fiscal_cashier_name | пусто | Checkbox: печатается в чеке; пусто — подставит касса |
pbshop_fiscal_departament | пусто | Checkbox: отдел. Пишется с опечаткой самой кассы |
pbshop_fiscal_shift_hours | 23 | Checkbox: через сколько часов касса закроет смену сама. Обязан остаться меньше 24 |
pbshop_fiscal_tax_codes | пусто | Checkbox: карта кодов ставок pbShop в коды кассы, JSON. Пусто — ставка не передаётся вовсе |
pbshop_fiscal_sms | выключено | Checkbox: отправлять чек в SMS. У кассы это платная услуга |
Почта
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_order_mails | включено | три письма покупателю о заказе |
pbshop_mail_from | пусто | отправитель. Пусто — берётся отправитель сайта, то есть то, чем он пользуется и без нас |
pbshop_mail_from_name | пусто | то же |
pbshop_invoice_copy_email | пусто | копия каждого счёта бухгалтерии вложением. Письмо на каждый новый файл, а не на скачивание |
pbshop_mail_order_created_tpl | пусто | чанк сайта для письма «заказ оформлен» |
pbshop_mail_order_paid_tpl | пусто | письмо «заказ оплачен» |
pbshop_mail_order_status_tpl | пусто | письмо «статус сменился» |
pbshop_mail_invoice_copy_tpl | пусто | копия счёта бухгалтерии |
pbshop_mail_stock_confirm_tpl | пусто | письмо «подтвердите подписку на поступление» |
pbshop_mail_stock_ready_tpl | пусто | письмо «товар поступил» |
Какие статусы достойны письма, решает галочка notify у статуса, а не pbshop_order_mails: эта — про все три письма разом.
Печатные документы
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_picking_tpl | пусто | чанк сайта для листа сборки |
pbshop_packing_tpl | пусто | чанк сайта для накладной в посылку |
pbshop_shop_phone | пусто | телефон в шапке накладной. Телефона в MODX нет вовсе, и почта вместо него не годится: в коробке нужен способ связи, по которому отвечают сразу |
Они стоят своей областью, а не рядом со счётом в «письмах», потому что счёт выписывают покупателю и отправляют, а эти два печатают себе — их не отправляет никто и никогда.
Фиды площадок
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_feed_currency | пусто | валюта фида. Пусто — pbshop_currency |
pbshop_feed_company | пусто | юрлицо в шапке. Пусто — тег не печатается, пустой читается как ошибка |
pbshop_feed_vendor | пусто | производитель у товаров без своего |
pbshop_feed_ttl | 60 | сколько минут собранный файл живёт. 0 выключает кеш, для отладки |
pbshop_feed_key | пусто | непустое значение требует ?key= в адресе фида |
Подробности — в SEO и фидах.
Подписки
| Настройка | Умолчание | Что делает |
|---|---|---|
pbshop_renew_days_before | 3 | её не читает ничто |
pbshop_grace_days | 0 | её не читает ничто |
Эти две настройки не делают ничего
Они ставятся, у них есть подписи и описания на четырёх языках, и ни одна строка кода их не читает. Сверено 24.10.2026.
Окно продления и правда равно трём дням, и правка настройки его не сдвинет — передавайте число в dueForRenewal($days). Льготного периода и правда нет; реализуйте его в своём слушателе pbShopOrderExpire, отложив снятие.
Они перечислены здесь, а не опущены, потому что настройка с переведённым описанием выглядит в точности как работающая функция, и узнать обратное от покупателя, у которого доступ сняли на день раньше, — дорого. Обе записаны как дефект. См. Подписки и крон.
Настройки, которые принадлежат PageBlocks
Две настройки платформы меняют поведение магазина, и знать о них стоит потому, что симптомы выглядят как баги магазина:
| Настройка | Почему важна здесь |
|---|---|
pageblocks_http_cache | при включённом сниппеты корзины и заказа отказывают вслух, а не рискуют напечатать состав одного покупателя в кешированную страницу другого |
static_elements_allowed_extensions | обязана разрешать tpl, иначе MODX не создаст файл для чанка, которому вы поставили галочку «статичный». Пустое значение означает «статичных элементов нет вовсе» |
Дальше
- Что где лежит — границы пакетов и табличка статуса
- Разработчику — сервис, события и маршруты