Note: this installation procedure assumes you are familiar with FTP to upload files. If you don't know how to use FTP or don't have FTP credentials for your server, please contact your web developer for help.
If you have a Shopware webshop, you can use the official Channable Shopware plugin to import your products. We recommend that you use Shopware 5.2 or higher.
1) Download and extract the plugin
You can find the plugin by clicking on this link. You can also download it from the repository, which you can find here. For the purpose of this article, we'll assume you downloaded the plugin as a .zip file. Extract this file to a folder where you can easily find it.
2) Rename the folder and upload it
Once extracted, all files should be in a folder called 'MilchbarExportProducts-master'. Rename this folder 'MilchbarExportProducts' (removing the '-master' part). Next, open your favorite FTP client and connect to the server with your Shopware install.
Once you are logged into your server using FTP, navigate to the plugin folder from your Shopware root folder. This should be under Shopware/Plugins/Local/Backend. Upload the MilchbarExportProducts folder to this folder.
3) Enabling the plugin in Shopware
With the FTP part out of the way, open your browser and go to your Shopware backend. Go to the Plugin Manager under Configuration > Plugin Manager > Management > Installed.
Under Uninstalled plugins, you should see a plugin called 'Export Products to JSON'. Click 'Open' and then the 'Install' button to install the plugin.
4) Creating API credentials
Now that the plugin is installed, it has automatically generated an API key. You can find this key under the configuration of the plugin, labeled as 'Security token'. Copy this to a file and save it somewhere where you can access it later. However, make sure this location is secure as this key can provide API access to anyone who has it.
Saving the token is important not only because you have to enter it into Channable, but it'll need to be kept the same. The current version of the Channable Shopware plugin regenerates the API key every time it is reinstalled or updated. In order for Channable to keep being able to connect to your Shopware store, the key needs to stay the same. By saving the key, you can change the key to be identical to the old one so that Channable will recognize it.
Now that you've saved the API key, you can press 'Activate' in the plugin overview.
5) Changing the settings
If you ever want to change the settings of the plugin, you can do so under Configuration > Basic settings > Additional settings > Export Products to JSON.
6) Add a new role
Next to the security token, you also need to add a role for Channable. Go to "Configuration" - "User administration", click on "Add role" and create a new role for the Channable API. Make sure to select both "Enabled" and "Admin". Save the new role by clicking "Update".
7) Add a new user
Finally a new user has to be created. Go to "User administration" - "List of users" and click on "Add user". Name the user "channable" and connect it with the Channable role that you have created in step 1 by selecting "Member of role". You also need to check "Enabled" in the "API access" section. Copy the API key and close the window by clicking on "Save".
8) Loading the products into Channable
The Shopware part is now done. Next, make sure you're logged in in Channable. Go to the main screen in Channable and create a webshop/project if you haven't done so already.
Now that you have a webshop, you can create a new connection. Select 'New import connection' and then 'Shopware Plugin'.
Next, enter the URL of the Shopware shop, the token of the extension, the username and the API key you saved for that user before.
Now the connection is created, you can select the connection and import your products.
Congratulations! Channable will now load all the products. Once the status of the import in the setup says 'Finished', you can check out your products in the Products overview in Channable.