OpenCart

In this article, you will find out how to create an app and mobile website from your OpenCart* desktop shop.

* JooCart users, please follow this article to set up your app and mobile website.

 

Available features

With OpenCart and Shopgate, you are able to create your app and mobile website with the following features:

Supported Version Import to OpenCart
up to 2.2.0   Orders
Sync Export to Shopgate Mobile Shop
Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity, on Product Detail Page


Products
Categories
Reviews


Customer Account Validate, upon Cart Changes
Login with Desktop Shop Account
Login to Desktop Shop with Mobile Account
Customer Groups / Tier Pricing
Show Desktop Orders on Mobile


/

Coupon
Shipping Method
Payment MethodNew feature!
Product Availability




Supported Payments Notes
Cash On Delivery, Klarna New feature! The payment validation feature allows you to offer specific payment options to targeted carts and customers. The availability of this feature depends on your Magento settings. To enable this feature, please contact Shopgate Support.

 

Install the Shopgate plugin

Put your shop in Maintenance Mode

To prevent your shop from crashing while installing and updating the Shopgate plugin, please make sure to put your shop into Maintenance Mode beforehand. To do so,

  1. Log into your OpenCart backend
  2. Navigate to System → Settings and click on Edit on the row of your store.
  3. When the Settings page opens, switch to the Server tab and set "Maintenance Mode" to Yes

Download the plugin

Download the latest plugin via this link and unzip the content.

Upload the plugin to OpenCart

OpenCart version 2.0 OpenCart version pre-2.0 JooCart users
Please use the new Opencart Extension Installer to upload the Shopgate plugin.
IMPORTANT: Please make sure your FTP credentials are entered and enabled in your Settings.
  1. Login to your OpenCart Admin Backend.
  2. On the menu bar, select  → Extension Installer.
  3. In the Extension Installer, click Upload and select the zip file you just downloaded. The Shopgate plugin will be uploaded automatically.
  4. Click Continue to finish uploading the plugin to your OpenCart backend.

Your Shopgate plugin has been installed successfully when you see a green success message.

Activate the plugin

  1. In your OpenCart Admin, go to  → Modules.
  2. Find Shopgate in the List and click  Install.
  3. Your Shopgate plugin is uploaded when a success text shows on top of the Modules page.
  4. Now click  to open the Shopgate plugin settings page.
Leave this page open - we will explain how to find the required info in the next chapter.

Redirect customers to mobile website

OpenCart version 2.0 OpenCart version pre-2.0
  1. Navigate to SystemDesignLayouts.
  2. In the Layout List, look for Home, Category, and Products.
  3. Click on  to edit layout Home.
  4. Now add a new module by clicking  at the bottom of the Edit page (2nd screenshot)
  5. Set Module to Shopgate, Position to Content Top, and Sort Order to -1. Click Save on top.
  6. Repeat step 3 & 4 to add the Shopgate module to layouts Category and Products.
  7. After a "Shopgate Module" has been added to all 3 layouts (Home, CategoryProduct), all mobile visitors will be redirected to your mobile shop.
  

Now your plugin is ready to be connected.

"Maintenance Mode" can now be set back to No.

 

Establish connections

After the Shopgate plugin has been installed successfully, 2 simple tasks need to be done to connect your mobile shop at Shopgate to your shop's backend: to enter API credentials in your shop's backend, and to enter your shop's URL in your Shopgate's admin page.

Get API credentials

  1. Log in to your Shopgate Admin and navigate to Integration → Install Interface.
  2. In the drop-down labeled Select system, start typing OpenCart, and select it from the search result.
  3. A popup opens. Look for Customer number, Shop number, API key, and Alias under 2. Configure. These are the API credentials the plugin needs to be authenticated at the Shopgate backend. Leave this page open - we will come back to enter the URL (explained in Establish connections)
  4. Copy Customer number, Shop number, API key, Alias, and CName (optional), and paste them individually onto the plugin configuration page you left open from the last chapter. Click Save.
    The rest of the options can be configured later. This is explained in Configure the Plugin.

 

Connect your shop to Shopgate

  1. Go back to the pop-up window at your Shopgate merchant page (step 4). Enter your shop's URL to the text field at 3. Enter URL. Click connect to establish the interface.
  2. If a connection is made successfully, a popup shown below will open. Make sure to set all services to ON. Click Save.

Congratulations! Now you should see the progress bar running, and the Shopgate backend automatically filling your mobile shop with your products. Depending on how many products you have, the import process can take anywhere from a few minutes to a few hours. Welcome to the mobile world 😊

 

Update an existing plugin

Before updating your Shopgate plugin to a newer version, make sure to check if your shop uses a customized version of the Shopgate plugin. If this is the case, a generic plugin update will NOT work for your shop.

You are using a customized version if:

  • you have contacted Shopgate for making a 3rd party plugin to work in your mobile shop, or adding a special feature/function
  • Shopgate has sent you an adapted version of plugin
  • the plugin file you installed has "adaption" in the name

Once you know if you are using a customized Shopgate plugin or not, follow the instructions below to update it:

Generic Plugin Customized Plugin
OpenCart version 2.0
Simply Install the newest Plugin.
OpenCart version pre-2.0
  1. Follow chapter 1.1 to put your shop in Maintenance Mode.
  2. Download the latest plugin and unzip it.
  3. Open the unzipped file in your FTP program. You will see 3 sub-folders: admin, catalog, and shopgate.
  4. Update the Shopgate folder by dragging it to your shop folder on the FTP server. The old Shopgate folder on your FTP server will be overwritten.
  5. Update folders Admin and Catalog by copying files to your FTP server one by one:
    1. Click on Admin or Catalog (local folder) to open it.
    2. Starting with the first item, your task is to open a folder all the way until file(s) are revealed.
    3. Find the exact same file(s) in your shop folder on FTP server.
    4. Now select the file(s) in the local folder and drag it to the same folder on FTP server to update this file. The old file on your FTP server will be overwritten.
    5. Delete any old "Shopgate" files in Admin and Catalog (sub)folders that are no longer in use in the newer version of the plugin.
    6. Repeat the steps until ALL files in Admin and Catalog have been updated to your FTP server.

Now you can set "Maintenance Mode" to No. This will complete the update.

IMPORTANT: If you have just updated your Shopgate plugin from a version older than 2.9.5, make sure to configure your Customer number, Shop number, API key, Alias, and CName again following these instructions. If you have updated a Shopgate plugin version newer than 2.9.5, your plugin configurations should remain the same.

That's it! Now your Shopgate plugin has been successfully updated.

 

Understand plugin configurations

Here you can find detailed explanations to all configuration fields provided on the configuration page of the plugin.

Store Select the store you want to connect to Shopgate if there is more than one store.
Status You can enable or disable the plugin here.
Customer number Your customer number provided by Shopgate.
Shop number Your shop number provided by Shopgate.
API Key This is the "password" that the plugin uses to communicate with the Shopgate Merchant API in a secure channel.
CName Set a mobile URL under your own domain here. For example, use "m.myawesomeshop.com" instead of the default Shopgate URL "myawesomeshop.shopgate.com"
Alias Your shop's alias, provided by Shopgate. Do not use special characters or spaces.
Merchant API Mode Set to "Live" to use your mobile shop. If you want to test the service, select "test mode".
Encoding The encoding type that is used in your OpenCart database. We recommend UTF-8.
Comment detail level Select how much information should be entered into the comment section when import orders.

Order status "shipping blocked"

Order status "shipping not blocked"

Order status "shipped"

Order status "canceled"

Choose a status from the drop-down to match the order status between your mobile shop and your webshop.

 

Frequently Asked Questions

My mobile shop became unavailable after I updated the Shopgate plugin. What should I do?

If you have not updated your Shopgate plugin for a while, it's possible that your plugin configurations cannot be updated properly to the newest version. This is easy to fix.

Simply go to your OpenCart backend and find the Shopgate plugin. Click the [Edit] Button to open the Settings page. Now enter your Customer number, Shop number, API key, Alias, and CName again following the instructions from Chapter 2.1.

Afterwards, refresh your shop and everything should be working again.

How to upload the Shopgate plugin via the FTP tool?

For OpenCart version before 2.0, you will need an FTP client tool to upload your Shopgate plugin. Plenty of FTP programs can be found on the internet. FileZilla is used in the example below.

Now follow the steps below to upload the Shopgate plugin:

  1. Connect your FTP program to your server
  2. Navigate to the unzipped Shopgate plugin in your local directory (left).
  3. Select ALL files in your Shopgate plugin local folder
  4. Drag them into your shopping cart system folder on the FTP server (right).
  5. The upload will start immediately.

Now proceed to activate the plugin in your OpenCart backend

Where can I enter my FTP credentials?

To enter your FTP server credentials, follow the steps here:

  1. In your OpenCart account, go to Settings then click the Edit button on the row of your store.
  2. On the Settings page, switch to the FTP tab.
  3. Enter your credentials here and enable FTP. Click Save.

Now you have entered and enabled your FTP server in your OpenCart.

 

Was this article helpful?
0 out of 0 found this helpful