Considering the convenience of managing the product information using Akeneo, Webkul has introduced Shopware6 Akeneo Connector.
Shopware is a leading Germany based e-commerce platform. Till the date, the platform has received more than 80 thousand users and it is a wondrous e-commerce solution in the DASH region and surrounding territories.
Shopware is an open-source eCommerce framework. Meanwhile, the features which are taking this Plateform to the prime levels are content management capability, Drag-Drop design layout, Multi-warehouse system, scalability and performance, and many more.
Basic Requirement:
- You must be using Shopware 6.x
- This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x and 3.2.x.
Features
- Export Categories from Akeneo to Shopware6
- Export Attributes and attribute options from Akeneo to Shopware6
- Import Manufacturer, Tax, Sales Channel, Scale Unit, Delivery Time value from Shopware6 to Akeneo
- Export Products from Akeneo to Shopware6
- Export Product Model from Akeneo to Shopware6
- Filter data to be Exported based on Category, family, Completeness, Identifier(SKU), Language and Currency for Product Export.
- Export Product Images
- Export custom attributes value from Akeneo to Shopware6
- Multi Credentials Configuration using UI.
- Export Tags from Akeneo to Shopware6
- Customizable Attribute Mapping with the default value.
Installing Module:
Please follow these steps for installing the Shopware6Akeneo PIM Connector module in your Akeneo PIM platform.
Step 1 – Unzip the respective extension zip then merge the “src” folder into the Akeneo project root directory.
Step 2 – Goto app/AppKernel.php. Then add a line in function registerProjectBundles()
new Webkul\ShopWare6Bundle\ShopWare6Bundle(),
Step 3 –Goto app/config/routing.yml. Then add these lines at top of the file.
shop_ware6:
resource: “@ShopWare6Bundle/Resources/config/routing.yml”
prefix:
Step 4 –Run this command after ssh to your Akeneo server by the terminal.
php bin/console cache:clear --env=prod && php bin/console pim:install:asset --env=prod && php bin/console assets:install web --symlink && yarn run webpack && php bin/console d:s:u --force
Common Issues After Installation
It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. While in that case, do check for the following solution:
- Webpack Installation: If you get the below error.
It means that a web pack is not installed in your system. Run the following command.
npm install --save-prod webpack npm install
- Module routing.yml is not configured properly. Re-check the routing.yml file as mentioned in the 3rd step of Module Installation
- Clear your browser cache.
Setup Credentials In Akeneo
After installing the module in Akeneo, you need to set up the Shopware6 API keys in Akeneo. Therefore, log into Akeneo then navigate to Shopware6 Connector>Setup Credentials you need to enter your website URL, then enter the Shopware6 API Integration Tokens as created.
- Url
- Client id
- Client secret
Click to Save button.
Locale Mapping:
In the Locale Mapping section, you can add locales for your Shopware6 store.
Attribute Mapping:
After setting up the Shopware6 API keys in Akeneo, Therefor you need to map the product fields between Shopware6 and Akeneo as per the below image.
Map More Standard Attribute:
If your products have lots of information, you can enter Shopware6 attribute code ID then click Add Field. The Shopware6 Akeneo Connector module supports various attributes of Shopware6 products. Please make sure to use the same attribute code of Shopware6 in Akeneo.
Other Mapping:
Attributes to be used as Images – The selected Akeneo image attributes will be visible as Shopware6 product gallery images.
Attribute to be used as Properties Values(For Export) – The selected Akeneo properties value(color, material, brand, etc) will be exported to Shopware6 from Akeneo.
Attributes and Family to be used as Tags – The selected Akeneo attribute and family will be exported to Shopware6 from Akeneo
Other Setting:
For Mapping for boolean Tags
In this, you have to select
- Yes/NO
- True/False
Import Attibute:
To export some of the product details like tax, manufacture, delivery time, sales and scale. You need to first import that attributes so that the attribute id of shopware6 will also be imported to Akeneo. After that, there will be no error while exporting the product.
Now to import the attribute from Shopware6 to Akeneo. Create the export profile for that you have to navigate to Import>>Create Import Profile.
Import Tax:
Then to create an import profile fill code, label, and select the job.
Click to Save option.
After that click to the Import button.
Now you can check the export details.
Import Manufacturer:
Then to create an import profile fill code, label, and select the job.
Click to Save option.
After that click to the Import button.
Credentials:
You need to activate the credentials to export the products from Akeneo to Shopware6. The active credential will be visible at the time of creating an export profile.
You can also enable the option to Quick Export the products from the Akeneo product grid.
- Activated
- Default for QuickExport
Create Simple Product In Akeneo:
You can also create a product in Akeneo. Therefore, navigate to Products. Then click the Create button.
Now, you need to choose your action – as Product or Product Model as per the below image. You can select-
- Product – if you want to create simple products.
Enter the SKU, choose a family, then click the Save button as per the below image.
Product Family – This is a set of attributes that will be the same for all products belonging to a family.
The product family represents product type, imposes product information structure and defines the list of attributes for a product that it belongs to.
Add Product Details
Now you need to provide information about the product.
After that, enter the details like tax, manufacturer, and upload the product image.
Select Attribute
In order to add product information, select the attribute options you require. Therefore, you can also create new options for the attribute.
Following Attributes from Akeneo are supported for export:
- Text
- Text Area
- Number
- Date
- Yes/No
- Select
- Price
- Metric
- Image
Multi-Lingual Information
Once you will be done with attributes then Add information for other languages and store views.
Select Category
After entering all the product information. Then you can also select Categories for the created product.
Shopware6 Export Job:
In order to export the products, first of all, you need to create the Export Profile. Therefore, navigate to Exports -> Create Export Profile as per the below image.
Tapping on create an export profile button will redirect you to the Export Profile page. Therefore, you will enter a unique code, label and select a job profile.
In the Job field, you need to select the Shopware6 Product Export Job.
Then click Save.
Filter The Data:
You can export the filtered data. Therefore, navigate to the Content section as per the below image.
You can filter the data as per-
- Channel – This selects the relevant channel of products to export.
- Locales – Depending as per your choice multiple locals can be selected.
- Currency – Select the default currency which you want to export.
- Attributes – select the product attributes which you want to export. You can either select all attributes else click the edit button to select the attributes.
After that click the Save button.
Note -: Before exporting product fro Akeneo to Shopware you need to export attribute, attribute option, and category.
Export Now:
After creating the export profile, click on the Export Now button as per the below image.
Execution Process:
After the execution of the export process, you can check the process summary and errors if present.
Shopware6 Backend:
After the completion of the export process, you can check the products in the Shopware6 catalog. The admin can view the products so if there will be any changes in the product edit form of Shopware6 as per the below image.
Store View:
Once the product exported from Akeneo will appear on the storefront as per the image.
Support
For any issues related to this module, please create a support ticket at- https://webkul.uvdesk.com/en/customer/create-ticket. You can also check other Akeneo Modules. Also, for any pre-sales queries or customization discussion, please drop an email to support@webkul.com