Support Center

Connecting to Magento 2

Follow

 

Magento 2 is a supported shopping cart system at Shopgate.

By setting up Shopgate plugin in your Magento 2 shop, you will get these wonderful features straight into your app and mobile website:

Support Import to Magento 2
Version 2.1+ Orders
Customer Account Export to Shopgate Mobile Shop
Login with Desktop Shop Account
Login to Desktop Shop with Mobile Account
Customer Groups / Tier Pricing
Show Desktop Orders on Mobile


/
Products
Categories
Reviews


Sync Validate, upon Cart Changes
Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity, on Product Detail Page


Coupon
Shipping Method
Payment Method
Product Availability



Supported Payments Notes

Payment methods are not mapped to the native Magento 2 implementations at the moment. This means that orders imported from Shopgate can NOT be captured or refunded from your Magento 2 backend. This is planned to be implemented in the near future.

Other supported features:

  • Info from the Shopgate custom fields (2nd phone number, birthday, etc.) is now imported as order details in your Magento 2 backend.
  • Group, configurable, and simple products
  • Group pricing for simple and configurable products

 

In this article, you will find everything you need to set up the Shopgate plugin for your Magento 2 shop.

 

Topics covered in this article:

  1. Installing the Shopgate plugin
  2. Connecting the plugin to Shopgate
  3. Understanding the plugin configurations
  4. Frequently Asked Questions (FAQ)

 

 

1. Installing the Shopgate plugin

1.1 Getting started

To prevent your Magento 2 storefront from becoming temporarily unavailable while installing the Shopgate plugin, disable cache in your Magento 2 backend:

Before you install or update the Shopgate plugin, 
 

 disable Magento cache if enabled

 disable all external caching (e.g. Varnish, APC, ZendCache) if used

After you install or update the Shopgate plugin,
 

enable Magento cache again

flush the internal cache and all external cache immediately

 

1.2 Downloading the Shopgate plugin

Download and install the Shopgate extension for Magento 2 from the Magento Marketplace.

 

 

2. Connecting the plugin to Shopgate

After the Shopgate plugin has been installed, follow the steps here to connect your mobile shop to your Magento 2 backend.

  1. Log in to your Shopgate Admin
  2. Navigate to  Integration then  Install Interface.
  3. In section "New Connection", search for Magento 2 in the drop-down and select it when it appears.
  4. A pop-up opens.
new_connection_magento_2_500.png

2.1 Getting API credentials

In the pop-up, copy Customer number, Shop number, API key, and Alias and paste them individually into the plugin configurations in your Magento 2 admin panel (Stores > Settings > Configuration).

connecting_to_magento_2___where_to_enter.png

The rest of the plugin configurations can be entered later. This is explained in Understanding the plugin configurations

.

 

2.2 Connecting your shop to Shopgate

Under 2. Enter URL, enter the URL of your shop. Click connect to establish the interface.connecting_to_magento_2_enter_URL.png

If a connection is made successfully, a popup shown below will open. Leave all assignments to ON to access all the features. Click Save.

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

 

 

3. Understanding the plugin configurations

In this chapter, we will explain all the options you have for configuring the Shopgate plugin in your Magento 2 backend.

To locate the Shopgate configuration, follow the steps here:

  1. Log into your Magento 2 Admin Panel
  2. Navigate to Stores > Settings > Configuration.
  3. You will see SHOPGATE listed on the configuration page.
  4. Use these sections to configure your Shopgate plugin: Configuration, Export, Import, Advanced

 

Shopgate | Configuration

Basic Configuration  
Enabled Select Yes to activate the Shopgate plugin in your Magento 2 backend.
Customer number Your customer number at Shopgate.
Shop number Your shop number at Shopgate.
API Key Your API Key generated at Shopgate. This key is used to authenticate your account between Shopgate and Magento.
Mobile Settings  
Redirect Type Select your redirect type: HTTP or JavaScript. HTTP is recommended because it is more SEO friendly.
Website alias Your Shopgate alias.
Custom URL A URL used for the mobile version of your shop. The default is [alias].shopgate.com, an alternate could be m.[alias].com
CMS Map This feature allows mapping a Magento 2 CMS page to a CMS page created in your Shopgate Admin. Provide the URL key used by the CMS page in Shopgate.

  

Shopgate | Export

Categories  
Force export disabled categories List a comma separated list of category ID's (e.g. 1,4,6,34) which should be exported even if they are disabled.
In navigation only Export categories that only have the "Include In Navigation" checked
Products  
Description Choose how you want to export your descriptions: Short description, Description + short description, Short description + description.
EAN attribute Select the attribute used for the EAN from the list.
Miscellaneous  
Net Market Countries Use the default value from Magento 2 or select the countries where your product prices are defined before tax (e.g. United States)

 

Shopgate | Import

Order  
Send an email to customer on new order On each order import the customer will get an order confirmation mail after import. This flag should be used in conjunction with the 'send confirmation mail' flag in the Shopgate merchant area.
Shopgate Shipping Carrier Title This text field allows the merchant to define a shipping title for any shipping handled by Shopgate. This shipping title is used in emails and order details.

 

Shopgate | Advanced

Staging  
Shopgate server Select the Shopgate "Live" server. Use the other options only for debugging purposes.
Shopgate Merchant API URL This field is used only when Shopgate server is set to “custom” and is only useful for debugging purposes.
.htaccess user .htaccess user and password are only used to bypass additional htaccess authentications.
.htaccess password

 

 

4. Frequently Asked Questions (FAQ)

4.1 How to flush or disable the Magento cache?

If you need to flush or disable the Magento cache in order to install or update a Shopgate plugin, follow the steps here. Remember to enable the Configuration cache again after the plugin is installed or updated.

  1. Go to System > ToolsCache Management.







  2. Click the button Flush Magento Cache to clear the Magento cache.


  3. To temporarily disable the Magento cache, select Configuration, set Action to Disable, then click Submit.

Now the Magento cache has been flushed and disabled.

 

 

 

 

Comments