Модуль Shopkeeper для MODX Evo ✈ Evolution CMS

1428

Модуль Shopkeeper для MODX Evo ✈ Evolution CMS

Управление заказами интернет-магазина

Функции

  • Редактирование и удаление поступивших заказов;
  • Возможность установить заказу статус (новый, в процессе выполнения, отправлен, выполнен, возникли проблемы);
  • Возможность писать заметки к каждому заказу;
  • Сортировка заказов.
  • Управление товарами в каталоге (создание, редактирование).

Обновление

Для обновления модуля нужно удалить все файлы (кроме чанков) и загрузить новые. После этого нужно открыть модуль, при этом произойдет автоматическое обновление.

Конфигурация

  • Заказов на странице - число заказов в списке на одной странице.
  • Валюта - влияет на отображения в таблице заказов и подробной информации о заказе.
  • Цвета статусов - цвета строк в таблице заказов, соответствующие статусам заказов. Названия статусов можно менять в языковом файле shopkeeper/lang/lang_ru.php
  • Учет товара на складе (имя TV) - имя TV-параметра, который используется для учета кол-ва товаров на складе. Подробнее ниже.
  • Категория каталога по умолчанию (ID) - Укажите ID документа, который будет использоваться для каталога по умолчанию. В модуле появится кнопка для перехода в каталог. Необходимо также настроить плагин SaveToSHK.
  • Отменять заказ через, дн(я/ей) - если заказ находится в статусе "Принят к оплате" больше дней, он отменяется.
  • ID TV-параметра цены - нужно для каталога Shopkeeper.
  • Отправлять покупателю эл. письма при изменении статуса заказа - письма отправляются при переводе заказа в статусы "Принят к оплате" и "Отправлен". Шаблоны для писем находятсяв папке shopkeeper/module/templates/.
  • Шаблон для контактной информации - шаблон подробного вида контактной информации заказа. Можно указывать плейсхолдеры только те, которые используются в шаблоне письма заказа сниппета eForm (параметр &report), а также [+orderData+] (состав заказа) и [+orderID+] (номер заказа).
  • Шаблон для контактной информации в списке товаров - шаплон для контактной информации, которая отображается в таблице заказов.
    Можно указывать плейсхолдеры только те, которые используются в шаблоне письма заказа сниппета eForm (параметр &report), а также [+orderData+] (состав заказа) и [+orderID+] (номер заказа). По умолчанию: [+name+], [+address+], [+email+], [+phone+], [+delivery+], [+payment+]
  • Кнопка "Удалить все записи" удаляет таблицы модуля из базы данных (деинсталляция).

Шаблоны (чанки) и плейсхолдеры

Наименование шаблона Плейсхолдеры в шаблоне Примечание
Шаблон для письма покупателю об изменении статуса заказа [+date+] - дата заказа;
[+site_name+] - имя сайта;
[+orderID+] - номер заказа;
[+status+] - статус заказа;
[+loop+]/[+end_loop+] - начало и конец строки данных товаров (цикл);
[+name+] - название товара;
[+link+] - ссылка на товар;
[+price+] - цена товара
[+addit_data+] - список доп. параметров (используется шаблон additData.tpl);
[+count+] - кол-во единиц товара;
[+totalPrice+] - общая цена;
[+currency+] - валюта;
[+order_changed_txt+] - текст (берется из языкового файла) выводится, если состав заказа был изменен менеджером магазина и один или более товаров можно купить;
[+order_notpossible_txt+] - текст (берется из языкового файла) выводится, если ни один из выбранных товаров нельзя купить;
[+contact+] - Контактная информация (адрес, способ доставки и т.п.). Шаблон редактируется в конфигурации модуля. 		shopkeeper/module/templates/mail_changeStatus.tpl
Шаблон для письма покупателю об отправке заказа shopkeeper/module/templates/mail_shipped.tpl
Шаблон для списка доп. параметров товара в письме [+param+] - имя и цена параметра. Цена указывается в скобках. Если цена = 0, то пишется только название параметра (без скобок).
[+name+] - имя параметра.
[+price+] - цена параметра. 		shopkeeper/module/templates/additData.tpl

Каталог

Чтобы в модуле Shopkeeper (в админке) появилась ссылка "Каталог", нужно в конфигурации указать ID категории каталога (документ MODx) по умолчанию.
Также необходимо настроить конфигурацию плагина SaveToSHK — указать ID шаблона товаров и ID TV-параметра цены.

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

Учет количества товаров на складе

Для того чтобы покупатель и владелец магазина знали какое кол-во товара есть на складе, можно создать дополнительный TV-параметр (например inventory) с типом ввода "Text". Далее в конфигурации модуля нужно ввести имя TV в поле "Учет товара на складе (имя TV)". После перевода заказа в статус "Отправлен" число этого параметра для каждого выбранного товара будет автоматически пересчитано. Если поле "Учет товара на складе" пусто, кол-во товаров на складе не учитывается.

Важно

  • Для того чтобы заказы отправлялись в модуль, в вызов сниппета eForm добавить параметры:
    &eFormOnBeforeMailSent=`populateOrderData`&eFormOnMailSent=`sendOrderToManager`.
  • Для нормальной работы каталого Shopkeeper нужно настроить плагин SaveToSHK. Укажите ID шаблона товаров и ID TV-параметра цены.
  • В модуле есть возможность экспортировать список заказов в CSV-файл. Если для открытия вы используете OpenOffice, открыв файл, укажите параметр разделителя - "Точка с запятой", кодировка - "Кирилица (Windows-1251)".

В чанке шаблона формы оформления заказа должно быть скрытое поле с названием чанка текста письма (reportTpl)<input type="hidden" name="reportTpl" value="shopOrderReport" />

Пример вызова eForm

[!eForm?
&formid=`shopOrderForm`
&tpl=`shopOrderForm`
&report=`shopOrderReport`
&vericode=`1`
&gotoid=`11`
&subject=`Заказ в интернет-магазине`
&eFormOnBeforeMailSent=`populateOrderData`
&eFormOnMailSent=`sendOrderToManager`
!]