Support Center

Connecting to Oxid

Oxid is a supported shopping cart system at Shopgate. By setting up the Shopgate plugin for your Oxid shop, you will automatically get products and categories export, orders import, and shipping confirmation straight into your shopping cart.

In this article, you will find the instructions to set up the Shopgate plugin for your Oxid shop.

Topics covered in this article:

 

1. Installing the Shopgate Plugin

The Shopgate plugin for Oxid can be installed in all Oxid eShops starting from version 4.2.0. Simply upload the plugin to your Oxid folder and activate it in your Oxid admin page. To do this, please follow the steps below:

1.1 Downloading the plugin

Download the plugin via this link: http://files.shopgate.com/plugins/oxid.zip and extract the contents of the zip file. (Link: how to extract a zip file?) This should give you a folder called “oxid” with two subfolders:

  • Ab_eShop_4.7 (this is for Oxid eShop version 4.7.0 and above)
  • Bis_eShop_4.6 (this is for Oxid eShop versions 4.2.0 to 4.6.x)

 

1.2 Uploading the plugin to your server

  1. Using an FTP or a similar program to copy the plugin into your Oxid eShop. Plenty of FTP programs can be found on the internet. If you don’t know which one to use, we recommend FileZilla.

  2. Once your FTP program is connected to your server, navigate to your locally extracted Shopgate plugin.

  3. Choose between the subfolders “Ab_eShop_4.7” or “Bis_eShop_4.6” according to your Oxid version.

  4. Open a subfolder of this folder called “copy_this”. Copy all contents in "copy_this" directly to the root directory of your Oxid installation on your server. Don’t close your FTP program just yet. You’ll need it again in a later step.

Now continue to set file permissions.

 

1.3 Setting file permissions

It’s necessary so set file permissions to the "temp" and "config" folders on your server.

  1. To do this, navigate to the "modules/shopgate/shopgate_library" folder on your server and select both "temp" and "config" folders. Right click on your selection and click on File permissions....



  2. Change file attributes dialog opens. Enter the numeric value “777” into the input field. Make sure the checkbox “Recurse into subdirectories” is enabled and “Apply to all files and directories” is selected as the option. Click OK to finish the upload.

Now your Shopgate plugin is successfully installed and ready to be activated.

 

2. Activating the plugin

To activate the Shopgate plugin in your Oxid backend, log in to your oxid admin backend and choose the version of your Oxid below.



 

2.1 Oxid 4.4.x or below

  1. In the main menu on the left click Master Settings -> Core Settings. Click the tab System. Click the section Modules to expand it.



  2. Enter the following in the text area labeled Installed Shop Modules:
    marm_shopgate_article => shopgate/marm_shopgate_oxadminview
    order_main => shopgate/shopgate_order_overview
    order_overview => shopgate/shopgate_order_overview
    oxarticle => shopgate/marm_shopgate_oxarticle
    oxbasket => shopgate/shopgate_oxbasket
    oxdeliverylist => shopgate/shopgate_oxdeliverylist
    oxorder => shopgate/marm_shopgate_oxorder
    oxoutput => shopgate/marm_shopgate_oxoutput
    oxsession => shopgate/shopgate_oxsession
    oxvarianthandler => shopgate/shopgate_oxvarianthandler
    shopgate_order => shopgate/marm_shopgate_oxadminview
    shopgate_payment => shopgate/marm_shopgate_oxadminview
    shopgate_shipping => shopgate/marm_shopgate_oxadminview
  3. If some of the entries already exist, add the corresponding value to the end with an empersand (&). For example: if this already exists:
    oxorder => invoicepdf/myorder
    modify it to:
    oxorder => invoicepdf/myorder&shopgate/marm_shopgate_oxorder

Now you have activated your plugin. Continue to the next step: Clearing Oxid's temporary folder

 

2.2 Oxid 4.5.x

  1. In the main menu on the left click Master Settings -> Core Settings. Click the tab System. Click the section Modules to expand it.



  2. Enter the following in the text area labeled Installed Shop Modules:
    order_main => shopgate/shopgate_order_overview
    order_overview => shopgate/shopgate_order_overview
    oxarticle => shopgate/marm_shopgate_oxarticle
    oxbasket => shopgate/shopgate_oxbasket
    oxdeliverylist => shopgate/shopgate_oxdeliverylist
    oxorder => shopgate/marm_shopgate_oxorder
    oxoutput => shopgate/marm_shopgate_oxoutput
    oxsession => shopgate/shopgate_oxsession
    oxvarianthandler => shopgate/shopgate_oxvarianthandler
  3. If some of the entries already exist, add the corresponding value to the end with an empersand (&). For example: if this already exists:
    oxorder => invoicepdf/myorder
    modify it to:
    oxorder => invoicepdf/myorder&shopgate/marm_shopgate_oxorder

Now you have activated your plugin. Continue to the next step: Clearing Oxid's temporary folder

 

2.3 Oxid 4.6.x or above

  1. Click Extensions -> Modules on the main menu on the left .
  2. Click Shopgate in the list of extensions .
  3. Click on the Overview tab on the lower part of the screen, if it isn’t already open.
  4. Click the Activate button on the right to activate the Shopgate plugin.

Now your plugin has been activated.

 

3. Clearing Oxid’s temporary folder

Please remember to clear the temporary folder in Oxid before you proceed.

  1. Now go back to your FTP program and locate a folder called "tmp" in your Oxid installation.

  2. If there is a file named ".htaccess", select all files except ".htaccess" inside the folder "tmp" and hit delete. Otherwise, delete all files inside the folder "tmp".



  3. Now you have cleared the temporary folder successfully.

 

4. Establishing connections between the plugin and Shopgate

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.

4.1 Getting API credentials

  1. Log in to your Shopgate Admin page.

  2. Click on Integration from the menu bar, then select Install Interface.



  3. In the dropdown labeled Select system, search for OXID eSales, and select a version depending on your shop edition. (CE = Community Edition, PE = Professional Edition, EE = Enterprise Edition)



  4. A popup opens. Under 2. Configure, you'll see the API credentials the plugin needs to authenticate with the Shopgate backend. Leave this page open for the next step 2.2 Establishing connection



  5. Open your Oxid admin backend in another tab or window of your browser (if you don’t already have it open from installing the plugin). In the main menu on the left, click on Master Settings -> Core Settings, and then on the tab called Shopgate. Expand the sections called Basic Configuration and Mobile website by clicking on them. Fill in the fields Shopgate Customer Number, Shop Number, Shopgate API Key, and Alias with the values from your Shopgate merchant backend. There are some other settings on this page, but you don’t need to configure them for now. Click save.

 

4.2 Connecting your shop to Shopgate

  1. Go back to the pop-up window at your Shopgate merchant page (step 4).

  2. Under 3. Enter URL, enter the URL of your shop, ideally starting with “https://”. For example: https://www.MyAwesomeShop.com

  3. Click Connect to establish the interface.



  4. If a connection is made successfully, a popup shown below will open. Here you will be able to assign jobs for your first connection. Leave all assignments to ON to access all the available services. Click Save.



  5. That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface.

 

5. Updating an existing Shopgate plugin

To update a previously installed Shopgate plugin to the latest version, follow the steps below.

5.1 Oxid 4.5 and below

To update the Shopgate plugin for Oxid version earlier than 4.6, download the latest plugin, install and activate it according to Chapter 1 and Chapter 2.

 

5.2 Oxid 4.6 and above

To update the Shopgate plugin for Oxid version 4.6 and above, you need to deactivate the old plugin, then replace it with the new version.

  1. Deactivate the old plugin first.

    On your Oxid admin's Home page, navigate to Extensions -> Modules on the left menu bar, and click Shopgate from the list. Click Overview and then the Deactivate button on the right to deactivate the Shopgate plugin.

  2. Download and upload the latest plugin. Follow the instructions from chapter 1.1 and chapter 1.2.

  3. Activate the new plugin (Version 4.6 and above). Follow the instructions from chapter 2.3.

 

6. Configuring the Plugin in Oxid

To find the setting for your Shopgate plugin, please click Master Settings -> Core Settings in the main menu on the left, then on the tab labelled Shopgate.

 

6.1 Basic settings

Configure your Shopgate credentials used to connect to the Shopgate system.

Shopgate Customer Number Your customer number at Shopgate.
Shopgate Shop Number Your shop’s number at Shopgate.
Shopgate API Key Your API key assigned by Shopgate.

 

6.2 Mobile Website

Set up your mobile website and redirect.

Alias The alias is the subdomain of shopgate.com, e.g. myshop.shopgate.com, where your mobile website can be found. This is used as a fallback if no CNAME is configured.
CNAME A CNAME is a subdomain of your own domain that points to your mobile website. For example, a CNAME could look like "m.myshop.com". To configure a CNAME, please log on to your server hosting website. For more information, please read our help article Adding a CNAME record in your domain host
Language A comma-separated list of ISO 639-1 (e.g. en, de, fr) that should be redirected to your mobile website. Leave this blank to redirect all languages.
Type Redirect users via HTTP-Header if possible - it’s fastest and best for search engines. If you experience trouble using HTTP-Header redirect, try JavaScript.

Comments

Please sign in to leave a comment.