Skip to content

Заказы в менеджере ​

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

На каждой сущности стоит конструктор полей PageBlocks, и это то, что стоит знать прежде, чем просить новую функцию: поле, заведённое администратором мышью, само уезжает в JSON-колонку. Ни миграции, ни аксессора, ни релиза.

Номера заказов ​

pbshop_order_number — шаблон, по умолчанию {year}/{seq:3}, то есть 2026/001. Доступны {year}, {yy}, {month}, {day} и {seq} со сколькими угодно ведущими нулями.

Счётчик обнуляется в пределах того, что стоит до {seq}. При умолчании — каждый год; при одном {seq:5} — не обнуляется никогда.

Статусы ​

Статусы заводите сами — pb_shop_statuses, с названием, цветом, порядком и тремя отметками. В сиде приезжают четыре: Новый, Оплачен, Отправлен и Отменён.

ОтметкаЧто означает
is_paidвыдать доступ — момент, с которого подписка идёт
is_canceledзаказ закрыт: отменён или возвращён
notifyписать покупателю при переходе в этот статус

is_paid не означает, что деньги пришли

В поставочном сиде он стоит и у «Отправлен», а не только у «Оплачен», потому что отвечает на вопрос «должен ли у этого покупателя быть доступ», а не «есть ли деньги». Про деньги спрашивают isSettled() — он смотрит, есть ли у заказа платёж с непустым paid_at.

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

Две отметки взаимно исключающие: статус «оплачен и отменён одновременно» сохранить не даст ничто. До 13.10.2026 не запрещало ничего — просто сид раздавал только осмысленные сочетания.

Лента истории ​

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

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

Гостевое действие от автоматического в гриде не отличить: у обоих автор пуст. Это принятая цена, а не недосмотр.

Карточка заказа ​

Кроме состава и истории, в карточке есть вкладки Доставка (снимок адреса и кнопки накладной), Покупатель (карточка учётной записи — почта и телефон из профиля MODX, ссылка на него, число заказов — плюс снимок контактов с оформления) и Плательщик (реквизиты юрлица).

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

Поиск и период ​

Поиск по заказам смотрит номер, накладную, промокод, учётную запись покупателя и — через JSON-снимки — контакты и реквизиты. Телефон находится и как записан, и одними цифрами.

Фильтр по датам даёт готовые разрезы (сегодня, 7/30/90 дней, год) и два поля дат, которые друг друга отменяют. Работает он по дате создания: у неоплаченного заказа paid_at пустой, и он выпал бы из любого периода. Верхняя граница — конец дня, иначе «по сегодня» отрезало бы весь сегодняшний день.

Документы, которые магазин рисует сам ​

Их три, все PDF, все рисует магазин — не путать с накладной перевозчика, которая создаётся у службы и печатается её бланком.

Счёт ​

Юрлицу, с составом заказа, доставкой и скидкой. Скачивается из окна заказа; «Сгенерировать заново» сразу отдаёт новый файл.

Продавец настраивается на валюту у способа оплаты bill: счёт в разных валютах часто выставляют разные юрлица, поэтому seller — это карта по коду валюты с ключом default. В каждой записи — name, reg_number, address, bank_name и bank_account.

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

Лист сборки ​

Отметьте заказы в гриде и напечатайте один лист, с которым идут по складу.

Весь его смысл в том, что он сгруппирован по товару, а не по заказу. Список заказов подряд у менеджера уже на экране; ходи с ним — и за одной и той же футболкой возвращаешься столько раз, во сколько заказов она попала. Здесь каждая позиция названа один раз с общим количеством, а номера заказов приписаны справа — по ним и раскладывают собранное.

Строка — это вариант, а не товар: «Платье, 3 шт» без размеров собрать нельзя. Порядок строк — по месту на складе, чтобы обход случился один раз, а не метанием между полками в алфавитном порядке артикулов; позиции без места — в конец.

Читается снимок позиции, а не живой вариант: его могли переименовать или удалить после покупки, а собирают то, что куплено.

Накладная в посылку ​

По странице на заказ, чтобы положить в коробку: состав и итоги. Спрашивает isSettled(), а не отметку статуса, — именно чтобы посылка с наложенным платежом не уехала с напечатанным «оплачено».

pbshop_shop_phone — телефон в её шапке. Название магазина и адрес сайта берутся из site_name и адреса сайта, а телефона в MODX нет вовсе, и подставить вместо него почту нельзя: в коробке нужен тот способ связи, по которому отвечают сразу.

Все три переопределяются чанком сайта — pbshop_picking_tpl, pbshop_packing_tpl и шаблон счёта — в обычных формах *_tpl: имя чанка, file: или @INLINE.

Двести заказов за одну печать

Намеренный предел: сборщик PDF держит документ целиком в памяти, и честный предел лучше, чем пустая страница на четырёхсотом заказе. За пределом менеджеру называют число, а не отдают обрезанный документ.

Реквизиты и адресная книга ​

И то и другое — «сохранённые карточки покупателя», устроены на одном механизме, и оба уезжают в заказ снимком.

Реквизиты (pb_shop_requisites) держат юрлицо: наименование, регистрационный номер, номер НДС, адрес, банк, счёт, код банка, контакт. Покупатель заводит их в кабинете, /pay/requisites.

Счёт гостю на оформлении недоступен

На странице корзины полей реквизитов нет — форма живёт только в кабинете. То есть «Счёт на оплату» работает у вошедшего покупателя с заведённой карточкой, а гость выбрать его не может.

Серверная половина при этом закончена: вопрос «нужны ли этому способу реквизиты» задан драйверу (needsRequisites()) в одном месте, так что второй способ выставления счёта возможен. Не хватает ровно полей на странице корзины.

Адреса (pb_shop_addresses) кормят выбор из книжки и галочку «Запомнить адрес» на оформлении.

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

Письма покупателю ​

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

ПисьмоСобытие
Заказ оформленpbShopOrderCreate
Заказ оплаченpbShopOrderPaid
Статус сменилсяpbShopOrderStatus

«Отправлен» — не свой шаблон, а то же письмо о смене статуса, включаемое галочкой notify у самого статуса. В сиде она стоит у «Отправлен» и «Отменён».

Каждый шаблон переопределяется чанком сайта: pbshop_mail_order_created_tpl, pbshop_mail_order_paid_tpl, pbshop_mail_order_status_tpl. Строки есть во всех четырёх локалях. pbshop_order_mails выключает все три — для магазинов со своей рассылкой: слушатель живёт в компоненте, и снять его иначе можно было бы только правкой bootstrap, то есть потерять правку на обновлении.

Повтор исключён списком того, что уже отправлено: pbShopOrderPaid бросается на каждую правку строки оплаченного заказа.

Сам почтовый слой — на PageBlocks: журнал и очередь с повтором в pb_mails, шаблон письма подменяется чанком сайта, вложения поддерживаются. pbshop_mail_from и pbshop_mail_from_name пусты по умолчанию — берётся отправитель сайта, то есть то, чем он пользуется и без нас, пока письма магазина не должны отличаться от писем регистрации.

Владельцу магазина не пишет ничто

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

Пока этого нет: повесьте слушатель на pbShopOrderCreate в core/App/config/pbshop.php и отправляйте то, что нужно вашему магазину.

Чего менеджер не может ​

Сказано прямо, чтобы это можно было запланировать:

  • массовой смены статусов нет — печать единственная операция над выборкой;
  • выгрузки списка заказов нет (у каталога CSV и xlsx есть — см. Каталог);
  • SMS и телеграм-уведомлений нет;
  • прав по разделам нет — доступ целиком под правами PageBlocks на раздел, то есть менеджер, видящий заказы, видит всё;
  • окна частичного возврата нет — сервис умеет вернуть часть суммы, и драйверы умеют, но формы, где менеджер назовёт сумму, нет.

Дальше ​

  • Чеки — грид чеков и его состояния
  • Каталог — импорт, экспорт, галереи и размерные сетки

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