Introduction
AliExpress Akeneo Importer extension allows you to connect the AliExpress marketplace to your Akeneo PIM platform. With the help of AliExpress-Akeneo integration, you’ll be able to import products including variations from the AliExpress website to your Akeneo product database.
Please Note – For importing products from the AliExpress website, you need to install the AliExpress Akeneo Importer extension in your Google Chrome web browser. For it, you can add the extension after that install it from here.
Basic Requirements:
- This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x, 6.0.x and 7.0.x. Download Akeneo from here
- Node and Yarn packages need to be installed.
Features
- One-click import button on the category page and product page
- Import simple and variation products
- Variation prices are automatically mapped from the product page
- Basic attributes mapping configuration
- Edit product details before importing
- AliExpress Akeneo Importer is compatible with the latest Akeneo version 7.0.x
- Secure access token integration
- Custom attributes are created in Akeneo
- Imports all the product images
- Detailed product description including text formatting
- Choose Akeneo family for AliExpress imported products
- Select how to import Item Specifics information in Akeneo
- SEO information – meta title, meta description, meta keywords
Video Tutorial
Check out the following video tutorial below:
How to import products from AliExpress to Akeneo?
Installation
For the module, there are two different installation processes available.
- Composer Installation
- Manual Installation
Installation using Composer Installation
Before beginning the composer installation
1: Get the ACCESS KEYS [Create a support ticket]
2: In Akeneo composer.json, add our repository as well as the installation script.
For Akeneo 6.x and 7.x
{ "scripts": { "post-update-cmd": [ "vendor/webkul/aliexpressproductbundle/src/Webkul/AliExpressProductBundle/install/config.sh COMPOSER=true NO_DOCKER=true" ], "post-install-cmd": [ "vendor/webkul/aliexpressproductbundle/src/Webkul/AliExpressProductBundle/install/config.sh COMPOSER=true NO_DOCKER=true" ], "post-create-project-cmd": [ "vendor/webkul/aliexpressproductbundle/src/Webkul/AliExpressProductBundle/install/config.sh COMPOSER=true NO_DOCKER=true" ] }, "repositories": [{ "type": "composer", "url": "https://akeneorepo.webkul.com/" }] }
For Akeneo <=5.x
{ "scripts": { "post-update-cmd": [ "vendor/webkul/aliexpressproductbundle/composer_install.sh" ], "post-install-cmd": [ "vendor/webkul/aliexpressproductbundle/composer_install.sh" ], "post-create-project-cmd": [ "vendor/webkul/aliexpressproductbundle/composer_install.sh" ] }, "repositories": [{ "type": "composer", "url": "https://akeneorepo.webkul.com/" }] }
3: Use composer to install the extension.
composer require webkul/aliexpressproductbundle
4: Complete the authentication form.
5: Send a Message of Success
6: Delete your browser’s cache.
Manual Installation for Version 6. x and 7.x
- After unzipping the appropriate extension zip, merge the “src” folder into the akeneo project.
- From the PIM directory, run the following command over the NO-DOCKER Instance.
./src/Webkul/AliExpressProductBundle/install/config.sh COMPOSER=false NO_DOCKER=true
- Run the command below over the PIM directory’s DOCKER instance.
./src/Webkul/AliExpressProductBundle/install/config.sh COMPOSER=false NO_DOCKER=false
Manual Installation for Version 4.0.x to 5.0.x
Please follow these steps for installing the module in your Akeneo PIM platform.
1 – Unzip the respective extension zip then merge the “src” folder into the akeneo project root directory.
2 – After that goto config/Bundles.php then add line:
Webkul\AliExpressProductBundle\AliExpressProductBundle::class => ['all' => true],
3 – Then copy the “config” folder into the akeneo project root directory for routing.
4 – After that run this command after ssh to your akeneo server by the terminal
php bin/console ca:cl --env=prod;php bin/console aliexpress:setup:install --env=prod; php bin/console aliexpress:batch:importproduct;
If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.
For Akeneo 5
sudo service php-fpm7.4 restart
sudo service php-fpm7.3 restart
Docker Installation Command :
For Akeneo 5
alias docker_php='docker-compose run -u www-data --rm php php'; alias docker_yarn='docker-compose run -u node --rm node yarn'; docker_php bin/console cache:clear --env=prod; docker_php bin/console pim:installer:assets --symlink --clean --env=prod; docker_php bin/console d:s:u --force; docker_yarn run webpack; docker_yarn run update-extensions; docker_yarn run less;
For Akeneo 4
alias docker_php='docker-compose run -u www-data --rm php php'; alias docker_yarn='docker-compose run -u node --rm node yarn'; docker_php bin/console cache:clear --env=prod; docker_php bin/console pim:installer:assets --symlink --clean --env=prod; docker_php bin/console d:s:u --force; docker_yarn run webpack; docker_yarn run less;
Installation for Version 2.x to 3.x
After extracting the downloaded module zip file, please follow the installation procedure below:
1 – Unzip the respective extension zip then merge the “src” folder into the Akeneo project root directory.
2 – Then go to app/AppKernel.php after that add the following line.
new Webkul\\AliExpressProductBundle\\AliExpressProductBundle(),
3 – After that goto app/config/routing.yml then add these lines at top of the file.Afterthat
ali_express_product: resource: "@AliExpressProductBundle/Resources/config/routing.yml" prefix: /
4 – Then you have to navigate first to Akeneo installation directory (Ex: cd /opt/bitnami/apps/akeneo/htdocs). After SSH, you have to run the command to your Akeneo server by the terminal.
rm -rf ./var/cache/** && 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 && php bin/console aliexpress:batch:importproduct
5 – After that you have to restart your web server like Apache, Nginx. Run the command for Apache web server.
sudo service apache2 restart
6. If you are using php-fpm. Then you need to restart the php-fpm services.
sudo service php-fpm7.2 restart
Common Issues After Installation
It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. In that case, do check for the following solution:
- Webpack Installation: If you get the below error
- It means that webpack 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.
Uninstall Module: For Akeneo 6 and 7
- From the PIM directory, run the command below over the NO-DOCKER Instance.
./src/Webkul/AliExpressProductBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=true
- Run the command below over the PIM directory’s DOCKER instance.
./src/Webkul/AliExpressProductBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=false
Install Chrome Extension
After installing the module in Akeneo, then you have to install the AliExpress Akeneo Importer module extension in your Google Chrome browser.
Installation Steps:
For installing the AliExpress Akeneo Importer module extension in your Google Chrome browser, after that you have to navigate Live Demo. AliExpress Akeneo Importer
After it, you have to click on the AliExpress Chrome Extension to download the folder.
After that you have to upload the downloaded folder here.
Then you are able to see the installed AliExpress Akeneo Importer Extension in Akeneo.
Attribute Mapping
Once you have installed both the modules in Akeneo and Chrome web browsers.After that login to your Akeneo admin panel then go to AliExpress icon menu option.
In the Attribute Mapping tab, you need to select the attributes of Akeneo that matches the products fields in AliExpress. Here, you can map the following product details:
- Name
- Description
- Meta Title
- Price
- Meta Keyword
- Meta Description
Importer Settings
After that, from the AliExpress Importer Setting tab, you need to configure some options for the imported products.
Set Family – Here, you need to select the family where all the AliExpress products will be imported.
Set Item Specifics Import – Select how Item specifics data will be imported then created in Akeneo. After that you have two options to choose from:
- Custom Attribute – In this option, different attributes will be created for each specification.
- Description – In this option, all the specification information will be visible in one description attribute.
Product Importer – Configuration
After that, once you have done the installation and configuration, then go to AliExpress website then visit a category page or a product page.
Then, when you hover your cursor, you will find AliExpress Importer icon on the products, click it.
Connect Your Akeneo PIM
Then enter your Akeneo Admin Panel URL after that click Next. Please make sure not to include any / (slash).
Credential to Access Akeneo
After that, you need to enter your Akeneo Access Token credential here.
Then to find this token key, log in to your Akeneo admin panel after that follow AliExpress >Credentials>AliExpress Token.
After that copy, your AliExpress Token key from here then use it to securely connect your Akeneo with the AliExpress website for integration.
One-Click Import
After that, you have configured the AliExpress Akeneo Importer Chrome extension. Then you can visit any category page or product page on the AliExpress website after that click the blue icon.
Category Page
Edit This Product
When you click the AliExpress Importer icon, the following pop-up window will appear. From this functionality, you can edit some details of the product before sending it to Akeneo.
After that, you can edit – the name, price, meta tag title, meta tag description, meta tag keywords, and edit prices of variations.
Product Page
After that, from the product page, you can also use AliExpress Akeneo Importer. Then click the blue icon then check or edit the product details.
Variation Prices
All the variation prices of the product will be accurately mapped in Akeneo.
Please Note – For importing a product which has multiple variations pricing, you must import that product from its respective product page, not from the category page.
View Imported Products
After that, the import process takes a few seconds to show up in Akeneo.
Then the product will be imported to Akeneo you can check the product you have imported.
Then you can check after that you can edit all product information.
Like SKU, product name, item specifics, all images, meta title, meta description, meta keywords, and detailed product description.
Detailed Description
The detailed information about the AliExpress product is fetched from the website with all the images, text formattings, tables, etc.
Variant Products
After that, all the variations are imported with all the common and variant-specific information like SKU.
Each variant product SKU will be different from its product model, which greatly helps for better product identification management and stock keeping.
Category Assign
If a category already exists in Akeneo, the imported products will be assigned to the respective category.
But, if AliExpress imported product’s category is not available, the module will automatically create that category in Akeneo.
Execution Process
You can check the execution process to complete and then check the errors for that you have to Activity>>Process tracker
Also you can check the import data notification on the product by clicking on the notification icon.
Then a pop up appear with the import details.
Support
So, that was much about the User Guide of Aliexpress Akeneo Importer for any queries or doubts reach out to us at [email protected]. You can also raise a ticket at our HelpDesk System.
Please explore our Akeneo Development Services and Quality Akeneo Extensions.
Current Product Version - Akeneo 2 to 5 || 3.0.0, Akeneo 6 || 4.0.0 and Akeneo 7 || 5.0.0
Supported Framework Version - Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x 3.2.x, 4.0.x, 5.0.x, 6.0.x and 7.0.x
Regards: eve hunt