Системы модификации OpenCart OCMOD и VQMOD

В первый раз мы говорили об общей логике OCMOD и VQMOD. На этот раз я опишу опыт работы с OCMOD (VQMOD работает в основном так же и устарел, поэтому я его опущу). Сам OCMOD - это движок (встроенный в OpenCart с версии 2.X). Нам нужно поместить в этот движок инструкцию, чтобы он работал. Файлы инструкций имеют формат XML и определенные имена, например my_file.ocmod.xml, где требуется окончание .ocmod.xml.

Вот пример файла OCMOD

<?xml version="1.0" encoding="utf-8"?>
<modification>
  <name>My OCMOD file</name>
  <code>my-ocmod</code>
  <version>1.0</version>
  <author>Me</author>
  <link>http://mywebsite.com</link>

  <file path="catalog/view/theme/default/template/common/header.twig">
    <operation>
      <search><![CDATA[<div id="top-links" class="nav pull-right">]]></search>
      <add position="before"><![CDATA[
        <div>Add Something</div>
      ]]></add>
    </operation>
  </file>  
  
  <file path="catalog/controller/common/header.php">
    <operation>
      <search><![CDATA[$data['name'] = $this->config->get('config_name');]]></search>
      <add position="replace"><![CDATA[
        $data['name'] = $this->config->get('config_name') . $this->document->getDescription();
      ]]></add>
    </operation>
  </file>  

</modification>

Здесь у нас есть 2 инструкции (операции) в 2 разных файлах (мы также можем реализовать несколько операций в одном файле). В операции мы ищем строку кода в исходном файле ядра и добавляем ее до / после или заменяем на код в теге add. Вот документация по файлу OCMOD, может помочь с .ocmod.xml создание файла.

Когда у вас есть файл .ocmod.xml - вам необходимо его установить. Это можно сделать двумя разными способами:

1. Вставьте файл в папку / system и очистите кеш.
2. В панели администратора в Расширение - Установщик установите файл .ocmod.xml и очистите кеш. В этом случае лучше обойтись. Вы можете найти свои файлы OCMOD в Расширение - Расширение. Это не файлы, а запись в базе данных. Чтобы отредактировать их после установки, вам может потребоваться Редактор OCMOD.

В некоторых случаях вы могли увидеть архив .ocmod.zip с install.xml и папкой upload. Это может быть модуль с файлом OCMOD и дополнительными файлами, скомпилированный в едином инсталляторе.

ОБ ИЗМЕНЕНИЯХ

Теперь, когда у нас есть файл с установленными операциями .ocmod.xml и очищен кеш - система создает копии основных файлов и хранит их в /system/storage/modifications/.... Если взять код из примера - вы найдете файл /system/storage/modifications/catalog/view/theme/default/template/common/header.twig с реализованными изменениями из . ocmod.xml.