Support Center

Connecting to PrestaShop

Follow

 

Shopgate supports PrestaShop as a shopping cart system.

By setting up the Shopgate plugin for your PrestaShop, you will get these wonderful features straight into your mobile apps and website:

 

Supported Version Import to PrestaShop

1.4.0.17+, 1.5.0.17+, 1.6.0.5+, 1.7.1.2*

  Orders
Sync Export to Shopgate Mobile Shop

Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity, on Product Detail Page
Product Tax Classes, Rates & Rules





Products
Categories
Reviews
Related Products, Upsell & Cross-sell




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

Shopgate, PayPal, Cash on Delivery, Prepayment

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 PrestaShop settings. To enable this feature, please contact Shopgate Support.

* For versions earlier than 1.7.x.x, it is possible that the base prices are calculated incorrectly in certain configurations which can cause issues with Shopgate system. To correct this issue, please update your PrestaShop version to 1.7.x.x or higher.

 

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

 

Topics covered in this article:

  1. Installing the Shopgate Plugin
  2. Establishing connection between plugin and Shopgate
  3. Updating an existing Shopgate plugin
  4. Configuring the Plugin
  5. Frequently Asked Questions (FAQ)

 

1. Installing the Shopgate plugin

The Shopgate plugin for PrestaShop can be installed in all PrestaShop versions starting from 1.4. To do this, please follow the steps below:

  1. Download the plugin here: http://files.shopgate.com/plugins/prestashop.zip

  2. Log into your PrestaShop admin panel. In the main menu, click on Modules / Modules to see a list of your installed plugins. Click on Add a module.

  3. In the pop-up, click on Choose a file, and select the plugin file prestashop.zip downloaded from step 1. Click on Upload this module.

  4. After the module is uploaded, you will receive a success notification and the module will appear in the Plugin List.

  5. Locate the Shopgate plugin by searching for "Shopgate" from the plugin list. Make sure to set permissions 774 for the folder "/modules/shopgate/vendors/shopgate_library/temp" and all its underlying folders. If you encounter an error when installing the plugin, set the permissions to 777. Click Install.

  6. Once installed, continue to set up the module by clicking Configure. This will open the Shopgate plugin configuration page. Leave this page open - we will explain how to find the required info in the later chapters.

 

2. Establishing connection 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.

2.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 drop-down labeled Select system, search for PrestaShop, and select it.
  4. A popup opens. Copy Customer number, Shop number, API key, and Alias and paste them individually onto the plugin configuration page you left open from step 6 above. Click Save.

The rest of the plugin configurations can be entered later. This is explained in Chapter 4. Configuring the Plugin.

 

2.2 Connecting your shop to Shopgate

  1. Go back to the pop-up window at your Shopgate Admin page (step 4).
  2. Under 3. Enter URL, enter the URL of your shop. Click connect to establish the interface.
  3. If a connection is made successfully, a popup shown below will open. Here you will be able to assign jobs for your first connection. We recommend leaving all assignments to ON at this time. Click Save.
  4. That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface.

 

3. Updating an existing Shopgate plugin

3.1 Checking for custom adaption

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.

To check if your plugin is customized...

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

If your shop uses a customized Shopgate plugin...

Please email Shopgate each time before updating with the following details:

 

3.2 Updating the plugin

To update your Shopgate plugin, follow Chapter 1 to install the Shopgate plugin. Make sure to update to a customized version of Shopgate plugin, if your plugin has been customized.

Note: do NOT uninstall the current module. Install the latest version "on top" of your current module to keep your current configurations.

 

4. Configuring the Plugin in PrestaShop

You can configure the Shopgate Module in your Prestashop backend by clicking on the Configure button on the Shopgate plugin in your Modules list.

The configuration page will appear.

Info
API URL (read only) This URL is provided to you by Shopgate. When asked, simply copy it and paste in your Shopgate admin area.
Currency Choose the currency for your products.

 

Basic
Customer Number This is your Shopgate customer number explained in chapter 2.1.
Shop Number This is your Shopgate shop number explained in chapter 2.1.
API Key This is your Shopgate API key explained in chapter 2.1.
Language Choose the language of your store.
Subscribe mobile customer to newsletter Automatically add new mobile customers to your newsletter subscriber list?

 

Order
Cancelation status Please choose the status that corresponds to the "canceled" status in your PrestaShop backend.

 

Carrier mapping
(Carrier name here) You will see a complete list of shipping carriers used in your Prestashop backend. Please map the carriers by selecting a Shopgate-supported carrier from the drop-down. This will make sure that your mobile orders being imported accordingly.

 

Environments
Environment Please set to “Live”. Only set to "Test" for testing purposes.

 

Mobile site
Alias Your Shopgate Alias. For example, if set to "my-shop", your mobile URL will redirect to www.my-shop.shopgate.com
CNAME The CNAME you registered at your domain provider, e.g. m.my-shop.com
Root category export If your Base Categories don't get exported, set this to “Yes” and start a new import in the merchant area of Shopgate.
Product description export Select the product description type you want.
Price type Select net or gross.
Mobile carrier Select the mobile carrier you want your mobile shop to be connected to. This is used for cart validation.

 

5. Frequently Asked Questions (FAQ)

5.1 I see an error "Permission denied". What should I do?

If you see the error "mkdir: Permission denied" similar to this one below, you need to check and set folder permissions.

Follow the steps here:

  1. Uninstall the Shopgate plugin in the Prestashop backend.
  2. Go to folder "/modules/shopgate/vendors/shopgate_library/temp" and set permission to at least 774 to this folder and all its subfolders. 
  3. Install the Shopgate plugin again.

Now the error should go away. If the error remains, try to set the permission to 777.

 

5.2 Orders won't show in my PrestaShop backend. What should I do?

If you run a German shop and you use a 3rd party plugin called "eu-legal" (from the company "Silbersaiten") in your PrestaShop, you might have trouble getting your mobile orders to your PrestaShop backend.

If this is the case, please email your Shopgate support at support@shopgate.com. Our developers can help.

Comments