OCMOD - Модификаторы в OpenCart - это разновидность расширений, позволяющих вносить изменения в функционал или внешний вид, не затрагивая оригинальные файлы. Тем самым обеспечивается неизменность оригинальных файлов самого OpenCart, при том, что появляется возможность заменять или расширять необходимый функционал.

История появления модификаторов началась с vQmod в opencart версии 1.5х, и уже в версии opencart 2x он был усовершенствоваван и преобразован в OCMOD. В отличии от vQmod который устанавливался отдельно, OCMOD внедрён по умолчанию как стандартный функционал в CMS OpenCart2х и выше.

OCMOD - Модификатор в OpenCart - расширение представляющее из себя XML файл, которое содержит набор инструкций о том, в каких оригинальных файлах OpenCart-а, в каких местах, какой код нужно заменить, добавить или удалить. OpenCart при выполнении инструкций xml файла создает копии исходных файлов в специальную директорию кэша модификаторов с внесёнными изменениями в этих копиях. В результате, при работе сайта используются измененные файлы, а не их оригинальные файлы.

Модификатор 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 выберите Система > Обслуживание > Загрузить:

В этом поле отображаются все загруженные файлы, хранящиеся в вашем магазине 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. Таким образом, пользователям сети будет легко узнать, где находится ваш магазин.

Выберите Система > Локализация > Адрес магазина:

Вы откроете раздел местоположения магазинов, где найдете всю информацию о ваших физических магазинах. Есть два основных поля - Название магазина и Адрес. Когда вы закончите вводить информацию о вашем магазине, она появится в этом разделе. У вас будет возможность впоследствии редактировать информацию о каждом конкретном магазине.

Начните с нажатия кнопки "Добавить новый":

Сведения о местоположении магазина

В следующем разделе будут показаны все пустые поля, которые вы должны заполнить сведениями о вашем физическом магазине. Обязательными полями являются Название магазина, Адрес и Телефон.

Geocode \ Геокод - этот код использует географические координаты вашего адреса. Например, такой адрес, как 103 Integer Rd. Corona New Mexico 08219 будет преобразована в широту 34.249772 и долготу -105.603535. Геокодирование используется для размещения вашего маркера на карте.

Факс - введите свой номер факса, если он у вас есть.

Изображение - поместите изображение или логотип вашего магазина для более легкого распознавания.

Время работы - перечислите часы открытия и закрытия вашего магазина.

Комментарий - это поле для любых специальных пометок, которые вы хотите оставить для своих покупателей. Например, "Чеки не принимаются", или что либо другое.

Отображение местоположения магазина на странице Контакты

После завершения ввода сведений о физическом местоположении магазина перейдите в раздел Система > Настройки > Витрина:

Прокрутите до самого низа, и вы увидите поле с названием "Местоположение магазина". Если вы хотите, чтобы местоположение отображалось на странице "Контакты", включите его, нажав на галочку.

Теперь это местоположение активно и будет отображаться на странице "Контакты" вашего сайта OpenCart.

Если вы хотите удалить сведения о магазине, вы можете выбрать его галочкой слева и нажать кнопку "Удалить" в правом верхнем углу.

Для использования 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. То же самое касается и всех остальных - это страницы панели администратора вашего интернет-магазина, и вы можете решить, какая группа имеет права на просмотр или изменение каждой из страниц.

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

Чтобы создать новую группу пользователей, вернитесь в раздел Основные группы пользователей и нажмите кнопку "Добавить новую" в правом верхнем углу.

После того, как вы назначите название группы пользователей, вы увидите, что вы можете сразу же настроить разрешения.

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