Once you have integrated the Shopgate plugin into your Magento 2 shop, the following features are available for your app:
| Support | Import to Magento 2 | ||
| Version | 2.1+ | Orders | ✔ |
| Customer account | Export to Shopgate | ||
| Login with desktop shop account | ✔ | Products | ✔ |
|
Login with mobile account |
✔ | Categories | ✔ |
| Customer groups/tier prices | ✔ / ✔ | Reviews | ✔ |
| Show desktop order history on mobile | ✘ | ||
| Sync | Live cart validation | ||
| Delivery status "shipped" | ✘ | Coupons* | ✔ |
| Order status "cancelled" | ✘ | Shipping methods | ✔ |
| Stock quantity (product detail page) | ✔ | Payment methods | ✘ |
| Product availability | ✔ | ||
| Natively supported payment methods | Notes | ||
|
|
||
Installing the Shopgate plugin
First steps
To prevent your shop from being temporarily unavailable during the plugin installation, you should take the following measures. To do this, log in to Magento 2.
| Before you install or update the Shopgate plugin: |
|
✓ Disable the Magento cache, if enabled ✓ Disable any external caching (e.g. Varnish, APC, ZendCache), if enabled |
| After you have installed or updated the Shopgate plugin: |
|
✓ Re-enable the Magento cache ✓ Clear the internal cache and all external caches |
Downloading the Shopgate plugin
Download the Shopgate plugin for Magento 2 from GitHub. The plugin consists of three parts:
Alternatively, you can install the extension via Composer. Our component name is "shopgate/cart-integration-magento2-m2". You can find more information about this method here.
Connecting the plugin to Shopgate
Once the Shopgate plugin is installed, follow these steps to connect your app to Magento 2.
- Log in to your Shopgate admin.
- Go to Settings › Shop Interface.
- Under "New Connection", search the drop-down menu for Magento 2 and select it when it appears.
- A pop-up window then opens.
Getting your API credentials
Copy your API credentials (customer number, shop number, API key and the alias) from the pop-up window and paste them one by one into the plugin configuration in your "Magento 2 Admin Panel" (Stores → Settings → Configuration).
You can complete the remaining plugin settings later. This is explained in the chapter "Plugin settings explained".
Connecting your shop to Shopgate
Under 2. Enter URL, enter the URL of your shop. Click Connect to set up the interface.
If the connection is successful, a pop-up window opens (see above). Leave all settings enabled (ON) as preset. This way you use all features. Then click Save.
That's it! The product data is now imported automatically via the newly set up interface.
Plugin settings explained
In this chapter, we explain all the options available for setting up your Shopgate plugin in Magento 2.
|
|
To find the Shopgate settings, follow these steps:
|
| 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, which is generated at Shopgate. This key is used to authenticate your account between Shopgate and Magento. |
| Mobile Settings | |
| Website alias | Your Shopgate alias |
| CMS Map | This feature lets you map a Magento 2 CMS page to a CMS page created in your Shopgate admin. Provide the URL key that the CMS page uses in Shopgate. |
| Categories | |
| Force export disabled categories | List comma-separated category IDs (e.g. 1,4,6,34) that should be exported even if they are disabled. |
| In navigation only | Export only the categories that have "Include In Navigation" selected. |
| Products | |
| Description | Choose how you want to export your descriptions: Short Description, Description + Short Description, Short Description + Description. |
| EAN attribute | Select the attribute from the list that is used for the EAN. |
| Miscellaneous | |
| Net Market Countries | Select the predefined Magento 2 value or select the countries in which your product prices are defined before tax (e.g. United States) |
| Order | |
| Send an email to customer on new order | For every order import, the customer receives an order confirmation email after the import. This flag should be set together with the 'send confirmation mail' flag in the Shopgate admin. |
| Shopgate Shipping Carrier Title | This text field lets merchants define a shipping title for each shipping method that Shopgate manages. This shipping title is used in emails and order details. |
| Staging | |
| Shopgate server | Select the Shopgate "Live" server. Only use the other options for debugging purposes. |
| Shopgate Merchant API URL | This field is only used if the Shopgate server is set to "custom" and is only used for debugging purposes. |
| .htaccess user | .htaccess user and .htaccess password are only used to bypass additional htaccess authentication. |
| .htaccess password | |
Frequently Asked Questions
How do I disable or clear the internal cache in Magento?
If you want to disable or clear the Magento cache to install or update the Shopgate plugin, follow these steps. Remember to re-enable the configuration cache after you have installed or updated the plugin.
- Go to System → Tools → Cache Management.
- Click Flush Magento Cache to clear the Magento cache.
- To disable the Magento cache temporarily, select Configuration, then set "Action" to Disable and click Submit.
The Magento cache has now been cleared and disabled.