What it does

This package provides an integrated XML-controlled search and add/replace modification system for OpenCart 2.x and 3.x core files. In addition to OpenCart's OCMod XML you can now also use the VQMod XML for describing the modifications.


Installation for OpenCart 2.x

Simply upload the folders and files from the 'upload' directory to your OpenCart server's main directory via FTP.

The following OpenCart files are replaced by the upload:

admin/controller/extension/installer.php
admin/controller/extension/modification.php
admin/view/template/extension/modification.tpl (version 2.5.1.8 or later only)


Installation for OpenCart 3.x

1)
Go to Extensions > Installer and upload this ocmod.zip file

2)
Go to Extensions > Extensions > Modules > Integrated VQmod to install and then edit to enable this module

3)
Go to System > Users > User Groups > edit Administrator and make sure the access and modify rights are set for 'extension/module/integrated_vqmod'


How to upload OpenCart modifications

There are 4 ways to upload modifications to an OpenCart server:

1)
Use the OpenCart admin backend at Extensions > Extension Installer to upload individual XML files to the OpenCart database. The XML file names must end with '.vqmod.xml' or '.ocmod.xml' depending on the type of XML used. This is for OpenCart 2.x only!

2)
Use the OpenCart admin backend at Extensions > Extension Installer to upload zipped OpenCart extensions which include an XML file (the latter ends up in the OpenCart database). The name of the ZIP-file to be uploaded must end with '.vqmod.zip' or '.ocmod.zip'. The folders and files structure of the ZIP-file should look like this:

upload/*
install.xml (can contain VQmod or OCmod XML)
install.php (optional, OpenCart 2.x only)
install.sql (optional, OpenCarty 2.x only)

3)
Use FTP to upload XML files directly to OpenCart's system folder. The XML file names must end with '.vqmod.xml' or '.ocmod.xml' depending on the type of XML used.

4)
Use FTP to upload VQmod XML files directly to OpenCart's vqmod/xml folder. The file names must end with '.xml'.

Note: Option 4) is useful for many legacy OpenCart 2.x extensions that come as ZIP-files, and that require VQmod. The content of such a ZIP-archive is usually first to be extracted on a local computer, and then everything from the extracted 'upload' folder is uploaded to OpenCart's main folder.

After the OpenCart modifications are uploaded, it is important to go into the OpenCart admin backend at
Extensions > Modifications and then click on the 'Refresh' button. This will re-create a cache for all modified OpenCart core files in the system/modification folder.


Further help and customized versions

This addon has been successfully tested for the standard OpenCart versions 2.0.0.0 to 2.3.0.x and 3.0.x. Don't use it with other Opencart versions

We'll strive to keep the VQMod package up-to-date with future official OpenCart 2.x and 3.x releases.


License
This extension is Copyright (c) 2015-2017 by MHCCORP.COM and is made available under the terms of the GNU General Public License Version 3.

Note: Please use the regular OpenCart forum for support.