admin

Модификаторы - OCMOD OCMOD - Модификаторы в OpenCart - это разновидность расширений, позволяющих вносить изменения в функционал или внешний вид, не затрагивая оригинальные файлы. Тем самым обеспечивается неизменность оригинальных файлов самого OpenCart, при том, что появляется возможность заменять или расширять необходимый функционал. История появления модификаторов началась с vQmod в opencart версии 1.5х, и уже в версии opencart 2x он был усовершенствоваван и преобразован в OCMOD. В отличии от vQmod который устанавливался отдельно, OCMOD внедрён по умолчанию как стандартный функционал в CMS OpenCart2х и выше. Модификатор OCMOD может быть как самостоятельным модулем, изменяющим или расширяющим стандартный функционал, так и входить в состав полноценного модуля с дополнительными php, tpl или twig и прочими файлами. Структура архива OCMOD модификатора image/catalog/doc/ru/ocmod/ocmod.jpg Название архива модификатора - должно быть задано в соответствии с требованиямя OCMOD - "название_файла".ocmod.zip , где вместо "название_файла" вы пишите свое название без кавычек. Таким образом, название архива всегда должно заканчиваться ".ocmod.zip", иначе система проигнорирует модификатор. Начиная с версии OpenCart 3x предполагается, что модификатор будет использоваться в составе полного модуля в виде архива - в отличии от OpenCart2x, где файл модификатора в виде "название_файла".ocmod.xml можно было загружать через установщик расщирений прямо в папку system, расположенную в корне сайта. Соответственно, при использовании файла модификатора в составе полного модуля и при его загрузке через административную часть в разделе Расширения > Установка расширений название файла-модификатора в архиве должно быть install.xml. В OpenCart 3x файл-модификатор также можно загрузить в папку system на постоянное размещение, используя FTP клиент, при условии, что название файла модификатора будет соответствовать требованиям OCMOD в виде "название_файла".ocmod.xml . Директории Кэш модификаторов - все изменённые модификатором файлы располагаются в папке system/storage/modification с такой же точно структурой папок, как и корень сайта, кроме папки image. Т.е. если вы сделали модификатор для файла /admin/controller/catalog/product.php то его измененная копия будет находится по пути system/storage/modification/admin/controller/catalog/product.php. Логи модификаторов - распалагаются в папке system/storage/logs , в ней находятся 2 основных лог-файла: ocmod.log - ведет запись об оработке и последовательности выполнении инструкций модификаторов, error.log - содержит ошибки, произошедшие при преобразовании. Обновление кэша модификаторов Чтобы система увидела файлы-модификаторы и выполнила их инструкции, необходимо нажать кнопку "Обновить" в правом верхнем углу на странице Модификаторы. Возможны ситуации, когда кэш обновлён, но изменения на сайте не вступили в силу. Обычно это связано с тем, что на сайте используются дополнительные модули кэширования, ускорители загрузки и т.п., в которых также необходимо обновить кэш. Синтаксис модификатора OCMOD Файл модификатора OCMOD обязательно должен содержать общую описательную часть и инструкции по изменению файлов: <?xml version="1.0" encoding="utf-8"?> <modification> <name>Мod</name> <!-- Название модификатора --> <code>mod_dev</code> <!-- Уникальный код модификатора --> <version>1.0</version> <!-- Версия модификатора --> <author>Develop</author> <!-- Автор модификатора --> <link>https://open-cart.ru</link> <!-- Сайт разработчика --> <file path="catalog/controller/product/category.php"> <!-- Файл который будет модифицироваться --> <operation> <search> <!-- Поиск кода в файле --> <![CDATA[ $result['name'], ]]> </search> <add position="after"> <!-- Добавление модификации (после найденного куска кода) --> <![CDATA[ 'sku' => $result['sku'], ]]> </add> </operation> </file> </modification> Данный пример модификатора меняет файл category.php. Он находит кусок строчки кода "$result['name']," и сразу за ним добавляет "'sku' => $result['sku'],". В одном xml файле может быть любое количество секций <file> и возможность менять любое количество файлов одним модификатором. Теги модификатора OCMOD и их функциональность Тег - File Указывает, в каком файле или файлах нужно внести изменения. Обязательный атрибут path содержит путь до изменяемого файла. Может указывать на один файл или на несколько. Для указания нескольких файлов, расположенных в разных папках, используется символ "|". Например, внести изменения в category.php, manufacturer.php, search.php и в special.php . <file path="catalog/controller/product/category.php|catalog/controller/extension/module/special.php"> Для сокращения кода можно использовать фигурные скобки, которые позволяют указать несколько значений через запятую: Например, внести изменения сразу в четыре файла category.php, manufacturer.php, search.php и в special.php. при этом суфикс .php можно вынести за фигурные скобки. . <file path="catalog/controller/product/{category,manufacturer,search,special}.php"> Так же можно использовать символы "*" и "?", чтобы указать путь по "маске". Бывает полезно для модификации файлов шаблонов. <file path="catalog/view/theme/*/template/product/category.twig"> Т.к. мы не знаем заранее, какие именно темы установлены в OpenCart, мы указали "*" после "theme", тогда будут модифицироваться все category.twig во всех шаблонах, находящихся в папке "theme". Тег - Operation Указывает начало секции производимой модификации. Внутри file секций <operation> может быть несколько. Т.е мы можем делать сразу несколько изменений в одном файле. Тег operation может иметь необязательный атрибут error, который может принимать значения: skip - в случае ошибки пропустить текущую секцию <operation> и перейти к следующей <operation> log (по умолчанию) - в случае ошибки пропустить всю секцию <file> и перейти к следующему <file> abort - в случае ошибки прервать все модификации в xml файле Например, найти в файле category.twig код "<div class="caption">" и если его нет, тогда пропустить и перейти к следующей операции и найти "<p class="price">". <file path="catalog/view/theme/*/template/product/category.twig"> <operation error="skip"> <search><![CDATA[<div class="caption">]]></search> <add position="after"><![CDATA[ <span class="sku">{{ product.sku}}</span> ]]></add> </operation> <operation error="skip"> <search><![CDATA[<p class="price">]]></search> <add position="before"><![CDATA[ <span class="sku">{{ product.sku}}</span> ]]></add> </operation> </file> Если не указать атрибут error="skip", тогда на первом поиске текста "<div class="caption">" вся секция <file> будет прервана и проигнорирована. Тег - Search Указывает, какой текст необходимо найти в текущей операции. Содержит несколько правил использования тега: Тег search может быть использован только 1 раз внутри секции operation. Поиск можно делать только 1 строки целиком или части строки (нельзя искать несколько строк одновременно). Искомый текст необходимо размещать строго между <![CDATA[ и ]]>. Пробелы и переносы строки до искомого текста и после искомого текста игнорируются, текст можно написать или сразу после CDATA или с новой строки после CDATA, если только не указан атрибут trim="false". Изменения применятся ко всем найденным в файле строчкам кода или их частям, если не указан атрибут index . Специальные теги <![CDATA[ и ]]> - используются в xml файлах для указания любых символьных данных, что означает, что между ними может находиться любой текст, содержащий скобки, значки больше, меньше и прочие, в том числе html и php код. Тег search содержит следующие атрибуты, которые используются для наиболее точного определения места внесения изменения: index - указывает, в каком по порядку найденном тексте внести изменения. Т.е. если в файле искомый текст встречается несколько раз, тогда index позволяет указать номер найденного по порядку текста (0 всегда первый найденный текст, 1 - второй и т.д.) Можно также указать несколько номеров через запятую. trim - указывает игнорировать (true) или нет (false) пробелы и переносы строк до и после искомого текста. regex - если установлено значении true, значит искомый текст представляет собой регулярное выражение для поиска. Пример: поиск атрибутом index среди схожих строчек кода. <file path="admin/controller/common/column_left.php"> <operation> <search index="0" trim="true"><![CDATA[ $data['menus'][] = array( ]]></search> <add position="before"><![CDATA[ $data['menus'][] = array( 'id' => 'new_menu', 'icon' => 'fa-menu', 'name' => 'New Menu', 'href' => 'new-menu/' ); ]]></add> </operation> </file> В примере по index найдена первая строчка кода "$data['menus'][] = array(" и перед ней добавляем свой код. Тег - Add Тег add содержит текст, который будет заменён или добавлен до или после искомого текста. Так же, как и тег search, тег add должен содержать <![CDATA[ и ]]>, между которыми вставляется текст кода, который будет добавлен или на который будет заменён искомый текст. Тег add имеет свои атрибуты: position - может принимать значения: replace (по умолчанию) - замена найденного текста before - добавить текст перед найденным текстом after - добавить текст после найденного текста offset - означает смещение относительно найденного текста на указанное количество строк. Если position="before", тогда смещение будет вверх от найденного текста, если position="after" или position="replace", тогда смещение будет вниз от найденного текста. trim - указывает игнорировать (true) или нет (false) пробелы и переносы строк до и после искомого текста. Пример: Добавим ссылку "Link" в футер на фронтальной части. <file path="catalog/view/theme/default/template/common/footer.twig"> <operation> <search index="1" trim="true"><![CDATA[ <ul class="list-unstyled"> ]]></search> <add position="after" offset="1" trim="true"><![CDATA[ <li><a href="#">Link</a></li> ]]></add> </operation> </file> Атрибут index="1" находит 2-й по порядку код <ul class="list-unstyled">, затем используя атрибут offset="1" на одну строку ниже найденного текста добавляет код <li><a href="#">Link</a></li>. Модификатор OCMOD позволяет в OpenCart расширить возможности, не затрагивая оригинальные файлы, а для возврата в исходное состояние вам просто будет достаточно удалить его.

Загрузка файлов в контроллер В платформе OpenCart MVC-L контроллер вашего модуля является связующим звеном, соединяющим файлы языка, модели и шаблона друг с другом. Контроллер отвечает за захват текста, содержащегося в языковом файле, и обеспечение его доступности в качестве переменных PHP в файле шаблона представления. В дополнение к наследованию функций, доступных в родительском классе контроллера, Controller, вы также можете загрузить любые файлы моделей OpenCart по умолчанию и их функции в контроллер. В этой документации мы покажем PHP-код, необходимый для загрузки файлов языка, модели и их функций. Загрузка языкового файла в Контроллере Контроллер выводит текст, хранящийся в языковом файле, и превращает его в переменные, которые могут быть воспроизведены в файле шаблона для отображаемого текста. Это особенно полезно для управления переводами вашего модуля. Вместо того, чтобы менять свой .файл tpl каждый раз, когда у вас есть новый перевод для изменения различных фрагментов текста внутри файла, вам просто нужно изменить текст в вашем языковом файле, и переменные в контроллере и шаблоне останутся такими же, как раньше. Приведенный ниже фрагмент кода загрузит языковой файл внутри контроллера вашего модуля. Внутри круглых скобок вам нужно будет указать путь к языковому файлу из языковой папки. $this->load->language('module/my_module'); Важно помнить, что контроллер администратора будет загружать только файл языка администратора, но не языковой файл каталога; и точно так же контроллер каталога будет загружать только языковой файл каталога. После того, как языковой файл будет загружен в контроллер,вы можете сохранить его текст в переменной php с использованием массива $data. $this->language->get('text') захватит текст из переменной $_['text'] внутри языкового файла. $this->data['text'] = $this->language->get('text'); $this->language->get('text') захватит текст из переменной $_['text'] внутри языкового файла, который мы только что загрузили выше. Каждый элемент массива данных будет преобразован в свою собственную переменную. $data ['text'] станет $text для файла шаблона внутри представления. Переменная $text может jnj,hf;fnmcz в файле представления .tpl, где это необходимо: <p><?php echo $text; ?></p> Подгрузка заголовка тайтла Следующий код установит текст из языкового файла в качестве заголовка страницы: $this->document->setTitle($this->language->get('heading_title')); Это приведет к захвату текста переменной $_['heading_title'], хранящейся в языковом файле модуля. Если вам нужно, чтобы текст хранился как переменная сеанса php, используйте $this->session->data['text'] вместо $this->data['text']. Загрузка файлов моделей Загрузка файлов модели в файл контроллера позволит вашему модулю использовать встроенные функции OpenCart. Функции внутри файлов модели взаимодействуют с базой данных магазина и позволяют добавлять / извлекать важную информацию для вашего модуля. Мы рекомендуем вам воспользоваться этими функциями, а не создавать собственные запросы к БД. Потратьте некоторое время на изучение папок модели в файлах администратора и каталога, чтобы увидеть, какие файлы могут принести пользу вашему модулю. Например, если вашему модулю необходимо извлечь информацию о товаре из базы данных магазина, будет полезно загрузить admin/model/catalog/products.php файл, так как он уже имеет множество полезных, встроенных функций, которые взаимодействуют с товарами магазина в базе данных. Ваш модуль может загрузить любой файл модели в свой файл контроллера, используя следующий код, при условии, что они находятся в той же папке администратора или каталога, что и контроллер. $this->load->model('setting/setting'); Вам нужно будет указать путь к файлу, который вы хотите загрузить из папки администратора, в скобках. Приведенный выше код загрузит класс settings, чтобы у нас был доступ к функциям в классе ModelSettingSetting в файле контроллера нашей модели. Используйте следующий формат кода для вызова функции из загруженного файла модели: $this->model_setting_setting->editSetting('my_module', $this->request->post); Подчеркивания относятся к обозначениям файлов для model/setting/setting.php. Если у вас есть файл модели, включенный для вашего модуля, ваш код будет следовать формату, указанному выше, так как файл модели загружается в папку model. $this->load->model(module/my_module.php); $this->model_module_my_module->myFunction(); Приведенный выше код загрузит my_module.php, хранящийся в папке admin/model/module/my_module.php. Вместо пробелов в именах файлов для вашего модуля используйте символы подчеркивания. Загрузка файлов шаблонов В контроллере вам нужно будет загрузить файл шаблона вашего модуля в представление. Для этого установите $this->template следующим образом: $this->template = 'module/my_module.tpl'; Загрузка файлов библиотеки Каталог OpenCart содержит коллекцию файлов библиотек, доступ к которым могут получить как администратор, так и файлы контроллера каталога. Эти файлы находятся в разделе system/library в корневой папке магазина OpenCart. В примерах кода, показанных при загрузке языкового файла, как $this->load->language, так и $this->document предоставляют доступ к функциям в файлах language.php и document.php в папке библиотеки. Если вы хотите получить доступ к функции в файле библиотеки, вам нужно вызвать ее с помощью $this->[insert library file name]->function() в классе контроллера. Дополнительная информация Дополнительные сведения о концепции поведения контроллера в рамках MVC framework или в контексте разработки модуля для OpenCart смотрите в разделе Разработка модулей .

Разработка новых каналов продвижения OpenCart включает в себя несколько полезных каналов продвижения товаров, но вы можете решить, что вам нужен собственный формат, и решите его создать. Написание каналов продвижения товаров OpenCart очень похоже на написание модулей OpenCart и может быть очень хорошим способом узнать, как на самом деле работают основы OpenCart. Как и остальная часть OpenCart, каналы следуют шаблону проектирования MVCL. В этом руководстве по документации будет описано, как вы можете использовать каждый из компонентов MVCL для создания административных и внешних частей вашего канала продвижения. Функциональность каналов в административной части Когда владелец магазина будет использовать ваш канал продвижения товаров, он захочет изменить параметры конфигурации канала продвижения в административной части, чтобы выбрать, включен ли он или нет, а также настроить любые конкретные параметры, которые вы сделаете доступными. Как разработчику модуля, вам нужно будет создать страницу администратора, где можно будет редактировать канал продвижения. Все файлы администратора находятся в папке admin /. Вы найдете четыре папки в папке admin /: controller view language model Для всех каналов продвижения потребуется по крайней мере один файл в каждой из папок view и controller. Для большинства из них потребуется файл в каждой из папок model и language. Обычно файлы имеют одно и то же имя, за исключением того, что файлы view имеют другой суффикс (.tpl). Мы будем просматривать эти файлы один за другим. Controller - Контроллер Первый файл, который вы создадите, будет контроллером для страницы интерфейса администратора вашего канала продвижения. OpenCart автоматически идентифицирует существующие каналы продвижения, просто прочитав папку admin/controller/feeds вашего магазина. Все каналы продвижения, существующие в этой папке, будут автоматически показаны на странице Каналы продвижения и на закладке Разрешения на странице Пользователи. Вы можете назвать свой файл контроллера my_feed.php. Файл контроллера будет иметь функцию, определенную как public function index(). Это общедоступная "страница", которая загружается по URL-адресу, который будет отображаться при нажатии кнопки редактирования и куда будет отправлена форма просмотра. Представленные данные будут обработаны в этой функции и сохранены в таблице базы данных "settings" через объект конфигурации контроллера. У вас также может быть функция, определенная как public function install(). Эта функция будет активирована при нажатии на ссылку Установить на странице Расширения > Каналы продвижения. Аналогично, функция, определенная как public function uninstall(), будет активирована при нажатии на ссылку удаления. Вы можете использовать эти функции для создания и удаления любых структур (например, таблиц базы данных или параметров конфигурации), необходимых вашему каналу продвижения. Рекомендуется создать функцию удаления, чтобы очистить все изменения, внесенные вашим модулем. View - Представление Второй необходимый файл для интерфейса администратора вашего канала продвижения - это файл view. Он будет создан в папке admin/view/template/feed и будет иметь суффикс .tpl или .twig . Это стандартно для файлов OpenCart view. В этом файле вы создадите форму для заполнения и отправки пользователем. Он будет передан в функцию index контроллера модуля. Самый простой способ создать файл представления - скопировать и вставить существующий аналогичный файл представления, а также отредактировать форму, чтобы она содержала правильные поля для параметров конфигурации вашего канала продвижения. Вы можете назвать свой файл представления my_feed.twig . Language - Язык Третий тип файлов, которые обычно необходимо создать для любого канала продвижения, - это языковые файлы. Вам понадобится один языковой файл для каждого языка, с которым ваш канал продвижения совместим. Языковой файл будет находиться в папке admin/language/<language name>/feed. Он просто содержит ассоциативный массив PHP с названием $_, который содержит внутреннее имя в качестве ключа и перевод в качестве значения. Вы можете назвать ваш языковой файл my_feed.php, так же, как файлы вашего контроллера и модели. Model - Модель Для фидов редко требуется файл модели на стороне администратора. Однако, если ваш канал продвижения использует собственную таблицу базы данных или пользовательский запрос для создания данных определенного формата, вы можете написать файл модели. Примером этого может быть, если вы пишете фид счетчика посетителей, где каждый посетитель хранится в таблице базы данных со своим IP-адресом и количеством посещений. Вы можете создать файл модели с функцией для определения и создания этой дополнительной таблицы в базе данных OpenCart. Файл модели будет находиться в папке admin/model/feed. Вы можете назвать файл модели my_feed.php, так же, как ваш контроллер и языковые файлы. Функциональность внешнего интерфейса канала продвижения Внешний интерфейс вашего канала продвижения следует той же схеме, что и только что описанный интерфейс администратора. То, что вы будете включать в каждый из ваших файлов внешнего интерфейса, во многом будет зависеть от того, что должен делать ваш канал продвижения. Фид может получить доступ к любым файлам моделей, которые уже существуют в OpenCart, вам не нужно писать свои собственные запросы к базе данных, если такой же запрос уже существует. Например, модель catalog/product содержит много полезных запросов для извлечения товаров. Не изобретайте колесо, отдавайте предпочтение уже имеющимся функциям модели. Ключевым отличием в интерфейсе вашего канала продвижения является то, что ваш файл представления будет находиться в папке catalog/view/theme/(themename)/template/feed. Это значительно более глубокая структура папок для файла представления администратора из-за тем. В магазине OpenCart может быть доступно множество различных тем интерфейса, но только один шаблон администратора. (themename) В интерфейсной части вашего канала продвижения вы будете иметь доступ к параметрам конфигурации, сохраненным вашим фидом, как через объект config контроллера, так и через переменную $settings, переданную в функцию index контроллера модуля. Вы можете управлять аспектами отображения интерфейса на основе этих настроек.

Разработка Модулей Написание модулей OpenCart может быть очень хорошим способом узнать, как на самом деле работают основы OpenCart. Как и в остальной части OpenCart, модули следуют шаблону проектирования MVCL. В этом руководстве по документации будет описано, как можно использовать каждый из компонентов MVC-L для создания административной и интерфейсной частей вашего модуля. Самый простой способ создать модуль - это загрузить скелет DIY Module Builder из HostJars. Этот модуль содержит структуру каталогов, файлы и инструкции по пониманию и построению собственных модулей. Эта страница является более теоретическим руководством. Основная структура каталогов Основная структура файлов для вашего модуля будет разделена на две части: папки admin и catalog. Содержимое каждой папки будет соответствовать структуре MVC-L соответственно, с той разницей, что администратор будет иметь дело исключительно с бэкенд-функциональностью, а каталог-с функционалом веб-интерфейса. Пользователи вашего модуля будут взаимодействовать и настраивать его параметры в административной части магазина. Поэтому файлы в папке admin будут обрабатывать любые изменения его настроек, способ отображения модуля в административной части, установку / удаление модуля и т.д. Аналогичным образом, способ отображения модуля и его работа в интерфейсе пользователя магазина будет обрабатываться файлами в папке catalog. На рисунке выше показана схема структуры каталогов, которой должен следовать ваш модуль. Хороший способ начать работу с вашим модулем - это продублировать структуру папок и создать указанные выше файлы. То, что будет идти в этих файлах определяется тем, что ваш модуль пытается выполнить, но основные функциональные возможности подробно описаны в разделах ниже. Функциональность модуля в админ части Когда владелец магазина будет использовать ваш модуль, он захочет отредактировать параметры конфигурации модуля в административной части, чтобы решить, на каких макетах отображать модуль, включен ли он или отключен, а также настроить любые конкретные параметры модуля. Как разработчику модуля, вам нужно будет создать страницу администратора, где модуль может быть отредактирован, а параметры конфигурации добавлены или скорректированы. Все файлы администратора находятся в папке admin/. Вы найдете ещё четыре папки в папке admin/: controller view language model Для всех модулей потребуется по крайней мере один файл в каждой из папок view и controller. Для большинства из них потребуется файл в каждой из папок model и language. Обычно файлы имеют одно и то же имя, за исключением того, что файлы view имеют другой суффикс (.tpl). Мы будем просматривать эти файлы один за другим. Controller - Контроллер Первый файл, который вы создадите, будет контроллером для страницы интерфейса администратора вашего модуля. OpenCart автоматически идентифицирует существующие модули, просто прочитав папку admin/controller/module вашего магазина. Все модули, существующие в этой папке, будут автоматически показаны на странице Модули и на закладке Разрешения на странице Пользователи. Вы можете назвать свой файл контроллера my_module.php. Файл контроллера - это место, где вы можете загрузить языковые файлы для преобразования текста в переменные, которые будут использоваться в файле шаблона. На диаграмме выше вы можете видеть, как переменная $_['text'] обрабатывается контроллером, а затем отправляется в виде $text в view. Здесь вы также будете использовать несколько файлов моделей и их функции класса , включая файл модели вашего модуля, если он есть. Дополнительные сведения о загрузке файлов см. в разделе Загрузка файлов в контроллер. У вас также может быть функция, определенная как public function install(). Эта функция будет активирована при нажатии на ссылку Установить на странице Расширения > Модули. Аналогично, функция, определенная как public function uninstall(), будет активирована при нажатии на ссылку удаления. Вы можете использовать эти функции для создания и удаления любых структур (например, таблиц базы данных или параметров конфигурации), необходимых вашему модулю. Рекомендуется создать функцию удаления, чтобы очистить все изменения, внесенные вашим модулем. Чтобы просмотреть конкретный код для установки (), удаления (), посетите раздел Установка/удаление модуля. Доступ по URL-адресу Контроллер является единственным файлом в структуре MVC-L, к которому можно получить доступ по URL в OpenCart. В администрировании URL-адрес будет выглядеть как /admin/index.php?route=module/my_module&token. Администратор добавляет маркер к URL-адресу, в то время как ссылка в каталоге не будет иметь его. В результате файл контроллера будет иметь функцию, определенную как public function index(). Это общедоступная "страница", которая загружается по URL-адресу, который будет отображаться при нажатии кнопки редактирования и куда будет отправлена форма просмотра. Представленные данные будут обработаны в этой функции и сохранены в таблице базы данных "settings" через объект конфигурации контроллера. View - Представление Второй необходимый файл для интерфейса администратора вашего модуля - это файл view. Он будет создан в папке admin/view/template/module и будет иметь суффикс .tpl или .twig . Это стандартно для файлов OpenCart view. В этом файле вы создадите форму для заполнения и отправки пользователем. Она будет передана в функцию index контроллера модуля. Самый простой способ создать файл представления - скопировать и вставить существующий аналогичный файл представления, а также отредактировать форму, чтобы она содержала правильные поля для параметров конфигурации вашего модуля. Вы можете назвать свой файл представления my_module.twig . В представлении вы сможете получить доступ к тексту с языка, на котором файл контроллера хранится как переменная PHP. Смотрите раздел Загрузка файлов в контроллер для получения кода о том, как это сделать. Model - Модель Обычно модулям требуется файл модели на стороне администратора. Однако если ваш модуль использует собственную таблицу базы данных или пользовательский запрос для создания данных определенного формата, то вы можете написать файл модели. Примером такой ситуации может быть написание модуля счетчика посетителей, где каждый посетитель хранится в таблице базы данных со своим IP-адресом и количеством посещений. Вы можете создать файл модели с функцией для определения и создания этой дополнительной таблицы в базе данных OpenCart. Файл модели будет находиться в папке admin/model/module. Вы можете назвать свой файл модели my_module.php, аналогично названию файлов вашего контроллера и языковых файлов. Функциональность внешнего интерфейса Внешний интерфейс вашего модуля следует той же схеме, что и только что описанный интерфейс администратора. То, что вы будете включать в каждый из ваших файлов внешнего интерфейса, во многом будет зависеть от того, что должен делать ваш модуль. Модуль может получить доступ к любым файлам моделей, которые уже существуют в OpenCart, вам не нужно писать свои собственные запросы к базе данных, если такой же запрос уже существует. Например, модель catalog/product содержит много полезных запросов для извлечения товаров. Не изобретайте колесо, отдавайте предпочтение уже имеющимся функциям модели. Ключевым отличием в интерфейсе вашего модуля является то, что ваш файл представления будет находиться в папке catalog/view/theme/(themename)/template/module. Это значительно более глубокая структура папок для файла представления администратора из-за тем. В магазине OpenCart может быть доступно множество различных тем интерфейса, но только один шаблон администратора. (themename) В интерфейсной части вашего модуля вы будете иметь доступ к параметрам конфигурации, сохраненным вашим модулем, как через объект config контроллера, так и через переменную $settings, переданную в функцию index контроллера модуля. Вы можете управлять аспектами отображения интерфейса на основе этих настроек.

Раздел статистики В меню Отчеты > Статистика можно отслеживать общую стоимость всех продаж, заказов в обработке, завершённых и прочих заказов, возвратов, товаров которых нет в наличии и отзывов, ожидающих одобрение на сайте. Название: Наименование отслеживаемого параметра. Значение: Количество или сумма Действие: Обновление и актуализация данных

Отчёт об онлайн пользователях Раздел отчетов Покупатели онлайн используется для отслеживания активности покупателей, которые в данный момент находятся в сети и просматривают витрину магазина OpenCart. Примечание! Если вы не видите никаких людей в интернете, вам нужно перейти в Систему > Настройки > Редактирование > Опции, далее прокрутите вниз до "Учетной записи" и выберите "Да" напротив пункта "Покупатели онлайн". Чтобы получить доступ к разделу Покупатели онлайн, щелкните Отчеты > Покупатели онлайн: Как только вы перейдете в раздел, вы увидите справа фильтр, позволяющий ввести IP-адрес и имя клиента, которого вы хотите отслеживать. Таблица отчетов, отображающая результаты отчётов об пользователях онлайн, содержит следующее поля: IP: IP-адрес, с которого пользователь в данный момент просматривает витрину магазина. Покупатель: Имя покупателя Последняя просмотренная страница: Страница, которую пользователь последний раз посещал перед уходом с сайта. Откуда перешел: Страница, с которой пришел пользователь Последний клик: Время и дата последнего клика клиента. Действие: Кнопка, которая позволит вам получить доступ к учетной записи покупателя.

Описание Отчётов в OpenCart В систему OpenCart встроен инструмент аналитики, которая позволяет получать отчетность по различным действиям происходящими на сайте. В разделе Отчеты мы можем ознакомится с отчетами по двенадцати различным пунктам, такими как: Транзакции покупателей Активность покупателей Заказы покупателей Бонусные баллы покупателей Поисковые запросы Налоги Доставка Возвраты Продажи Купоны Просмотры товаров Продажи товаров Маркетинговый отчет Каждый из отчетов предоставляет более-менее подробную информацию по активности покупателя, просмотрам и продажам товаров и прочую аналитику. Отчёты по транзакциям покупателей Инструмент отчетов по начисленным транзакциям покупателей Транзакции покупателей Покупатель: Имя клиента. E-mail: Электронный почтовый адрес покупателя, указанный при регистрации. Группа:. Группа покупателей к которой относится конкретный покупатель. Статус: Статус покупателя "Включен" или "Отключен". Итого: Общая сумма всех начисленных транзакции покупателю. Действие: Платеж совершен или отменен. Отчеты по активности клиентов Этот раздел отчётов предоставляет список последних действий покупателей. Фильтр для всех ваших клиентов и их активности по периоду времени. Вы можете видеть имя учетной записи каждого клиента, его IP-адрес и вид активности на каждую дату. Активность покупателей Комментарий: Имя покупателя и краткое описание какого либо совершенного им действия, к примеру: создан заказ, добавлен отзыв, изменен адрес и прочие действия. IP: Выводит IP адрес с которого покупатель посещал сайт. Дата: Вывод даты с точным временем совершения определённого действия. Отчёты по заказам покупателей Данный отчет по заказам покупателей предоставляет подробную информацию о заказах каждого покупателя. Заказы покупателей Покупатель: Имя клиента E-mail: Электронный почтовый адрес покупателя, указанный при регистрации. Группа:. Группа покупателей к которой относится конкретный покупатель. Статус: Статус покупателя "Включен" или "Отключен". Количество заказов: Общее количество заказов, сделанных конкретным покупателем. Количество товаров: Общее количество товаров, заказанных конкретным покупателем. Итого: Общая сумма заказов. Действие: Кнопка редактирования учётной записи покупателя. Отчёты по бонусным баллам покупателей Подробные отчёты предоставляются по каждому покупателю. Помимо основных идентификационных данных покупателя добавлен пункт "Баллы", которые начисленны за покупку товаров и т.д.. Указывается общее количество начисленных покупателю баллов за одну покупку, или если клиент купил несколько товаров. Бонусные баллы покупателей Покупатель: Имя клиента E-mail: Электронный почтовый адрес покупателя, указанный при регистрации. Группа:. Группа покупателей к которой относится конкретный покупатель. Статус: Статус покупателя "Включен" или "Отключен". Баллы: Общее количество бонусных баллов, начисленных конкретному покупателю. Количество заказов: Общее количество заказов, сделанных конкретным покупателем. Итого: Общая сумма заказов. Действие: Кнопка редактирования учётной записи покупателя. Отчёты по поисковым запросам Роздел подробных отчетов с фильтрацией данных по поисковым запросам, производимым покупателями на витрине магазина. Поисковые запросы Запрос: Запрос в поисковой строчке сайта, который сделал покупатель. Найдено товаров: Количество товаров найденых по данному запросу. Категория: Категория, к которой принадлежат товары. Покупатель:. Имя покупателя, сделавшего запрос. IP. Адрес клиента, сделавшего запрос. Дата. Дата поиска по сайту. Отчёты по Налогам Этот инструмент налогового отчета показывает, какой тип налога оплачивается больше всего покупателями. Налоговая информация отображается с ежедневным, еженедельным, ежемесячным или ежегодным периодом времени в зависимости от настроек фильтра Налоги Дата начала: Дата начала отслеживаемого периода времени, в зависимости от параметров фильтра. Дата окончания: Дата окончания отслеживаемого периода времени, в зависимости от параметров фильтра. Налог: Наименование используемого типа налога. Заказов: Количество совершённых заказов в определёный период времени. Итого: Общая сумма денег, уплаченных за налоги покупателями в заданый период времени. Отчёты по доставкам Инструмент отображения отчетов о способах доставки, использумых покупателями при совершении заказов. Информация о способах доставки отображается с ежедневным, еженедельным, ежемесячным или ежегодным периодом времени, в зависимости от настроек фильтра Доставки Дата начала: Дата начала отслеживаемого периода времени, в зависимости от параметров фильтра. Дата окончания: Дата окончания отслеживаемого периода времени, в зависимости от параметров фильтра. Способ доставки: Название используемого способа доставки. Заказов: Количество совершённых заказов в определёный период времени. Итого: Общая сумма денег, уплаченных за доставку в определёный период времени. Отчёты по возвратам Отчет о возвратах показывает, сколько возвратов было запрошено в течение заданного периода времени. Информация о возврате отображается с ежедневным, еженедельным, ежемесячным или ежегодным периодом, в зависимости от того, какой параметр выбран в фильтре. Возвраты Дата начала: Дата начала отслеживаемого периода времени, в зависимости от параметров фильтра. Дата окончания; Дата окончания отслеживаемого периода времени, в зависимости от параметров фильтра. Возвратов: Показывает количество запросов на возврат, отправленных покупателями и / или созданных в определённый период времени. Отчёты по продажам Отчет о количестве продаж по определённым периодам времени. Используя фильтр, можно сгруппировать данные по дням, неделям, месяцам и годам. Выводит данные: за период, количество совершенных заказов, количество купленных товаров, налог и общую сумму продаж. Продажи Дата начала: Дата начала отслеживаемого периода времени, в зависимости от параметров фильтра. Дата окончания: Дата окончания отслеживаемого периода времени, в зависимости от параметров фильтра. Заказов: Общее количество совершённых заказов в определёный период времени. Товаров: Общее количество товаров, купленных в определёный период времени. Налог: Общая сумма оплаченных покупателями начисленных налогов. Итого: Общая сумма продаж за определёный период времени. Отчёты по использованным купонам Отчет по купонам отслеживает использование купонов покупателями в магазине на OpenCart. Купоны Купон: Наименование купона. Код: Код купона, который использовался покупателем. Заказы: Количество заказов, при которых использовали конкретный купон. Итого: Общая сумма всех использованных купонов. Так как покупатель использует купон для получения скидки на товар или заказ - итог является отрицательным числом. Действие: Кнопка редактирования конкретного купона Отчёты по просмотрам товаров Инструмент отчетов по просмотренным товарам дает представление о том, какие товары просматриваются больше или меньше всего посетителями вашего магазина. В отчете, помимо наименования самого товара, будет отображаться количество посетителей, которые просматривали конкретный товар, и процент просмотров в соотношении к другим товарам. Кнопка Сбросить которая размещена справа вверху в таблице отчетов, очищает информацию по данным отчётам. Просмотры товаров Название товара: Наименование товара. Модель: Модель или код товара. Просмотров: Количество просмотров посетителями. Процент: Соотношение просмотров ко всем товарам в процентах. Отчёты по продажам товаров Этот инструмент отчетов предоставляет данные о количестве продаж конкретных товаров. Удобен для понимания, какие товары стоит продвигать в поисковых системах для увеличения их продаж. Продажи товаров Название товара: Наименование товара. Модель: Модель или код товара. Количество: Количество проданных товаров. Итого: Общая сумма с продаж товара.

Журнал ошибок - логи Если пользователь столкнется с ошибкой в магазине, эта ошибка будет отображена в журнале ошибок в разделе Система > Обслуживание > Журналы ошибок. Этот раздел может быть использован веб-разработчиками для отслеживания ошибок при написании кода для магазина. Журнал ошибок может со временем переполниться, поэтому рекомендуется время от времени очищать журнал. Нажатие кнопки "Очистить журнал" очистит список ошибок.

Внешние Загрузки Для доступа к разделу загрузки в админ-панели OpenCart выберите Система > Обслуживание > Загрузить: В этом поле отображаются все загруженные файлы, хранящиеся в вашем магазине OpenCart. Это могут быть изображения, PDF-файлы и т. д. Здесь есть кнопка фильтра, которая сортирует загруженные файлы в соответствии с названием файла и датой, когда он был добавлен. Кнопка Действие с правой стороны позволяет загрузить конкретный файл из вашего магазина OpenCart. Соответственно, кнопка Удалить позволяет удалить выбранный файл.

Бекап и Восстановление системы Одним из самых разрушительных событий, которые могут произойти с интернет-магазином, является потеря базы данных. База данных магазина содержит важную информацию о клиентах и товарах. Магазину трудно восстановиться после потери базы данных, и, конечно, потребуется слишком много времени, чтобы повторно ввести эту необходимую информацию. Вы должны быть бдительны при загрузке обновленных резервных копий базы данных магазина на свой компьютер, на тот случай, если что-то произойдет. OpenCart позволяет загрузить резервную копию текущей базы данных магазина или восстановить базу данных для администрирования в меню Система> Резервное копирование/восстановление. В приведенном ниже разделе резервного копирования содержатся все таблицы данных в базе данных MySQL, доступные для скачивания. Вы можете выбрать, какие файлы вы хотите скачать. При нажатии кнопки "Экспорт" выбранные таблицы будут загружены на ваш компьютер. Если вам нужно восстановить файл резервной копии, который вы ранее сохранили на своем компьютере, все, что вам нужно сделать, это нажать кнопку Импорт из резервной копии восстановления, выбрать файл sql со своего компьютера, и база данных будет восстановлена.

Весовая категория Подобно классам длины, весовые классы используются для назначения весовых спецификаций товарам на вкладке Данные. Для создания новой весовой категории требуется следующая информация: Название единицы веса: Название единицы измерения веса (к примеру килограмм) Единица веса: Единицы измерения (кг или гр) Значение: Установите значение по умолчанию 1. Каждое значение, добавленное к другим Весам, таким как г, должно быть определено относительно этого значения. В 1 кг, - 1000 г поэтому значение г будет равно 1000.

Размеры длина \ ширина \ высота Классы длины используются для назначения спецификаций длины товаров во вкладке Данные. Значения, добавленные к товарам, будут отображаться на странице продукта в витрине магазина. Для создания нового класса длины требуется следующая информация: Название единицы измерения: Название измерения длины (например, сантиметр) Единица измерения: Единица измерения (см или мм) Значение: Установите значение по умолчанию 1. Каждое значение, добавленное к другим длинам, таким как км, должно быть определено относительно этого значения. В одном 1см - 10 мм в, так что значение мм будет равно 10.

Налоги Раздел Налоги в Локализации позволяет администратору создавать налоги, которые будут применяться к конкретным товарам в магазине. Налоговые Ставки Налоговая ставка будет использоваться для расчета налогов из заказа. Для сохранения налоговой ставки в администрировании необходима следующая информация: Название: Название налога, которое будет отображаться на витрине магазина при добавлении налогов к общей сумме заказа. Ставка: Числовое значение для налога. Тип: Определяет, является ли числовое значение налоговой ставки фиксированной суммой или процентом от общей суммы заказа. Группа покупателей: При выборе группы покупателей этот налог будет добавлен ко всем покупателям в этой группе. Можно выбрать сразу несколько групп покупателей. Географическая зона: При выборе геозоны налог будет применяться к регионам и странам, входящим в геозону. Налоговые классы Налоговые классы могут хранить несколько налоговых ставок в одной категории. Налоги можно настроить для расчета налогов на основе платежного адреса (клиента) или адреса магазина. Для налоговых классов требуется следующая информация: Название налогового класса Описание Налоговая ставка: выбрав "Добавить правило", вы добавите налоговую ставку, созданную в разделе налоговые ставки. В поле "Основана на" обязательно надо выбрать либо платежный адрес, либо адрес магазина. Это позволит определить сумму налога, добавленную к общей сумме корзины покупок в витрине магазина. Приоритет определяет позицию налоговой ставки, если вместе с ней указаны другие налоговые ставки. Налоговый класс должен быть добавлен к каждому товару отдельно, чтобы можно было применять налоговые ставки при его покупке. Поле Налоговый класс находится на вкладке Данные в разделе Товары. Дополнительную информацию смотрите в разделе Товары.

Географические зоны Геозоны - это настраиваемые зоны, используемые при расчете стоимости доставки и налогов. Для настройки способов доставки в одну геозону можно добавить несколько стран и зон. Геозона ниже используется для объединения западных штатов США в одну зону. Западное побережье США состоит из штатов Калифорния, Орегон и Вашингтон. Каждый отдельный штат добавляется путем выбора страны, зоны, и нажатия на кнопку "Добавить геозону". Дополнительные сведения об использовании геозон см. в разделе Доставка.

Регионы По умолчанию при установке OpenCart в разделе Регионы находится список из 3948 зон (регионов). Зоны - это конкретные регионы стран, такие как штат или провинция. Создание зон помогает оценить налоги и доставку на витрине магазина.

Страны По умолчанию при установке OpenCart в разделе Страна находится список из 239 стран. Эти страны можно использовать для оценки доставки и налогов, если клиент в них находится. Каждая страна может быть индивидуально отключена, удалена с витрины магазина, отредактирована. Страны также могут быть удалены. Единственная проблема с удалением страны заключается в том, что информация о стране будет удалена вместе с ней. Если вы хотите сделать эту страну доступной для доставки, вам придется повторно ввести информацию о стране; в то время как включить страну, ранее отключенную, проще.

Возвраты Раздел Возвраты позволяет создавать статусы возврата, действия возврата и названия причин возврата, которые могут быть выбраны в запросах возврата. Дополнительные сведения об использовании этих имен возврата см. в разделе Возвраты. Причину возврата можно найти на странице возврата товара в магазине, ее можно найти в разделе обслуживания клиентов внизу страницы на витрине магазина.

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

Статус состояние на складе В этом разделе вы можете создать статус "Нет в наличии", который будет отображаться на странице товара, когда его нет в наличии. Название статуса является произвольным. Состояние по умолчанию для товаров на складе может быть отредактировано на вкладке параметров в настройках. Конкретный статус "Нет в наличии" для товара можно изменить на вкладке "Данные" в разделе "Товары.

Валюты Раздел Валюты позволяет выбрать, какие валюты доступны для использования в витрине магазина. В валюте по умолчанию будут отображаться все цены товаров в магазине. Валютные предпочтения могут быть изменены клиентом в разделе заголовка любой страницы. В OpenCart по умолчанию включены валюты евро, фунт и доллар США. Для добавления новой валюты в магазин необходима следующая информация: Название валюты Код: ISO-код валюты. Коды валют можно посмотреть здесь currency converter. Символ слева: Добавляет символ валюты слева от кода. Символ справа: Добавляет символ валюты справа от кода. Кол-во знаков после запятой: Количество десятичных знаков, отображаемых в цене на витрине магазина. Значение: Для валюты по умолчанию будет установлено значение 1. Каждое значение валюты будет относительно этого значения. Так как доллар США равен 1,0 (по умолчанию), то в таблице используется евро .81 со значением, основанным на его ценности. Когда OpenCart переходит между валютами в витрине магазина, он будет использовать номер значения для расчета цен продуктов в этой новой валюте. OpenCart обновит значения валют на вкладке Локализация в разделе настройки магазина, если включено автоматическое обновление валюты. Статус: Включает или отключает валюту на витрине магазина.

Языки - Локализация Раздел Локализация > Языки позволяет управлять языками, доступными для витрины магазина. OpenCart предоставляет английский язык в качестве языка по умолчанию после установки. Для добавления нескольких языков на сайт, необходимо установить языковой пакет. Языковые пакеты можно приобрести из каталога расширений. См. раздел Добавление нескольких языков, чтобы узнать, как добавить языковой пакет в OpenCart. Если новый языковой пакет уже установлен в OpenCart store, то новый язык можно добавить на сайт в разделе Система -> Локализация -> Языки. Нажмите кнопку Добавить в правом верхнем углу, чтобы добавить новый язык. Для заполнения потребуется следующая информация: Название языка * Указать название языка в магазине OpenCart. Код * Код языка ISO. Полный список USO кодов смотрите на W3Schools. Кодировка * Код, используемый браузерами для автоматического определения языка сайта. Коды локали можно посмотреть тут. Статус Включает или отключает язык на витрине магазина. Порядок сортировки Определяет положение языка среди нескольких языков в заголовке.

Адреса магазинов Если у вашего интернет-магазине есть один или несколько физических магазина, вы можете добавить информацию об их местоположении в свою систему OpenCart. Таким образом, пользователям сети будет легко узнать, где находится ваш магазин. Выберите Система > Локализация > Адрес магазина: Вы откроете раздел местоположения магазинов, где найдете всю информацию о ваших физических магазинах. Есть два основных поля - Название магазина и Адрес. Когда вы закончите вводить информацию о вашем магазине, она появится в этом разделе. У вас будет возможность впоследствии редактировать информацию о каждом конкретном магазине. Начните с нажатия кнопки "Добавить новый": Сведения о местоположении магазина В следующем разделе будут показаны все пустые поля, которые вы должны заполнить сведениями о вашем физическом магазине. Обязательными полями являются Название магазина, Адрес и Телефон. Geocode \ Геокод - этот код использует географические координаты вашего адреса. Например, такой адрес, как 103 Integer Rd. Corona New Mexico 08219 будет преобразована в широту 34.249772 и долготу -105.603535. Геокодирование используется для размещения вашего маркера на карте. Факс - введите свой номер факса, если он у вас есть. Изображение - поместите изображение или логотип вашего магазина для более легкого распознавания. Время работы - перечислите часы открытия и закрытия вашего магазина. Комментарий - это поле для любых специальных пометок, которые вы хотите оставить для своих покупателей. Например, "Чеки не принимаются", или что либо другое. Отображение местоположения магазина на странице Контакты После завершения ввода сведений о физическом местоположении магазина перейдите в раздел Система > Настройки > Витрина: Прокрутите до самого низа, и вы увидите поле с названием "Местоположение магазина". Если вы хотите, чтобы местоположение отображалось на странице "Контакты", включите его, нажав на галочку. Теперь это местоположение активно и будет отображаться на странице "Контакты" вашего сайта OpenCart. Если вы хотите удалить сведения о магазине, вы можете выбрать его галочкой слева и нажать кнопку "Удалить" в правом верхнем углу.

API Для использования OpenCart API вы должны предварительно включить его в административной части вашего сайта. Перейдите в Система > Пользователи > API, и вы увидите пользователя, созданного по умолчанию, с API Username "Default". При добавлении нового пользователя по умолчанию не будет никакого API-ключа, его необходимо с генерировать, нажав на кнопку "Генерировать" и установив "Статус" в положение "Включено. Затем добавьте свой IP-адрес в список разрешенных для доступа к API на вкладке "IP адрес". API доступен через URL-адрес, такой, как http://example.com/index.php?route=api/cart/add где в параметре route указывается нужный контроллер. Примечание: У API пользователей поле customer_id всегда '0'. У них есть свой собственный api_id. Для примеров использована библиотека python-requests, но основная идея заключается в описании параметров, поэтому console curl будет достаточно. И в описаниях предполагается, что у нас есть префикс "oc_" в таблицах БД. В первую очередь, вы можете и обязательно должны получить токен для вашей сессии - вы получаете файл cookie, и сервер OpenCart будет идентифицировать вашу активность таким образом. import requests s = requests.Session() username = 'Default' key='L3MYyzlYMRL8gBcpCm6CdrVarFUXtPORZkJKP7vgaY8M8EIZWOr3EJxq' # Actually, key is 256 character-long s.post( 'http://myopencart.example.com/index.php?route=api/login', data={'username':username, 'key':key} ).text Если все было сделано правильно, вы получите json-ответ с помощью api_token для вашего сеанса. Проверьте страницу API в административной части сайта, нажмите "Редактировать" на пользователе API и откройте вкладку "Сессия" - там вы можете увидеть установленную сессию. Что вы можете сделать с OpenCart API? Логин - Вход api/login Создание сессии для пользователя API по ключу PARAMS: DATA: username: username из таблицы oc_api key: key из oc_api ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/shipping/address', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'username':username, 'key':key } ) Валюта api/currency ОПИСАНИЕ: изменить валюту сессии PARAMS: api_token DATA: currency: code из таблицы oc_currency ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/currency', params={'api_token':'768ef1810185cd6562478f61d2'}, data={'currency':'USD'} ) Корзина api/cart/add ОПИСАНИЕ: добавление товара в корзину PARAMS: api_token DATA: product_id: product_id из таблицы oc_cart quantity: quantity из таблицы oc_cart option: option array из таблицы oc_cart ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/cart/add', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'product_id':'100' 'quantuty':'1' } ) api/cart/edit ОПИСАНИЕ: редактирование количества товара в корзине PARAMS: api_token DATA: key: cart_id из таблицы oc_cart quantity: quantity из таблицы oc_cart ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/cart/edit', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'key':'10' 'quantuty':'2' } ) api/cart/remove ОПИСАНИЕ: удаление товара из корзины PARAMS: api_token DATA: key: cart_id из таблицы oc_cart ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/cart/remove', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'key':'10' } ) api/cart/products ОПИСАНИЕ: содержимое корзины PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/cart/products', params={'api_token':'768ef1810185cd6562478f61d2'}, data={} ) Купоны api/coupon ОПИСАНИЕ: применить существующий купон PARAMS: api_token DATA: coupon: code из таблицы oc_coupon; ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/coupon', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'coupon':'2222' } ) Покупатель api/customer ОПИСАНИЕ: назначить покупателя для текущей сессии PARAMS: api_token DATA: firstname: lastname: email: telephone: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/customer', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'firstname':'Dear', 'lastname':'Customer', 'email':'customer@example.com', 'telephone':'+1 879 2548022'} } ) Подарочные сертификаты api/voucher ОПИСАНИЕ: применить существующий подарочный сертификат PARAMS: api_token DATA: voucher: code из таблицы oc_voucher; ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/voucher', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'voucher':'VOU-7271' } ) api/voucher/add ОПИСАНИЕ: добавить новый подарочный сертификат для текущей сессии PARAMS: api_token DATA: from_name: from_name из таблицы oc_voucher from_email: from_email из таблицы oc_voucher to_name: to_name из таблицы oc_voucher to_email: to_email из таблицы oc_voucher amount: amount из таблицы oc_voucher в выбранной валюте code: code из таблицы oc_voucher ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/voucher/add', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'from_name':'MyOpenCart Admin' 'from_email':'admin@example.com' 'to_name':'Dear Customer' 'to_email':'customer@example.com' 'amount':'100' 'code':'VOU-7177' } ) Доставка api/shipping/address - ОПИСАНИЕ: добавить адрес доставки к текущей сессии PARAMS: api_token DATA: firstname lastname address_1 city country_id zone_id ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/shipping/address', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'firstname':'Customer', 'lastname':'Dear', 'address_1':'Somewhere', 'city':'KLD', 'country_id':'RUS', 'zone_id':'KGD' } ) api/shipping/methods ОПИСАНИЕ: возврат доступных способов доставки PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/shipping/methods', params={'api_token':'768ef1810185cd6562478f61d2'}, ) api/shipping/method ОПИСАНИЕ: установить способ доставки для текущей сессии PARAMS: api_token DATA: shipping_method ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/shipping/method', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'shipping_method':'pickup.pickup' } ) Бонусы api/reward ОПИСАНИЕ: PARAMS: api_token DATA: EXAMPLE: session.post( 'http://myopencart.example.com/index.php?route=api/reward', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ } ) api/reward/maximum ОПИСАНИЕ: PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/reward/maximum', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ } ) api/reward/available ОПИСАНИЕ: PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/reward/avaliable', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ } ) Заказ api/order/add ОПИСАНИЕ: новый заказ по содержимому корзины и информации об оплате / доставке был установлен в текущй сессии PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/order/add', params={'api_token':'768ef1810185cd6562478f61d2'}, ) api/order/edit ОПИСАНИЕ: PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/order/edit', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ } ) api/order/delete ОПИСАНИЕ: PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/order/delete', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ } ) api/order/info ОПИСАНИЕ: PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/order/info', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ } ) api/order/history ОПИСАНИЕ: PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/order/history', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ } ) Оплата api/payment/address ОПИСАНИЕ: установить адрес оплаты для этой сессии PARAMS: api_token DATA: firstname lastname address_1 city country_id zone_id ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/payment/address', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'firstname':'Customer', 'lastname':'Dear', 'address_1':'Somewhere', 'city':'KLD', 'country_id':'RUS', 'zone_id':'KGD' } ) api/payment/methods ОПИСАНИЕ: возврат доступных способов оплаты PARAMS: api_token DATA: ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/payment/methods', params={'api_token':'768ef1810185cd6562478f61d2'}, ) api/payment/method ОПИСАНИЕ: настройка способа оплаты доступна в api/payment/methods PARAMS: api_token DATA: payment_method ПРИМЕР: session.post( 'http://myopencart.example.com/index.php?route=api/payment/method', params={'api_token':'768ef1810185cd6562478f61d2'}, data={ 'payment_method':'bank_transfer' } )

Группы пользователей Для администратора OpenCart позволяет использовать раздел Группы пользователей для установки разрешений и доступа к профилям пользователей. Вы можете получить доступ к нему с панели управления, нажав Система > Пользователи > Группы пользователей: В разделе Группы пользователей можно создать группы и определить, какие страницы административной части могут быть просмотрены и изменены каждой группой. Обратите внимание, что вы должны знать, какие страницы могут быть доступны или изменены с правами на просмотр и изменение. У вас есть две предопределенные группы пользователей в OpenCart по умолчанию - Главный администратор и Демонстрационная группа. Группа Администратор имеет все разрешения, тогда как Демонстрационная группа не имеет ни одного. Вы можете удалить обе эти группы и создать новые. Нажмите на кнопку "Действие" для одной из групп пользователей, чтобы увидеть поля разрешений. Раздел Редактировать группу пользователей содержит два основных поля - "Разрешён просмотр" и "Разрешено внесение изменений". Соответственно, группа пользователей Администратор имеет все права доступа и изменения. Однако пользователи, назначенные в Демонстрационную группу, не будут иметь никаких разрешений на просмотр или изменение страниц панели администратора. Если вы решите, что определенная группа пользователей не должна иметь разрешение на изменение, просто удалите галочки из категорий, которые вы хотите запретить изменять. Например, catalog/attribute ссылается на раздел Атрибуты в меню Каталог панели инструментов OpenCart. То же самое касается и всех остальных - это страницы панели администратора вашего интернет-магазина, и вы можете решить, какая группа имеет права на просмотр или изменение каждой из страниц. Прокрутите вниз в каждом поле, чтобы увидеть все страницы панели администратора, для которых вы можете давать и забирать разрешения. Чтобы создать новую группу пользователей, вернитесь в раздел Основные группы пользователей и нажмите кнопку "Добавить новую" в правом верхнем углу. После того, как вы назначите название группы пользователей, вы увидите, что вы можете сразу же настроить разрешения. Дополнительные сведения о назначении пользователей группам пользователей см. на странице документации Пользователи.

Пользователи Управление входами и выходами из административной части интернет-магазина может быть довольно сложной задачей для одного человека. Вы можете счесть необходимым назначить административные полномочия для определенных людей в вашей команде. Раздел Пользователи позволяет настроить, какие пользователи могут получить доступ к административной части магазина и какие разделы могут быть им доступны или изменены ими. Группы пользователей Прежде чем приступить к созданию профилей пользователей, следует посетить раздел Система > Пользователи > Группы пользователей, чтобы задать определенные разрешения на доступ и изменение. OpenCart позволяет настроить, какие страницы на стороне администратора могут быть доступны для определенных групп пользователей. Вы должны проверить, к каким страницам можно получить доступ в разделе "Разрешён просмотр", и какой контент страницы можно изменить в разделе "Разрешено внесение изменений". Страницы в соответствующих полях отображаются в соответствии с разделами верхнего меню. Например, catalog/attribute - это раздел атрибутов в разделе Каталог в верхнем меню панели мониторинга. Имейте в виду, что выбор разделов в разделе "Разрешён просмотр" позволяет пользователю просматривать информацию на этих страницах. Если страница выбрана в разделе "Разрешён просмотр", но не выбрана в разделе "Разрешено внесение изменений"; пользователь сможет просматривать информацию на странице, но не сможет изменить эту информацию. Для группы Сотрудники мы решили разрешить просмотр и разрешить изменение только в разделе каталога, но не в остальной части панели администратора. В OpenCart есть две группы пользователей, установленные на стороне администратора: Главный администратор и Демонстрационная группа. У главного администратора отмечены все поля в разделе "Разрешён просмотр" и "Разрешено внесение изменений". Интуитивно понятно, что пользователям, назначенным на должность главного администратора, потребуется доступ ко всем страницам администратора и разрешение на изменение этих разделов. Вы можете оставить группу без изменений или отменить выбор категорий для этой группы. В демонстрационной группе пользователей не отмечена ни одна страница в разделах "Разрешён просмотр" и "Разрешено внесение изменений", то есть пользователи, добавленные в эту группу, не смогут получить доступ к администратративной части и изменить какие-либо функции магазина. Пользователи После настройки групп пользователей, вы можете создавать пользователей в разделе Система > Пользователи > Пользователи. Нажатие кнопки "Добавить" приведет вас к форме пользователя ниже. Помимо основной информации о пользователе, необходимо создать пароль для входа пользователя на панель управления. Группа пользователей, выбранная в раскрывающемся списке, назначит пользователю определенные разрешения. Статус позволяет разрешить пользователю входить в систему или запретить ему входить в панель управления. В разрешении отказано Пользователь может получить доступ к панели управления так же, как и администратор, за исключением ввода своего конкретного имени пользователя и пароля. Дополнительную информацию смотрите в разделе Интерфейс администратора. Наш пользователь, John Doe, был назначен в группу сотрудников; это означает, что он сможет получить доступ и изменить все страницы Каталога. Он не сможет получить доступ к расширениям, продажам, системе или отчетам. На следующем снимке экрана показано, что будет просматривать John Doe, когда он попытается получить доступ к странице расширений. Если ему разрешен доступ к этой странице, но не её редактирование, то при попытке сохранить изменение появится следующее предупреждение: "Внимание: у вас нет разрешения на изменение категорий!"