Things to Know Before Updating MultiMerch

Before you proceed with updating your MultiMerch installation to a new version, there are a few things you need to know.

Make a MultiMerch backup first

Always make a backup of your MultiMerch installation before you get started with the update. The upgrade process will overwrite some core files, so if anything goes wrong during installation you can easily restore your store.

Files that are modified during the update process

Depending on the size of the update, one or more files inside the following MultiMerch folders will be modified:

  • system/library/
  • vqmod/xml/
  • catalog/controller/seller/, catalog/controller/payment/, catalog/controller/account/
  • catalog/view/theme/default/, catalog/view/javascript/
  • catalog/language/english/multiseller/
  • admin/controller/module/multiseller/, admin/controller/multiseller/
  • admin/language/english/module/multiseller/, admin/language/english/multiseller/
  • admin/model/multiseller/
  • admin/view/

MultiMerch updates only modify the MultiMerch-related files – no OpenCart core files or third party extensions are changed. However, it's a good idea to make a full OpenCart backup before proceeding with the update.

General MultiMerch Update Procedure

You can perform a MultiMerch update in two ways – either perform a full update that will overwrite all MultiMerch core files (suitable if you haven't modified MultiMerch Core directly) or do a selective update.

Full MultiMerch update

To perform a full MultiMerch update to your installation, do the following steps.

  1. Download and unzip the new MultiMerch archive. Whether you're using the free MultiMerch Core version or one of our Premium Bundles, you'll have the multimerch_marketplace/ folder in your working directory.
  2. Upload the MultiMerch files and folders to the OpenCart installation directory on your server. This includes everything inside the multimerch_marketplace/upload/ folder.
  3. If required, perform the database upgrade. You'll see a database upgrade notification in your admin area if the corresponding update requires changes to the database. Click the link in the notification to proceed with the database upgrade – MultiMerch will then perform all the necessary steps to introduce the database changes.
  4. Check the MultiMerch settings in MultiMerch > Settings. If the update has introduced any new settings, you'll need to configure them first.

That's it – your MultiMerch installation is now up to date!

Selective MultiMerch update

In some cases, a full update may not be suitable for you, especially if you have a modified MultiMerch installation with changes to the MultiMerch Core files. In this case, doing a full update will overwrite your changes, so you may want to go for a selective update instead.

Even though you can do a selective update manually by checking all the files, it's better to use a difference/merging tool to compare your original files and the new MultiMerch fiels and merge them automatically. If you're using Linux, diff/rsync will do. For Windows installations, you can take a look at WinMerge.

The selective update process is as follows:

  1. Download and unzip the new MultiMerch archive. Whether you're using the free MultiMerch Core version or one of our Premium Bundles, you'll have the multimerch_marketplace/ folder in your working directory.
  2. Find the differences between your MultiMerch installation and the new files. Use a difference tool to calculate the differences between the files and folders.
  3. Merge/upload the new MultiMerch files and folders selectively to the OpenCart installation directory on your server. This will make sure you're not overwriting any of your changes to MultiMerch core during the update process.
  4. If required, perform the database upgrade. You'll see a database upgrade notification in your admin area if the corresponding update requires changes to the database. Click the link in the notification to proceed with the database upgrade – MultiMerch will then perform all the necessary steps to introduce the database changes.
  5. Check the MultiMerch settings in MultiMerch > Settings. If the update has introduced any new settings, you'll need to configure them first.

Your custom MultiMerch installation is now up to date – now you only need to make sure your custom changes are still functional with the new MultiMerch version.

Version specific MultiMerch updates

Some MultiMerch releases introduce major changes or modifications to MultiMerch core file structure or configuration settings that you'll need to take into account when updating your installation. This part covers such version updates to make the update process easier.

Changes between MultiMerch 7 and MultiMerch 8

MultiMerch 8 introduces a complete rewrite of the MultiMerch architecture compared to MultiMerch 7 – direct upgrade is not possible. Please get in touch with us if you're looking to upgrade from MultiMerch 7 to MultiMerch 8.

Changes between MultiMerch 5 and MultiMerch 6

MultiMerch 6 introduces several changes to the file and folder structure and has some functionality removed from core and into separate addons.

Splitting of the main xml file

The vqmod/xml/multiseller.xml file is now split into multiple files based on the functionality they introduce:

  • multimerch_core.xml contains MultiMerch core functions
  • multimerch_core_addtocart.xml contains changes to the "Add to Cart" function to prevent sellers from purchasing their own products
  • multimerch_core_admin.xml contains admin-area modifications
  • multimerch_core_listingperiod.xml introduces product listing period modifications
  • multimerch_core_onepagereg.xml is the file dealing with one page seller registration
  • multimerch_core_ordercomments.xml replaces a single order comment with order comment per seller
  • multimerch_core_productpage.xml contains changes handling seller information on product page
  • multimerch_core_sellerinfos.xml adds the "Seller" field to the product to various places throughout the store
  • multimerch_core_sellermenu.xml creates the seller menu in the customer account area
  • multimerch_core_seourl.xml deals with SEO-friendly URLs for sellers
  • multimerch_core_transactions.xml creates balance records for sellers

The files marked in bold contain core functionality and are important or critical for a correctly working MultiMerch installation.

Functionality moved to addons

Some of the functionality was moved from MultiMerch Core to separate addons:

  • Shipping System. MultiMerch Shipping is now a complete addon to MultiMerch Core and can be installed and uninstalled without modifying the Core files like it was in MultiMerch 5.
  • Mass Payments
  • Adaptive Payments
  • Badges
  • Ratings
  • Comments
  • Private Messaging
  • Top sellers block
  • New sellers block
  • Seller carousel
  • Image generation from PDF files

If you had any changes in the Core functionality that was moved to addons, you'll need to take this into account when updating your installation to MultiMerch 6. Doing a selective installation will work in this case. You will also need to install each of the addons you'll be using via Extensions > Modules > Addon Name.

Additionally, if you're using the New, Top or Seller Carousel blocks, you'll need to do the following:

  1. Remove the relevant "extension" entries from the OpenCart database. This includes ms_newsellers, ms_topsellers and ms_carousel records in the "extension" table.
  2. Install the relevant MultiMerch addons via Extensions > Modules > Addon Name.
  3. Rename the relevant "module" entries in the OpenCart database. Rename the ms_newsellers_module, ms_topsellers_module and ms_carousel_module to multimerch_newsellers_module, multimerch_topsellers_module and multimerch_carousel_module in the "setting" table.

This will make the New, Top and Seller Carousel modules appear in your MultiMerch store.