Дополнительные инструменты для OpenCart

Расширенная версия модуля CityManager - включает в себя весь его функционал и обладает дополнительными возможностями.
Модуль определяет город по IP-адресу или домену либо пользователь выбирает его вручную. Автоматически заполняются поля Страна, Регион,
Город, Индекс (не для всех) при регистрации и оформлении заказа,
избавляя пользователя от ручного ввода.
Гео-сообщения - возможность выводить разный текст или html для городов и регионов (см. скриншоты и FAQ) .
Редиректы - в зависимости от города модуль может перебрасывать пользователя на нужный под-домен и URL.
Для всех стран можно задать свою валюту, она будет автоматически выставляться при определении по IP.
GeoIP Pro позволяет задавать разные цены на товары для городов через привязку групп покупателей к городам.
В Pro-версии можно привязать под-домен к городу и там всегда будет
выставляться этот город, не зависимо от IP, это дает существенный
выигрыш при региональном сео продвижении сайта.
 
Внимание! Перед обновлением на версию 8 и выше напишите мне в личку, чтобы добавить сайт в базу, ключ теперь выдается с сервера, старые ключи в новых версиях работать не будут.

Модуль содержит базу населенных пунктов России (ФИАС), Украины, Белоруссии, Казахстана на русском языке.
Определение по IP работает для России, Украины, Белоруссии и Казахстана с точностью
до города для других стран с точностью до страны.
Модуль русскоязычный, автор не гарантирует 100%-ю работу модуля для других
языков. Настройка редиректов, гео-сообщений и групп покупателей возможна
только для указанных выше стран.

Лицензия
Одна лицензия включает:     основной домен со всеми под-доменами: site.com, shop.site.com, moskva.site.com, moskva.shop.com и др.
    по усмотрению автора:
        на схожие домены: site.ru / site.by, mysite.ru / my-site.ru
        тестовый домен: поддомены технических доменов (tmweb.ru, beget.tech, tw1.ru и др.), домены содержащие test, demo, developer и др.
        локальный домен: site.loc, site.local (ключ на localhost не выдается)

Если вы не указали адрес сайта при покупке, отправьте его автору личным сообщением.
Лицензия не переносится на другой домен!

Установка
Скачайте архив, подходящий под вашу версию OpenCart. Распакуйте архив. Следуйте руководству в файле Инструкция.txt

Поддержка
Перед обращением в тему тех поддержки обязательно прочитайте FAQ
При обращении за индивидуальной тех. поддержкой в ЛС обязательно указывайте адрес сайта , доступы и как можно точнее описывайте проблему.

Демо
Магазин
Админка (demo/demo)
 

 

Модуль позволяет обновлять курс валют с сайтов ЦБ РФ (cbr.ru), НБ РБ (nbrb.by), Европейский ЦБ (ecb.int). Использует стандартный функционал обновления раз в сутки при заходе на главную админ панели, а также возможность ручного обновления из списка валют и имеет уникальную функцию обновления по расписанию через cron в любое время
 
Модуль умеет увеличивать полученный курс на заданный процент.
 
* Не заменяет системные файлы
* Не требует vqmod
* Устраняет ошибку в админ панели Warning: Division by zero in ...../admin/model/localisation/currency.php

Описание
Данный набор абстрактных классов представляет из себя основную структуру библиотек и моделей OpenCart3. После подключения к проекту PhpStorm будет доступен удобный просмотр справки по методам, классам и автодополнение кода.

GitHub: https://github.com/mpn2005/opencart-phpstorm-autocomplete 
Установка
В меню PhpStorm выбрать File -> Settings... -> PHP. На закладке Include Path добавляем путь к скачанной папке opencart-phpstorm-autocomplete/OpenCart3 После индексации автодополнение будет доступно в текущем открытом проекте.
Подсказки для штатных моделей OpenCart
К сожалению, в OpenCart не предусмотрены отдельные именные пространства для разделов admin и catalog. Поэтому для корректной работы используемые модели надо будет прописать через property PHPDoc.
Пример для раздела admin
/** * @property \Admin\ModelCatalogAttribute $model_catalog_attribute * @property \Admin\ModelCatalogCategory $model_catalog_category * @property \Admin\ModelSettingSetting $model_setting_setting * @property \Admin\ModelToolImage $model_tool_image */ class ControllerExtensionModuleMyMod extends Controller { ... }  
Пример для раздела admin
/** * @property \Catalog\ModelCatalogAttribute $model_catalog_attribute * @property \Catalog\ModelCatalogCategory $model_catalog_category * @property \Catalog\ModelToolImage $model_tool_image */ class ControllerExtensionModuleMyMod extends Controller { ... }  
Пример для для библиотеки проекта
Если у вас в проекте есть своя библиотека,то её можно подключить так:
/** * @property Ownlib $ownlib */ class ControllerExtensionModuleMyMod extends Controller { ... }  

PandaToolbar – это панель инструментов, облегчающая редактирование контента в интернет-магазине. Она позволит, находясь на любой странице магазина, открывать и использовать установленные (на панель) расширения. Так же, можно самому добавлять страницы админки в «избранное». (Если Вас интересуют нестандартные модули, нужно обратиться к автору, для создания интеграции).
 
И так, «фишки» PandaToolbar:
Панелька на «Морде» сайта; Возможность взаимодействия с инструментами на панели, с любой точки сайта; Независимость от содержимого на странице; Возможность интеграции с другими модулями; Отображение статусов заказов с кол-вом заказов. При нажатии на иконку статуса, открывается окно “заказы” с сортировкой по этом статусу; Персональный набор инструментов для каждого пользователя; Персонализация панели: Изменение цветов панели и модального окна; Изменение цвета кнопок инструментов на панели; Изменение иконок инструментов на панели; Возможность задать собственный порядок инструментов; Изменение размеров модального окна; Изменение положения панели, относительно контента сайта; Экспорт/импорт персональных настроек.  
После установки, рекомендую сделать импорт визуальных настроек из файла "ptb_visual_setting_default.json" (в архиве с файлами). Для этого, в настройках модуля, нажмите на кнопку с стрелкой вверх "импорт настроек", в появившемся окне выберите файл настроек и нажмите "открыть". После, страница перезагрузится, нажмите зеленую кнопку "сохранить", чтобы изменения вступили в силу.
 
Так же, Вы должны обратить внимание, что визуальные настройки для каждого пользователя персональные, и импорт настроек для одного пользователя,  не изменит настройки другого. Поэтому, удобно использовать модуль UPP для входа в профиль другого пользователя и изменения его визуальных настроек.
 
В скором времени, будут добавлены версия для OpenCart 3.x и документация.

Оповещения о заказах в Telegram

Модуль Оповещения о заказах в Telegram позволяет получать сообщения о поступившем заказе в Telegram, а также уведомлять клиента о смене статуса заказа. Есть возможность создать шаблоны сообщений покупателю и администратору.
Администратор может получать уведомления при новом заказе в Telegram. Покупатель может получать уведомления при смене статуса заказа, если при оформлении заказа подписался на такие уведомления. Модуль не перезаписывает файлы движка или шаблона. Используются модификаторы ocmod и vqmod.
Перед установкой модуля нужно создать бота Telegram и получить Id пользователя.

Инструкция по созданию бота:
1) В поиске телеграм найдите бота @BotFather. Это главный бот, через которого создаются все боты.
2) Нажмите Запустить.
3) Напишите и отправьте сообщение /newbot. Это команда для создания нового бота.
4) В ответ вы получите сообщение Alright, a new bot. How are we going to call it? Please choose a name for your bot. В сообщении говорится, что нужно задать имя для нового бота. Напишите ответным сообщением имя бота (Например Бот уведомлений о заказах).
5) В ответ вы получите сообщение Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot. Вас просят задать username для бота. Это публичное имя, по которому ваш бот можно будет найти в поиске. оно должно иметь окончание bot. Например my_bot или mybot. Это имя потребуется потом в настройках модуля.
6) Если такое имя занято, вы получите сообщение об ошибке Sorry, this username is already taken. Please try something different. Тогда нужно придумать другое уникальное имя. В случае успеха вы получите сообщение, в котором будет ссылка на вашего бота и строка с токеном Use this token to access the HTTP API:
5642622960:SFJLDJSLKFKLDJFLEIIEJFDLKD
7) Токен необходимо сохранить, для дальнейшего ввода в настройках модуля. 
8) Перейдите по ссылке на вашего бота и нажмите Запустить.

Получить Id пользователя
1) Заходим в телеграм и ищем в поиске @userinfobot
2) Пишем сообщение /start
3) В ответ на сообщение вы получите Id вашего пользователя. Он потребуется для настроек модуля

Установка для движка версии 2.0 и выше:
1) Установить архив через панель администратора через Установка дополнений.
2) Если при установке на версию 3.* выдается ошибка "Этот каталог system/tlg.ocmod.xml не доступен для записи!", то перед установкой нужно установить расширение localcopy_oc3.ocmod.zip
3) Зайди в Менеджер дополнений и обновить модификации.
4) Войти в настройки модуля в Дополнения - Модули - Уведомления в Телеграм , установить и выставить необходимые настройки. 
5) Сохранить настройки.

Установка для движка версии 1.5:
1) Содержимое папки upload скопировать в корень сайта. На сайте должен быть установлен vqmod.
2) Зайди в Система - Пользователи - Группы пользователей и внести изменения в вашей группе пользователя. Поставить галочки напротив module/tlg в блоках "Разрешен просмотр" и "Разрешено внесение изменений".
3) Войти в Дополнения - Модули. Установить модуль Уведомления в Телеграм, и выставить необходимые настройки. 
4) Сохранить настройки.

Настройка уведомлений администратору
1) Поле "Статус" должно быть Включено
2) Поле "Уведомления администратору" должно быть включено
3) В поле "Token доступа" вводим токен полученный в пункте 6 "инструкции по созданию бота".
4) В поле "Id пользователя" вводим Id вашего пользователя, полученный в пункте 3 инструкции "Получить Id пользователя".
5) После заполнения Token и Id вы можете протестировать отправку сообщений ботом. Для этого введите сообщение в поле "Отправить тестовое сообщение" и нажмите кнопку с "самолетиком". В телеграм должно прийти сообщение от вашего бота.
6) На вкладке "Шаблоны сообщений администратору" в поле "Шаблоны сообщений" задайте шаблон письма, при этом можно использовать динамические теги (они указаны в подсказках при наведении на вопросик). При указании таких тегов они будут заменяться информацией из заказа. Например "Вам поступил заказ № {order_id}". {order_id} в сообщении будет заменен на реальный номер заказа.
7) Если требуется в сообщении прописывать товары из заказа, то нужно настроить "шаблон строки товара". В нем тоже можно использовать динамические теги, для подстановки нужной информации о товаре. Например "Товар {name} на сумму {total}". {name} и {total} в сообщении будет заменен на реальные название и сумму.
8) В поле "Разделитель строки" прописываются символы, которые будут вставлены между строками товаров. (Например можно прописать -----------------).
9) Если шаблон товара заполнен, то в шаблоне сообщения нужно в произвольном месте вывести блок товаров с разделителями путем тега {products}. При этом вместо {products} будут выведены все товары заказа в заданном "шаблоне товара", разделенные "разделителем строки".
10) Сохранить настройки.
11) Теперь при создании нового заказа, администратору будут приходить сообщения с информацией о заказе по настроенному шаблону.

Настройка уведомлений покупателю
1) Поле "Статус" должно быть Включено
2) Поле "Уведомления покупателю" должно быть включено
3) В поле "Token доступа" вводим токен полученный в пункте 6 "инструкции по созданию бота".
4) В поле "Username бота" вводим username вашего бота, заданный вами в пункте 5 "инструкции по созданию бота".
5) В поле "Метод получения id покупателя" можно выбрать метод "Вебхук" или оставить "Запрос обновлений". Это методы получения id покупателя для отправки ему уведомлений. После завершения заказа, на странице Успеха пользователю будет предложена ссылка на подписку на уведомления. Если он по ней пройдет и подпишется на бота, путем нажатия кнопки "Запустить", то он будет получать уведомления. Вебхук позволяет автоматически уведомлять сайт о поступившем сообщении боту. Запрос обновлений посылает запросы боту при нахождении пользователя на странице Успеха, и в случае его подписки записывает его ID. Для метода вебхук сайт обязательно должен быть доступен по протоколу https. Если выбираете метод вебхук, нужно скопировать ссылку "Url для создания вебхука" и вызвать ее в браузере. При этом для бота будет создан вебхук. Если вы создали вебхук, и решили все таки использовать метод Запрос обновлений, то нужно скопировать ссылку "Url для удаления вебхука" и вызвать ее в браузере, чтобы вебхук удалился. Т.к. если работает один метод, то другой при этом работать не может.
6) На вкладке "Шаблоны сообщений покупателю" в поле "Статусы заказов" нужно отметить статусы заказов, при которых будет отправляться уведомление покупателю.
7) В разделе "Шаблоны сообщений" задайте шаблон письма для включенных статусов, при этом можно использовать динамические теги (они указаны в подсказках при наведении на вопросик). При указании таких тегов они будут заменяться информацией из заказа. Например "Ваш заказ № {order_id} сменил статус на Обработан". {order_id} в сообщении будет заменен на реальный номер заказа.
7) Если требуется в сообщении прописывать товары из заказа, то нужно настроить "шаблон строки товара". В нем тоже можно использовать динамические теги, для подстановки нужной информации о товаре. Например "Товар {name} на сумму {total}". {name} и {total} в сообщении будет заменен на реальные название и сумму.
8) В поле "Разделитель строки" прописываются символы, которые будут вставлены между строками товаров. (Например можно прописать -----------------).
9) Если шаблон товара заполнен, то в шаблоне сообщения нужно в произвольном месте вывести блок товаров с разделителями путем тега {products}. При этом вместо {products} будут выведены все товары заказа в заданном "шаблоне товара", разделенные "разделителем строки".
10) Сохранить настройки.
11) При завершении заказа покупателем и попадании на страницу Успеха, ему будет предложено подписаться на уведомления. Если он перейдет по ссылке и нажмет "Запустить", то его id будет записан в БД заказа, и при смене статуса заказа администратором, ему будут приходить уведомления в телеграм.

Демо:
http://9505831828.myjino.ru
http://9505831828.myjino.ru/admin
demo
demo

Yml opencart (мульти) дает возможность выгружать неограниченное количество выгрузок. Каждая выгрузка будет формироваться автоматически в момент вызова ссылки, что делает фиды всегда актуальными.
Для каждой выгрузки можно указать свои настройки:
- вкл/выкл
- название магазина
- наименование компании
- категории, которые необходимо выгружать
- валюта
- статус если товар в наличии
- статус если товара нет наличии

Установка для движка версии 2.0 и выше:
1) Установить архив через панель администратора через Установка дополнений.
2) Войти в настройки модуля в Дополнения - Каналы продвижения  - Мульти yml , и выставить необходимые настройки. Сохранить.
3) Url для каждого фида будет показан в настройках в поле "Url фида".

Установка для движка версии 1.5:
1) Содержимое папки upload скопировать в корень сайта. 
2) Зайди в Система - Пользователи - Группы пользователей и внести изменения в вашей группе пользователя. Поставить галочки напротив module/multiyml в блоках "Разрешен просмотр" и "Разрешено внесение изменений".
3) Войти в Дополнения - Каналы продвижения. Установить модуль Мульти yml , и выставить необходимые настройки. Сохранить.
4) Url для каждого фида будет показан в настройках в поле "Url фида".

Демо:
http://9505831828.myjino.ru
http://9505831828.myjino.ru/admin
demo
demo

BIGXML - разделение больших файлов XML и YML.
Удобное решение, что бы разбить один большой файл XML или YML на части. Скрипт позволяет делить файл по количеству товаров в фиде, можно использовать локальный файл или по ссылке.
В архиве есть bat и exe файлы для Windows, а так же python файл для Linux. 
Скрипт бесплатный, точно работает, делал для себя. Поддержка по возможности, но не обещаю.