dreamkas-opencart-3/README.md

61 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Модуль интеграции Dreamkas для OpenCart 3.*
## Содержимое репозитория
* `./dreamkas-opencart3.ocmod/` - директория с исходным кодом модуля
* `./dreamkas-opencart3.ocmod.ocmod.zip` - модуль, готовый к установке
* `./dreamkas-f opencart.ocmod.zip` - исходный модуль для OpenCart 2.3, на котором основан данный
## Описание
Модуль устанавливается на OpenCart 3.0.2.0, настройки сохраняются, читаются.
Судя по отзывам ([1](http://blog.anthonyaxenov.ru/2018/05/09/%d0%bc%d0%be%d0%b4%d1%83%d0%bb%d1%8c-%d0%b8%d0%bd%d1%82%d0%b5%d0%b3%d1%80%d0%b0%d1%86%d0%b8%d0%b8-dreamkas-%d0%b4%d0%bb%d1%8f-opencart-3-0-2-0/#comment-103) [2](https://help.dreamkas.ru/hc/ru/articles/115005504689-%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B8%D1%82%D1%8C-%D0%BA%D0%B0%D1%81%D1%81%D1%83-%D0%BA-OpenCart)), модуль рабочий, за исключением одного момента: не отображаются статусы фискализации, но сама фискализация работает.
У меня лично нет возможности проверить насколько качественно работает этот модуль: для этого нужны реальные заказы и покупки.
Проект, в рамках которого я работал над этим модулем, я больше не поддерживаю.
Вся основная логика модуля прописана здесь:
```upload/catalog/controller/extension/module/dreamkas.php```
Этот файл я не трогал.
Я лишь восстановил возможность установить, удалить и настроить модуль.
## Краткая информация
Основано на модуле *[dreamkas-f opencart.ocmod.zip](https://help.dreamkas.ru/hc/ru/article_attachments/115010763145/dreamkas-f_opencart.ocmod.zip)*.
Этот архив включен в репозиторий - для истории.
Может кому-нибудь даже будет интересно увидеть в diff-ах точные правки, но ниже я опишу вкратце лишь основные:
1. Шаблон (`upload/admin/view/template/extension/module/dreamkas.twig`):
1. переписан с языка php на язык шаблонизатора Twig
2. изменено расширение с .tpl на .twig
2. Страница настроек:
1. удалены большие куски закомментированного и нерабочего (?) кода
2. исправлено получение списка установленных платёжных систем
3. форматирование кода (`upload/admin/controller/extension/module/dreamkas.php`)
3. Мелкое форматирование и исправление ссылки на сайт разработчика (`install.xml`)
## Полезные ссылки
1. История появления модуля: [читать в блоге](http://blog.anthonyaxenov.ru/2018/05/09/модуль-интеграции-dreamkas-для-opencart-3-0-2-0)
2. Открытая документация к Dreamkas API: [kabinet.docs.apiary.io](http://kabinet.docs.apiary.io)
3. [Как подключить интернет-магазин к кассе через Кабинет?](https://help.dreamkas.ru/hc/ru/articles/115005007709)
4. [Подключить кассу к OpenCart](https://help.dreamkas.ru/hc/ru/articles/115005504689-%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B8%D1%82%D1%8C-%D0%BA%D0%B0%D1%81%D1%81%D1%83-%D0%BA-OpenCart)
5. Групповой чат для разработчиков в Telegram: [@apidreamkas](https://t.me/apidreamkas) (если ссылка не работает — ищи через в TG поиск)
## Лицензия
Весь исходный код, находящийся в этом репозитории, распространяется по [лицензии WTFPL v2](http://www.wtfpl.net/txt/copying/).
Причина - отсутствие какой-либо лицензии на исходный модуль `./dreamkas-f opencart.ocmod.zip` и безразличие к моим доработкам.
## Поддержка
Отсутствует и не появится.
Любые манипуляции с модулем - НА ВАШ СТРАХ И РИСК.
Я НЕ ДАЮ НИКАКИХ ГАРАНТИЙ ЕГО РАБОТОСПОСОБНОСТИ.