Not all of the custom themes are compatible with the MultiMerch extension out of the box. Themes, which are heavily modified and have more differences from default theme, will probably have more compatibility issues, because extension relies on some specific lines of code in the templates. This document will guide you through the process of eliminating compatibility issues of MultiMerch extension with the custom themes.
Theme installation
First of all, you should make sure that you have transferred all the template files and css files of the MultiMerch from the “default” theme folder to your new theme folder. Also, in the multimerch.xml file, which is located in vqmod/xml, check that theme folder is set to the one of your theme – for example “<!ENTITY themeFolder “myTheme”>”. These are the two installation steps, which should be completed before anything else.
Fixing vQmod compatibility issues
Next comes the part of fixing the compatibility issues. You need to test the OpenCart installation and find out what are the conflicting moments. To do so, just check different pages where module has made changes and see whether there are errors in the pages.
If something which was intended to be on the page is not there, you have to check for the errors in the vQmod log – it is usually found in vqmod/vqmod.log or vqmod/logs in later versions. If theme has modified code, which prevents vQmod modifications from being applied, you will find records of all the errors there. The log message usually states which line was not found and in which file. At this point after localizing the error you will have to make a correction to the xml file to search for a new line, which is available in the new theme file. It is easier to find it, if you compare the new theme file with the one from default theme. After finding where this piece of code should be inserted in the new template file, make the correction and save the xml file. Consult the vQmod project page for syntax.
There are two common places where vQmod errors appear. One of these is the “My account” page (where section of the seller account menu is being added) – the file edited there is catalog/view/theme/template/account/account.tpl. The second one is “Product information” page, where information about seller for the products is added – the file edited there is catalog/view/theme//product/product.tpl.
Fixing template files
After vQmod errors were corrected, you may need to correct the MultiMerch template files to make them compatible with theme (it also depends on how heavily modified the theme is – sometimes it is not necessary to modify them). In case if the MultiMerch pages (all the seller account pages like seller profile form, new product form, product list and so on, seller information page, seller list page) do not look like intended, then you will have to compare them to any of your theme template files (for example any of them in account folder) and each of the MultiMerch template files and adapt any changes to make them compatible.
The post Custom Theme Compatibility appeared first on MultiMerch Marketplace.