📄 Модуль "Заказы"

Модуль «Заказы» соединяет сайт организации на MODX (Shopkeeper 3) с МойСоцХаб: заказы с составом и контактами прилетают сами, статусы оплаты синхронизируются автоматически, а клиенты получают фирменные письма. Этот гайд проведёт по всему модулю — от подключения до аналитики.

Быстрый старт: подключение

Подключение занимает пару минут и делается один раз. Всё, что нужно на стороне MODX, уже настроено разработчиком — вам достаточно скопировать два значения.

1. Включите модуль «Заказы (Shopkeeper 3)» в управлении модулями.
2. Откройте 🛒 Заказы в меню организации — сверху будет панель «Подключение MODX».
3. Скопируйте кнопками URL вебхука и токен.
4. На сайте MODX вставьте оба значения в сниппет ShkSendToHub (переменные $HUB_URL и $HUB_TOKEN).
5. Сделайте тестовый заказ на сайте — через несколько секунд он появится в модуле.

Список заказов и живые обновления

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

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

Поиск и фильтры

Строка над таблицей ищет мгновенно по имени, телефону, email и номеру заказа; селект справа фильтрует по оплате: все / только оплаченные / только неоплаченные. Фильтры работают вместе и применяются ко всей подгруженной ленте.

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

Кнопка 👁 справа от заказа открывает карточку — всё, что клиент оставил на сайте, в одном окне:

• Контактная информация — имя, телефон, email и другие заполненные поля формы.
• Состав заказа — товар, параметры (например, имена из записки), количество и цена.
• Прочее — способ оплаты, доставка, трек-номер и примечание, если они указаны.
• Письма клиенту — история отправленных писем и форма нового (раздел ниже).

Письма клиентам

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

Автописьмо при оплате

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

Ручное письмо и история

В карточке заказа (👁) в блоке «Письма клиенту» администратор пишет свой текст и при желании свою тему — например, «заказ принят в работу» или «записка отслужена» — и отправляет одной кнопкой. Каждое письмо сохраняется в истории с датой и темой; отправить можно сколько угодно писем, вся переписка видна в карточке.

Настройка отправителя

Панель «От чьего имени отправлять письма» задаёт email и имя отправителя для всей организации. Если указан адрес на домене сайта — письма честно уходят с него. Если внешний адрес (например, почта на mail.ru) — почтовый сервер не позволит слать «от чужого имени», и модуль включит умный режим: технически письмо уйдёт с системного ящика, но в поле «Ответить» будет адрес организации, а в конце письма появится строка «отвечайте на этот адрес». Кнопка 📧 Тестовое письмо мне проверяет настройку за секунду.

Аналитика

Кнопка 📊 Аналитика в шапке открывает дашборд по всем заказам организации. Переключатель периода 30д / 90д / Год / Всё пересчитывает показатели под выбранное окно, а дельты в плитках показывают изменение к предыдущему периоду.

Что на дашборде

• KPI-плитки — заказов за период, оплачено (с суммой), не оплачено (с суммой), выручка и средний чек.
• Живые выводы — дашборд сам формулирует строки-инсайты: доля оплат, лучший месяц по выручке, самая популярная позиция, возвращаемость базы.
• Динамика по месяцам — столбцы оплаченных и неоплаченных заказов плюс линия выручки.
• По годам и по дням недели — когда приходят заказы и деньги.
• Популярные позиции — топ товаров и треб по количеству и сумме за всё время.
• Повторные клиенты — уникальные, повторные и доля возвращающихся, плюс топ-5 самых активных заказчиков.
• Способы оплаты — если Shopkeeper передаёт их для заказов.

Отчёт PDF

Кнопка ⤓ Отчёт PDF собирает весь дашборд в многостраничный документ одной кнопкой — панель управления на снимок не попадает. Удобно для отчёта настоятелю или бухгалтеру.

Как работает синхронизация

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

Кто видит модуль

Раздел доступен менеджерам организации и администраторам сайта. Обычные участники кнопку «🛒 Заказы» не видят, а по прямой ссылке получают отказ — финансовые данные остаются внутри администрации.

Шпаргалка