Инструкция по установке модуля Simple 4.11.x
Перед установкой и использованием модуля, пожалуйста, прочитайте условия лицензионного соглашения в файле license_ru.html
Продолжив установку и использование модуля, вы автоматически соглашаетесь с условиями соглашения.
- PHP не ниже версии 5.3
- IonCube Loader не ниже версии 10.0
Данную информацию можно уточнить у поддержки хостинга, а также попросить установить IonCube Loader в случае его отсутствия
Модуль не влияет на работу опенкарта, поэтому можете тестировать модуль параллельно с работой стандартных страниц заказа и регистрации, открывая страницы модуля по их прямым адресам. Замену ссылок можно переключать в админке модуля в разделе замены ссылок.
В данной инструкции также есть разделы "Есть вопросы", где даны пояснения почти по всем вопросам, которые могут возникнуть при установке модуля.
-
Залейте через FTP содержимое каталога 02-install/upload for 1.5.xupload for 2.0.x-2.2.xupload for 2.3.xupload for 3.0.x (именно содержимое, то есть каталоги admin,catalog,system из него, а не просто этот каталог целиком) на ваш сервер в корень сайта.
Пожалуйста, не путайте каталог для установки (02-install) с каталогом для обновления (update), он содержит только часть файлов модуля и установка не будет корректной!
Обратите внимание, что не на всех серверах при подключении к FTP открывается сразу корень сайта, сам сайт может лежать в таких каталогах, как www, public_html, каталоге с доменом сайта или любом другом, всё это зависит от настроек конкретного сервера. Корень сайта легко определить по наличию в каталоге как минимум следующих каталогов: admin, catalog, image, system, а также как минимум двух файлов: index.php, config.php (на картинке в правой части показан открытый каталог с сайтом, то есть его корневая (главная, основная) директория)
Есть вопросы?Наличие в каталоге для установки модуля "тех же самых" каталогов admin, catalog, system не означает, что что-то будет перезаписано, каталоги - это лишь структура для организации файлов, файлы модуля распределены по каталогам, повторяющим структуру каталогов опенкарта, чтобы каждый файл модуля в итоге попал в определенное место в опенкарте
При заливке может быть запрошена перезапись некоторых файлов шрифтов или джаваскриптов, но как правило это либо распространные джаваскрипты, которые могут использоваться несколькими модулями, либо это файлы самого опенкарта, которые вложены в архив модуля лишь потому, что авторы ряда сборок удаляют их из опенкарта. Можете либо пропустить эти файлы, либо перезаписать.
Из системных файлов опенкарта заменяется только один файл /system/library/url.php на тот же самый файл с небольшим изменением для подмены ссылок на страницы модуля. Заливка указанного файла не является обязательной и не влияет на работу модуля, так как замена ссылок может быть произведена любым другим способом. Однако если не хотите менять ссылки вручную, то необходимо залить его (подтвердить перезапись).
Можете сделать резервную копию указанного файла перед заливкой и в любой момент восстановить его с этой копии или из архива опенкарта вашей версии.
-
Залейте содержимое каталога 02-install/upload for 1.5.xupload for 2.0.x-2.2.xupload for 2.3.xupload for 3.0.x/catalog/view/theme/default/ (шаблоны и стили модуля) в каталог вашей темы catalog/view/theme/ВАША_ТЕМА/
-
В админке опенкарта зайдите в раздел модулейРасширения (дополнения) - Модули и напротив названия Простая регистрация и заказ Simple нажмите кнопку Установить.
Есть вопросы?Если не видите модуль в списке модулей, то убедитесь, что залили содержимое каталога установки под нужную версию опенкарта, а не весь каталог целиком, и что залили его в корень сайта, а не в произвольный каталог. Для подробной информации можете посмотреть пояснения к пункту 1.
Если не видите модуль в списке модулей и язык админки не русский, то скопируйте русский языковой файл модуля в каталог языка админки 02-install/upload for 1.5.xupload for 2.0.x-2.2.xupload for 2.3.xupload for 3.0.x/admin/language/russianru-ru/extension/module/simple.php в /admin/language/языкадминки/extension/module/
Если видите две копии модуля в списке модулей, то удалите файл /admin/controller/module/simple.php.
Если видите ошибку при нажатии кнопки установки (например ошибку 500 или просто надписть error), то скорее всего либо не установлен onCube Loader, либо нужно залить файлы с архива под другую версию PHP
Попросить установить IonCube Loader можно техподдержку хостинга, также у них можно уточнить точный текст возникающей ошибки.
-
Зайдите в админку модуля. Модуль запросит ключ лицензии. Введите его и сохраните.
Есть вопросы?Если не получили ключ после покупки, то получить его можно, отправив мне запрос через форму запроса ключа в админке модуля.
Если видите пустую (белую) страницу либо текст на белой странице, то скорее всего либо не установлен ионкуб, либо нужно залить файлы с архива под другую версию PHP
Если в админке модуля при его открытии вы видите ошибку 503 (Service unavailable) в красном уведомлении, то в файле /admin/view/template/extension/module/simple.tpl вместо async: true сделайте async: false
Если видите ошибку в красном уведомлении и по тексту ошибки видно, что проблема в некорректном адресе запроса, то проверьте корректность адреса сайта в файлах /admin/config.php и /config.php
Если видите ошибку в красном уведомлении и по тексту ошибки причина не ясна, то проверьте наличие файла /admin/controller/module/simple.php и удалите его, если он есть.
Если видите ошибку в красном уведомлении и прошлые советы не помогли, то обратите внимание на то, нет ли при открытии админки редиректса с домена без www на домен с www, и с адреса без https на http и проверьте соответствующие записи в /admin/config.php, то есть пропишите домен сразу с www и адрес с https, чтобы админка не делала редиректы при запросах к ней
-
Сохраните настройки модуля, цвет кнопки Сохранить меняется с красного на зеленый при сохранении настроек.
- Если используется нестандартный модуль заказа, то отключите его. Обычно он отключается либо в модулях, либо в модификациях (менеджере дополнений), либо удалением модификатора модуля нестандартного заказа в каталоге /system на сервере (имя файла обычно содержит название модуля заказа, а расширение файла - ocmod.xml). Это необходимо для замены ссылок, так как замена работает только для ссылок на стандартные страницы.
-
В админке опенкарта откройте раздел управления модификациями Дополнения - Модификации (Менеджер дополнений), убедитесь, что в списке есть модификатор для замены ссылок simple url rewrite, и нажмите сверху справа кнопку Обновить. Если указанного модификатора в списке нет, то сохраните настройки модуля в его админке.
Есть вопросы?Обновление кэша модификаций может приводить к ошибкам как в админке, так и в основной части опенкарта, что может создать иллюзию, что на это повлияла установка модуля, однако это не так.
Если ошибка происходит сразу при нажатии на кнопку обновления на той же странице, то причины могут быть такими: нет прав на запись в каталог кэша модификаций, неверный путь к каталогу модификаций в файле конфигурации опенкарта, отсутствующий каталог кэша модификаций, обрезанный код модификатора в базе (для опенкарта 2.0 и 2.1).
Если появляются ошибки в других местах уже после обновления кэша, то их причиной могут быть различные модификаторы, которые хоть и были в списке до этого, но фактически не применялись до обновления. Плюс ко всему в списке модификаций не видны модификаторы, которые находятся непосредственно в каталоге /system и которые тоже могли не применяться до текущего момента. Можно сделать сброс кэша кнопкой сверху справа и искать причину, отключая последовательно модификаторы и обновляя при этом кэш.
То, что делает модификатор модуля, можно сделать и не трогая систему модификаций, добавив одну строку кода в одном файле.
Откройте файл
/catalog/controller/startup/startup.php
и после строки, содержащей код
$this->registry->set('url',
добавьте строку
$this->url->addRewrite(new Simple\Rewrite($this->config, $this->session));
Если вдруг нет реакции на изменения, то указанный файл уже может лежать в кэше и тогда нужно править файл в кэше
/system/storage/modification/catalog/controller/startup/startup.php
- Установка модуля завершена!
-
Если вёрстка вашей темы отличается от стандартной, например внешне это проявляется в другой ширине страниц модуля либо в отличающихся хлебных крошках, то для встраивания страниц модуля в вёрстку темы можно создать файлы для интеграции с темой. Для этого в админке модуля в разделе Интеграции с темой скачайте файлы simple_header.tpl и simple_footer.tpl и загрузите их в следующий каталог на сервере /catalog/view/theme/ВАША_ТЕМА/template/common/
Необходимо понимать, что автор темы может и не использовать "стандартные" для опенкарта селекторы и модуль в таком случае не сможет наследовать все стили темы корректно, в таком случае их придется дополнительно определять в стилях модуля /catalog/view/theme/ВАША_ТЕМА/stylesheet/simple.css
Под ряд популярных тем в архиве модуля есть готовые файлы для интеграции, можете проверить их наличие в каталоге /misc/templates/ВАША_ТЕМА/ Если такой каталог есть, то залейте его содержимое в свою тему /catalog/view/theme/ВАША_ТЕМА/
Внимание! Темы постоянно меняются и поэтому готовые файлы могут и не подойти под вашу версию темы. Создание указанных файлов и подгонка под каждую тему в поддержку модуля не входят в силу наличия сотен тем разных версий под разные версии опенкарта!
Для первоначальной настройки модуля в его админке есть помощник по настройке.