Модуль Shopkeeper для MODX Evo ✈ Evolution CMS
- Дополнения
- Shopkeeper
- Модуль Shopkeeper
Модуль 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` !]