Инструкция по установке модуля на различные версии Opencart, настройке редиректов и решение возникающих проблем

Установка Opencart 1.5:

• скачайте файл *.zip
• скопируйте содержимое на сервер в корневую папку
• очистите папку vqmod/vqcache
• зайдите в “Модули” в админке и активируйте модуль

Установка Opencart 2.x:

• скачайте файл *.ocmod.zip, открывать/распаковывать не нужно
• проверьте настройки FTP в opencart, 99% проблем связано с этим
• Установите модуль через стандартный интрумент “Дополнения — Установка дополнений”
• скачайте файл *.ocmod.xml
• Установите через стандартный инструмент “Дополнения — Установка дополнений”
• зайдите в “Дополнения — Модификации” и обновите кеш модификаций
• зайдите в “Модули” в админке и активируйте модуль

Установка Opencart 3.0:

• скачайте файл *.ocmod.zip, открывать/распаковывать не нужно
• Установите модуль через стандартный инструмент “Дополнения — Установка дополнений”
• зайдите в “Модули” в админке и активируйте модуль

Ручная установка на Opencart 2.x:

• скачайте файл *.ocmod.zip
• распакуйте и загрузите содержимое папки upload в корень сайта
• Убедитесь что нет ошибок и все файлы успешно загружены
• переименуйте файл *.ocmod.xml в install1301234321.ocmod.xml
• Установите через стандартный инструмент “Дополнения — Установка дополнений”
• зайдите в “Дополнения — Модификации” и обновите кеш модификаций
• зайдите в “Модули” в админке и активируйте модуль

Частые проблемы при установке

Не настроено правильно FTP в админке (OC 2.x)

Как правило не верно указана корневая директория сайта, посмотреть путь можно например в ФТП-клиенте, перейдя в нужную папку

Проявления:

• Ошибка SyntaxError: JSON…gjgh#$@$%45130123432145fioj….
• После установки не появляется в списке модулей
• При повторной установке не предлагает заменить много файлов

Решения:

• Правильная настройка FTP
• Использование патча QuickFix
• Ручная установка

«У Вас нет прав для доступа…»

Характерно бета версии на Opencart 2.3

Решения:

• Применить патч Z_convert_for_2.3.ocmod.zip
• в Система/Пользователи/Группы пользователей/Администратор задаем права для нужного модуля и Сохраняем
• Отключаем/Включаем модуль

Не происходит редирект

Возможные причины:

• Не установлен модификатор — зайдите в “Дополнения — Модификации” и проверьте, обновите кЭш
• В системе установлен модуль кЭширования — очистите кЭш
• Страница является рабочей, в этом случае редиректа не должно быть
• Не верно настроен редирект, читать ниже ↓

Формат редиректов

Для создания редиректа необходимо вписать в левое поле страницу с которой нужно произвести редирект, в правое соответственно куда нужно направить.

Начальный адрес вводится без домена и слешей в начале, конечный лучше так же (хотя возможен и полный адрес).

Пример:

razdel/n45dhg/713012343217.html→normalny_adres
index.php?product=5587→pechenye-ovsyanoe/5kg

Если в начальном адресе содержится апперсанд (&), то адрес указывается в формате xhtml, заменив & на &

Пример:

index.php?category=56&product=5587→pechenye-ovsyanoe/5kg

Маски

Для создания редиректа по маске используется символ звездочки.

«*» — заменяет произвольных набор символов. Точно так же как при поиске файлов в Windows или в robots.txt

например если было удалено много телефонов и нужно из карточек товаров направить в раздел:

phones/*→phones/

Так же если используется несколько «*» можно указать порядковый номер при подстановке в квадратных скобках

Например

a//b//c/→new/[2]/[1]/

При обращении по адресу site.com/a/odin/b/dva/c/ будет произведен редирект на site.com/new/dva/odin/

Если же сделать

a//b//c/→new///

будет редирект на site.com/new/odin/dva/

Поля DB/Config и File

Отличие заключается в месте хранения редиректов. Первое в памяти процесса, второе в файле. Первое быстрее но не рекомендуется хранить большой объем данных.

Так же в файл можно записывать напрямую, он расположен в system/config/. Это может быть полезно, так как через браузер текст может обрезаться. Файл создается если в админке записано хотя бы одно правило.

Редиректы с морды

Бывают случаи когда нужно производить редиректы со страниц типа site.com/?cat=547 или site.com/?product=478. Но они не отдают 404, а просто открывается главная страница сайта.

Для редиректа с этих страниц используйте файл system/config/redirects_list_home.ini. Редиректы прописываются в том же формате