Руководство Администратора Данная тема это общее руководство для администраторов магазина на базе OpenCart 3х, в котором содержатся различные инструкции и советы. Обратите внимание, что данное руководство рассчитано именно на "администраторов", т.е людей со знанием различных технических подробностей, например таких как управления хостингом, работа с базами данных, подключения по фтп, операции по копированию файлов на сервер итд. Быстрые ссылки раздела: 1. Перемещение на новый сервер 2. Создание мультимагазина 3. Основы безопасности 4. Установка модулей и модификаторов 5. Управление кешом 6. Вывод и просмотр ошибок 7. Редактор шаблона и конфликты назад к Содержанию
Перемещение OpenCart на другой сервер Для того чтобы перенести OpenCart 3 на другой сервер, необходимо выполнить следующие действия. 1. Скопируйте все файлы OpenCart с существующего сервера на новый веб-сервер. 1.1. Перенести директорию storage на новый сервер. 2. Импортируйте базу данных OpenCart на новый сервер. 3. Измените файлы config.php и admin/config.php. Данные файлы содержат пути к директориям OpenCart, а также данные доступа к базе данных. 4. Установите права на директории согласно инструкции по установке. Обратите внимание! Если на новом сервере вам не известны новые пути, или вы не уверены в соответствии требований для установки, то вам необходимо на новом сервере сначала установить opencart 3 и после посмотреть на файлы config.php Экспорт и импорт базы данных лучше всего производить посредством средств предоставленным хостингом, например phpmyadmin .
Создание мультимагазина Opencart 3 позволяет создать мультимагазин. При таком режиме работы используя только одна БД и единая панель управления. Вы можете добавить неограниченное количество дополнительных магазинов, не выполняя повторной установки движка. Для того чтобы добавить новый дополнительный магазин, необходимо выполнить следующие действия. 1. В панели управления хостингом создать поддомен и направить его на директорию основного магазина. (как привязать поддомен к директории, узнавайте в справке вашего хостера или у поддержки хостинга) 2. Меню — Система — Настройки и нажать Добавить , далее просто заполнить поля. 3. После добавления дополнительного магазина, вы получите возможность выбора дополнительного магазина, например, при добавлении товара выбирать принадлежность товара к магазину.
Основы безопасности OpenCart 3 достаточно защищен от внешних атак, sql инъекций, прямого доступа итд. Все проблемы безопасности ежемесячно устраняются, а так же постоянно улучшаются. Но все же, рекомендуем провести необходимый минимум обеспечения безопасности вашего магазина на базе OpenCart 3. 1. Удалите папку install . Об этом вам постоянно сообщают в панели администратора и дабы обезопасить систему, необходимо ее удалить. 2. Перенесите папку storage за пределы корня вашего магазина. Это по умолчанию будет вам предложено после в входа в административную панель. 3. Можно дополнительно переименовать директорию admin . Так же не забывайте изменить название папки в путях файлов конфигурации, это config.php и admin/config.php Обратите внимание. Когда вы будите устанавливать модуль или шаблон, вам необходимо предварительно в директории (модуля или шаблона) изменять стандартное название директории admin на ваш. 3.1. Вместо выше указанного способа вы можете просто запретить доступ к папке admin с помощью .htaccess и .htpasswd Так же доступ к папке admin можно запретить с помощью панели управления хостингом. (о данном функционале , читайте в справке вашего хостера) 4. Проверьте, закрыт ли прямой доступ к файлам посредством браузера, например к ваш-сайт/catalog/view/theme/default/template/account/edit.twig Если вместо ошибки 404, вы увидели код шаблона, то вам необходимо срочно принять меры, например в папке catalog создать файл .htaccess со следующим кодом Код: <FilesMatch "\.(php|tpl|txt)$"> Order Deny,Allow Deny from all Allow from "ВАШ IP адрес" </FilesMatch> Тоже самое относится и к папке system. Доступ к файлам из вне должен быть полностью запрещен. Код: <Files *.*> Order Deny,Allow Deny from all Allow from "ВАШ-IP-адрес" </Files> Если с помощью .htaccess не удается достигнуть нужного результата, обратится к вашему "хостеру" с вопросом решения данной проблемы. Стоит заметить, что у "нормального хостера" таких проблем не наблюдается. 5. Меняем стандартное название лог файла error.log на другое. Для этого в панели администратора в разделе Меню - Система - Настройки - вкладка Сервер в поле Файл журнала ошибок, необходимо изменить название файла. Обратите внимание! Переименовывать нужно в том случаи, если действительно у вас по каким то причинам возможно получить доступ к файлу. При переносе директории storage за пределы сайта, прямого доступа из веба к log файлу нет. 6. Установите права доступа 644 или 444 на указанные файлы Код: config.php index.php admin/config.php admin/index.php system/startup.php
Установка модулей, расширений и модификаторов Установка модулей и расширений Для того чтобы установить расширение в OpenCart 3, необходимо следовать инструкции разработчика расширения. Обычно установка расширения производится через административную панель в Меню - Модули / Расширения - Установка расширений. А так же в некоторых случаях установка производится с помощью простого копирования файлов в корень вашего сайта (корень это там где файлы htaccess и robots.txt, index.php) Как пример. Вы разархивировали модуль и перед вами папка upload в которой находятся директории catalog, admin итд. Вот именно эти директории и необходимо копировать в корень сайта. Далее, обычно, расширение появляется в списке расширений Меню - Модули / Расширения - Модули / Расширения (если конечно обратное не указано в описании модуля). После необходимо найти данное расширение в списке расширений и активировать его. Обратите внимание, что расширение не обязательно появится в списке Модулей, возможно нужно на странице расширений в фильтре выбрать другой тип расширения, например "Оплата" Затем перейти в редактирование модуля или расширения и выполнить его настройки, не забыв при этом установить настройку Статус - Включено. Если в описании указано, что необходимо обновить кеш модификатора это значит, что вам необходимо перейти в Меню - Модули / Расширения - Модификаторы и нажать кнопку Обновить. Установка отдельного модификатора Существует несколько способов установки модификаторов: 1. Загрузка модификатора через Меню - Модули / Расширения - Установка расширений . Данный метод установки записывает код модификатора в базу данных, так же модификаторы видны в списке модификаторов. 2. Возможно просто скопировать файл модификатора в папку system . Данный метод не записывает код в базу, а использует его напрямую. Удобен тем, что можно код редактировать дальше не делая повторных загрузок. После установки модификатора (или его изменения) необходимо в Меню - Модули / Расширения - Модификаторы, нажать кнопку Обновить для обновления кеша модификатора
Управление кешом В OpenCart 3 существуют различные кеши. Иногда (по просьбе, отладке, после установки расширения) нужно их очистить или обновить. 1. Кеш модификаторов. Он находится в директории storage\modification . Обычно он автоматически обновляется, если в Меню - Модули / Расширения - Модификаторы, нажать кнопку Обновить Спойлер: обновление модификатора 2. Кеш TWIG. При изменении шаблона вы обновили модификаторы, но шаблон не изменился. Причиной этого и есть кеш шаблонизатора. Его тоже можно обновить из административной панели или просто временно отключить. Управление данным кешом находится на главной странице панели в правом углу (см рис.1). А так же можно его очистить вручную, т.е удалив файлы из директории storage\cache Спойлер: рис.1 3. Как сам движок, некоторые модули хранят кеш своих данных в директории storage\cache Поэтому при необходимости можно очистить данную директорию. 4. И конечно не забываем про Куки и Кеш браузера. Куки очищаются в настройках браузера, а кеш (обычно кешируются стили и скрипты) очищаются нажатием комбинации клавиш CTRL + F5 Внимание! Директория storage может быть вынесена за пределы сайта. Не забывайте этот факт. Если не знаете точного расположения, то можете посмотреть в файле config.php
Вывод ошибок и просмотр их Бывают случаи когда ваш магазин показывает просто белый лист и никаких ошибок, но нужный функционал работает не так как нужно. Для этого в OpenCart 3 и существует логи ошибок. Давайте разберемся. 1. По умолчанию все ошибки записываются в лог файл, находящийся в директории storage\logs А так же ошибки можно увидеть в панеле администратора Меню - Система - Обслуживание - Журнал ошибок 2. После установки модификатора и обновлении его кеша, вы так же можете посмотреть на ошибки, а точнее на лог внесенных или нет изменений в Меню - Модули / Расширения - Модификаторы вкладка Лог 3. Бывают случаи, особенно при разработке на OpenCart 3 , что мы например выводи неопределенную переменную в шаблон, но ошибки никакой не видим. Причиной этого явления является шаблонизатор TWIG который и скрывает ошибки. Для их отображения необходимо внести некоторые изменения, а какие именно вы можете прочитать на форуме в данном сообщении. 4. И в заключении. Часто бывают ситуации, когда вы видите просто белый экран, вместо ошибок. Ничего страшного, необходимо просто включить их отображение на сервере. Как именно, узнаете в статье тут.
Редактор шаблона и конфликты Часто многие начинающие администраторы магазина пытаются отредактировать файлы шаблона через встроенный функционал Меню - Дизайн - Редактор шаблона. Но так же часто, данный функционал вносит некорректное поведение при установки модификаторов или редактировании файлов напрямую. Если вам все же необходимо отредактировать файл шаблона и вы желаете использовать встроенный редактор шаблона, то придерживайтесь следующих правил. 1. Вы хотите внести небольшое изменение в шаблон, например заменить одну строчку и при этом у вас нет модификаторов которые затрагивают данный файл. 2. Вы редактируете шаблон Default по умолчанию, который присутствует сразу после установки движка (Не путать с быстрой установкой шаблона в котором есть установка движка) 3. Вы редактируете шаблон и при этом вносите много изменений. Но в то же время, вы знаете о всех возможных последствиях и способах их устранения. В любом другом случаи, рекомендуется редактировать файлы шаблона локально, загрузив их через ФТП менеджеры (FTP) например FileZilla Как правильно настроить ФТП менеджер вы можете посмотреть у своего хостинг провайдера, например статья в хостинг Бегет Так же в некоторых случаях допускается редактирование файлов через менеджер файлов в панеле управления хостингом. Пример https://beget.com/ru/manual/filem