Заказы в менеджере
В разделе магазина живут двадцать четыре грида: товары, категории, варианты, опции и их значения, цены, заказы с позициями и лентой истории, платежи, чеки, валюты, статусы, способы оплаты, способы доставки, промокоды, адреса, карточки юрлиц, размерные сетки, ожидания поступления и прогоны крона.
На каждой сущности стоит конструктор полей 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 на раздел, то есть менеджер, видящий заказы, видит всё;
- окна частичного возврата нет — сервис умеет вернуть часть суммы, и драйверы умеют, но формы, где менеджер назовёт сумму, нет.