Переделываем модуль итого из osCommerce в VamShop

Есть модуль - Price Sensitive Discount - http://www.oscommerce.com/community/contributions,204 Скидка в зависимости от суммы заказа.

Как Вы могли заметить, данный модуль для osCommerce. Мы работаем в VamShop и, соответственно, нам нужно его переделать под VamShop.

Скачиваем модуль - http://www.oscommerce.com/community/contributions,204 (в данной статье используется версия 2.4). Распаковываем.

Начинаем переделывать модуль под VamShop.

1. Первое, что Вы должны знать об отличиях VamShop и osCommerce - это расположение языковых файлов. В osCommerce: /includes/languages/язык. В VamShop: /lang/язык.

Соотвественно, первое, что нам нужно сделать - переписать файл /includes/languages/english/modules/order_total/ot_lev_discount.php в /lang/english/modules/order_total/ot_lev_discount.php (это языковой файл для английского языка) и в /lang/russian/modules/order_total/ot_lev_discount.php (это языковой файл для русского языка). Можно также перевести на русский текст в /lang/russian/modules/order_total/ot_lev_discount.php, но это уже по желанию.

2. Теперь нам нужно переделать сам модуль /includes/modules/order_total/ot_lev_discount.php. Первое отличие структуры VamShop от osCommerce:

Все функции в VamShop начинаются с vam_ (а не tep_ как в osCommerce). Соответственно, в файле /includes/modules/order_total/ot_lev_discount.php меняем все tep_ на vam_

Второе отличие структуры VamShop от osCommerce: Все настройки модуля, т.е. названия и описания полей в VamShop, в отличии от osCommerce, хранятся в языковых файлах.

Нам нужно добавить языковые константы для названия поля и описания поля.

Открываем файл /lang/russian/modules/order_total/ot_lev_discount.php.

Смотрим на insert запросы, определяем, какие константы нам нужно добавить (т.е. смотрим на значения поля configuration_key) и видим следующие ключи:

MODULE_LEV_DISCOUNT_STATUS
MODULE_LEV_DISCOUNT_SORT_ORDER
MODULE_LEV_DISCOUNT_INC_SHIPPING
MODULE_LEV_DISCOUNT_INC_TAX
MODULE_LEV_DISCOUNT_CALC_TAX
MODULE_LEV_DISCOUNT_TABLE

Создаём языковые константы для данных ключей, добавляя к каждому ключу в конце:

_TITLE - это будет название настройки.
_DESC - это будет описание настройки.

Учитывая всё, что я сказал выше, Вы должны добавить в /lang/russian/modules/order_total/ot_lev_discount.php (можно также перевести данный текст на английский и добавить в /lang/english/modules/order_total/ot_lev_discount.php) следующее:

  define('MODULE_LEV_DISCOUNT_STATUS_TITLE', 'Показывать скидку');
  define('MODULE_LEV_DISCOUNT_STATUS_DESC', 'Разрешить скидки?');
  define('MODULE_LEV_DISCOUNT_SORT_ORDER_TITLE', 'Порядок сортировки');
  define('MODULE_LEV_DISCOUNT_SORT_ORDER_DESC', 'Порядок сортировки модуля.');
  define('MODULE_LEV_DISCOUNT_INC_SHIPPING_TITLE', 'Учитывать доставку');
  define('MODULE_LEV_DISCOUNT_INC_SHIPPING_DESC', 'Включать в расчёт доставку.');
  define('MODULE_LEV_DISCOUNT_INC_TAX_TITLE', 'Учитывать налог');
  define('MODULE_LEV_DISCOUNT_INC_TAX_DESC', 'Включать в расчёт налог.');
  define('MODULE_LEV_DISCOUNT_CALC_TAX_TITLE', 'Пересчитывать налог');
  define('MODULE_LEV_DISCOUNT_CALC_TAX_DESC', 'Пересчитывать налог.');
  define('MODULE_LEV_DISCOUNT_TABLE_TITLE', 'Процент скидки');
  define('MODULE_LEV_DISCOUNT_TABLE_DESC', 'Установите ценовые пределы и проценты скидки, через запятую.');

Затем нам нужно исправить все SQL запросы типа insert, проще говоря, смысл в том, чтобы перенести текст (название и описание настроек модуля) из SQL запросов в языковой файл, т.к. текст мы уже перенесли, теперь нужно удалить его из insert запросов. Удаляем из запроса поля configuration_title и configuration_description, а также значения для этих полей, т.е., к примеру, нам нужно исправить:

      tep_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) values ('Display Total', 'MODULE_LEV_DISCOUNT_STATUS', 'true', 'Do you want to enable the Order Discount?', '6', '1','tep_cfg_select_option(array(\'true\', \'false\'), ', now())");

На:

      vam_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_key, configuration_value, configuration_group_id, sort_order, set_function, date_added) values ('MODULE_LEV_DISCOUNT_STATUS', 'true', '6', '1','vam_cfg_select_option(array(\'true\', \'false\'), ', now())");

Точно также исправляем остальные insert запросы, в итоге insert запросы будут выглядеть следующим образом:

      vam_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_key, configuration_value, configuration_group_id, sort_order, set_function, date_added) values ('MODULE_LEV_DISCOUNT_STATUS', 'true', '6', '1','vam_cfg_select_option(array(\'true\', \'false\'), ', now())");
      vam_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_key, configuration_value, configuration_group_id, sort_order, date_added) values ('MODULE_LEV_DISCOUNT_SORT_ORDER', '98', '6', '2', now())");
      vam_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_key, configuration_value, configuration_group_id, sort_order, set_function ,date_added) values ('MODULE_LEV_DISCOUNT_INC_SHIPPING', 'true', '6', '3', 'vam_cfg_select_option(array(\'true\', \'false\'), ', now())");
      vam_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_key, configuration_value, configuration_group_id, sort_order, set_function ,date_added) values ('MODULE_LEV_DISCOUNT_INC_TAX', 'true', '6', '4','vam_cfg_select_option(array(\'true\', \'false\'), ', now())");
      vam_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_key, configuration_value, configuration_group_id, sort_order, set_function ,date_added) values ('MODULE_LEV_DISCOUNT_CALC_TAX', 'false', '6', '5','vam_cfg_select_option(array(\'true\', \'false\'), ', now())");
      vam_db_query("insert into " . TABLE_CONFIGURATION . " (configuration_key, configuration_value, configuration_group_id, sort_order, date_added) values ('MODULE_LEV_DISCOUNT_TABLE', '100:7.5,250:10,500:12.5,1000:15', '6', '6', now())");

Далее в файле /includes/modules/order_total/ot_lev_discount.php меняем:

      $this->enabled = MODULE_LEV_DISCOUNT_STATUS;

На:

      $this->enabled = ((MODULE_LEV_DISCOUNT_STATUS == 'true') ? true : false);

Если этого не сделать, то у данного модуля в админке не будет изменён статус на установлен и не будут показаны кнопки Удалить и Редактировать.

Ищите:

$cart['cart']->get_products();

Меняйте на:

$_SESSION['cart']->get_products();

Ищите:

$cart->get_quantity($t_prid);

Меняйте на:

$_SESSION['cart']->get_quantity($t_prid);

И последнее, что нам нужно сделать. В VamShop для вывода цены (скидки и т.д.) используется класс $vamPrice, в отличии от osCommerce, где используется класс $currencies. Проще говоря, нам нужно заменить:

    function process() {
      global $order, $ot_subtotal, $currencies;

На:

    function process() {
      global $order, $ot_subtotal, $vamPrice;

Затем:

                              'text' => '<b>' . $currencies->format($od_amount) . '</b>',

Замените на:

                              'text' => '<b>' . $vamPrice->Format($od_amount,true) . '</b>',

Всё, на этом переделка модуля закончена. Если какие-либо моменты Вам не понятны, можете скачать уже изменённый для VamShop модуль в файлах - http://vamshop.ru/forum/files и проверить, как правильно менять код.

Далее нужно просто установить модуль:

1. Переписывайте в свой магазин изменённые файлы модуля: /includes/modules/order_total/ot_lev_discount.php /lang/english/modules/order_total/ot_lev_discount.php /lang/russian/modules/order_total/ot_lev_discount.php

2. В Админке - Модули - Заказ итого установите модуль Ваша скидка.

3. Настройте скидку в зависимости от суммы заказа. Формат записи: сумма заказа:процент скидки, разделитель: запятая. Например, я хочу заказам от 0 до 20$ давать скидку 10%, от 20 до 50 - 20%, тогда я записываю следующим образом: 20:10,50:20

4. Скидка покупателю будет учтена и показана на странице подтверждения заказа - рис. 1.

Рис. 1.

Рис. 1.

Коротко подведу итог, в чём отличия order total модулей VamShop от order total модулей в osCommerce: 1. Расположение языковых файлов. В osCommerce: /includes/languages/язык. В VamShop: /lang/язык. 2. Все функции в VamShop начинаются с vam_ (а не tep_ как в osCommerce). 3. Все настройки модуля, т.е. названия и описания полей в VamShop, в отличии от osCommerce, хранятся в языковых файлах. 4. В VamShop для вывода цены (скидки и т.д.) используется класс $vamPrice, в отличии от osCommerce, где используется класс $currencies.

Зная эти 4 основных отличия, можно самому переделывать и другие order total модули из osCommere в VamShop.