Getting started with MultiMerch

Before you begin

System requirements

The current version of MultiMerch in active development is MultiMerch 8.x for OpenCart 2.3.0.2 with vQmod 2.x.

In general, we don't recommend installing MultiMerch on top of an existing OpenCart stores – clean installations are preferable due to differences in product management, payment and order flows and shipping systems in regular stores and online marketplaces.

MultiMerch requires at least PHP 5.5 (although we recommend using PHP 5.6 or 7.x), a MySQL database and an Apache or nginx web server.

If you intend to use a third party OpenCart theme, please see our Themes guide.

We also recommend getting familiar with the main MultiMerch concepts by going through our Concepts section.

Note: OpenCart 3 is not currently supported!

 

Downloading the files

For a complete MultiMerch marketplace setup from scratch, you'll need the following files:

Make sure you're downloading the versions that are supported and compatible with MultiMerch!

 

Installing OpenCart

Please see the official OpenCart Installation guide for more information about installing OpenCart.

 

Installing vQmod for OpenCart

Please see the official vQmod Installation guide for more information about installing vQmod.

Don't forget to execute the vQmod installation script at http://www.yoursite.com/vqmod/install after copying the files – this step is required for vQmod to work!

 

Installing a custom theme

If you plan to use MultiMerch with a custom OpenCart theme, this is the point where you'll install the theme.

Please see our Themes guide for more information about using MultiMerch with custom OpenCart themes.

 

Downloading and preparing MultiMerch files

Depending on which version of MultiMerch you'll be using, you need to download the MultiMerch archive in a zip file from your account on MultiMerch website or OpenCart Marketplace.

MultiMerch archive file is called multimerch_marketplace with a version number, e.g. multimerch_marketplace_8.0.0.0.zip.

Make sure you are installing the correct version of MultiMerch for your version of OpenCart. OpenCart 2.1.x is not compatible with the latest MultiMerch 8.x.

Once you extract the archive file, you will see a folder called upload/ that contains all MultiMerch files that need to be uploaded to your server. If you are using a renamed administration folder in your setup, rename the upload/admin/ folder before proceeding.

 

Extracting and uploading MultiMerch files

You will receive access to the MultiMerch archive when purchasing MultiMerch.

The MultiMerch archive will have the version number in the file name, e.g. multimerch_marketplace_8.14.1.zip.

Once you extract the archive file, you will see a folder called upload/ that contains all MultiMerch files that need to be uploaded to your server.

If you are using a renamed OpenCart administration folder in your setup, you will need to rename the upload/admin/ folder correspondingly before proceeding.

Copy or upload (via FTP) MultiMerch files and folders from inside the upload/ directory to the OpenCart installation directory on your server.

 


Make sure you are uploading the files inside the upload/ folder, not the archive file or the upload/ folder itself, as this will not work.

Your FTP client will merge the contents of the folders automatically.

 

Checking permissions

Make sure your web server has write permissions (usually 755 or 775) on the image/ folder.

MultiMerch will need to create a few subfolders here during installation.

 

Installing MultiMerch

If everything has been done correctly, you will see the new MultiMerch menu entry in your Admin area.

Install MultiMerch via Admin > MultiMerch > Install.

admin multimerch install

This step is mandatory as it creates database tables that are required for MultiMerch to work.

That's it! MultiMerch Marketplace should now be installed.

If you are using a third party OpenCart theme, you will either need to upload the theme compatibility files or have your developers implement theme compatibility manually.

 

Configuring MultiMerch

Upon a successful MultiMerch setup, you will get redirected to the MultiMerch Settings page.

MultiMerch Settings consist of 7 sections located in individual tabs:

  • seller accounts tab contains settings related to seller accounts
  • product publishing tab lets you configure everything related to product listing by seller
  • shipping controls the shipping flow used in MultiMerch
  • orders section will let you configure order statuses and states
  • miscellaneous section contains general settings not found elsewhere
  • SEO lets you enable MultiMerch SEO system for search engine optimization
  • updates tab will let you enter your MultiMerch license key to receive notifications about new versions

Please see our Concepts section for more information about MultiMerch configuration.

 

Troubleshooting

MultiMerch has a Debug page to help you out if something doesn't work as expected.

You can find it at Admin > MultiMerch > System > Debug.

The Debug page consists of three tabs:

  • System information
  • Debug log
  • PHP information

System information contains most of the information your developers will need when solving MultiMerch-related problems:

  • complete version information listing the versions of OpenCart, MultiMerch, vQmod and the custom theme and integration files
  • installed and available OpenCart extensions and OCMOD modifications
  • installed and available vQmod modifications
  • the state of MultiMerch files to tell whether or not they were modified
  • excerpts from OpenCart, vQmod , MultiMerch and server error logs

Additionally, the Debug log will provide the developers with a more detailed debug information (if verbose debugging is enabled in MultiMerch settings) while PHP information will output your server's phpinfo() data.

Please include this data when submitting MultiMerch support requests.