Skip to content

Настройки ​

Все системные настройки, которые ставит магазин, с умолчаниями. Живут в системных настройках MODX по областям, и у всех префикс pbshop_.

Обновление пакета настройки не перезаписывает

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

Основные ​

НастройкаУмолчаниеЧто делает
pbshop_currencyEURвалюта магазина по умолчанию. Товар без цены в ней печатается без цены, а это не то же, что ноль
pbshop_currenciesEUR,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_prefixshopпрефикс витрины. Пустое значение выключает витрину целиком
pbshop_catalog_limit12товаров на странице каталога и раздела. 0 — все разом. На сниппеты не влияет: у них свой &limit
pbshop_sitemap_routeпустоадрес карты сайта каталога. Выключена по умолчанию, см. SEO
pbshop_compare_limit4сколько товаров влезает в сравнение. 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_currencyRUBвалюта, в которой бьются чеки. Checkbox требует UAH — задайте явно
pbshop_fiscal_test_modeвыключенотестовый контур кассы. Намеренно отдельно от pbshop_test_mode
pbshop_fiscal_groupпустоАТОЛ: код группы
pbshop_fiscal_innпустоАТОЛ: ИНН продавца
pbshop_fiscal_addressпустоАТОЛ: адрес расчётов. Пусто — возьмётся адрес сайта, но он печатается в чеке, так что назовите
pbshop_fiscal_snousn_incomeАТОЛ: система налогообложения
pbshop_fiscal_emailпустоАТОЛ: почта продавца, печатается в чеке
pbshop_fiscal_vat_code1ставка по умолчанию, 1 — без НДС. У товара своя задаётся полем конструктора и главнее
pbshop_fiscal_licence_keyпустоCheckbox: ключ лицензии кассы. Обязателен — нет ключа, нет смены, нет чеков
pbshop_fiscal_pinпустоCheckbox: вход по пин-коду вместо логина. Требует ключа лицензии
pbshop_fiscal_cashier_nameпустоCheckbox: печатается в чеке; пусто — подставит касса
pbshop_fiscal_departamentпустоCheckbox: отдел. Пишется с опечаткой самой кассы
pbshop_fiscal_shift_hours23Checkbox: через сколько часов касса закроет смену сама. Обязан остаться меньше 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_ttl60сколько минут собранный файл живёт. 0 выключает кеш, для отладки
pbshop_feed_keyпустонепустое значение требует ?key= в адресе фида

Подробности — в SEO и фидах.

Подписки ​

НастройкаУмолчаниеЧто делает
pbshop_renew_days_before3её не читает ничто
pbshop_grace_days0её не читает ничто

Эти две настройки не делают ничего

Они ставятся, у них есть подписи и описания на четырёх языках, и ни одна строка кода их не читает. Сверено 24.10.2026.

Окно продления и правда равно трём дням, и правка настройки его не сдвинет — передавайте число в dueForRenewal($days). Льготного периода и правда нет; реализуйте его в своём слушателе pbShopOrderExpire, отложив снятие.

Они перечислены здесь, а не опущены, потому что настройка с переведённым описанием выглядит в точности как работающая функция, и узнать обратное от покупателя, у которого доступ сняли на день раньше, — дорого. Обе записаны как дефект. См. Подписки и крон.

Настройки, которые принадлежат PageBlocks ​

Две настройки платформы меняют поведение магазина, и знать о них стоит потому, что симптомы выглядят как баги магазина:

НастройкаПочему важна здесь
pageblocks_http_cacheпри включённом сниппеты корзины и заказа отказывают вслух, а не рискуют напечатать состав одного покупателя в кешированную страницу другого
static_elements_allowed_extensionsобязана разрешать tpl, иначе MODX не создаст файл для чанка, которому вы поставили галочку «статичный». Пустое значение означает «статичных элементов нет вовсе»

Дальше ​

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