Menu Close
    Searching for an experienced Akeneo Development Company ?

    Akeneo Icecat Connector

    Introduction

    Akeneo Icecat Connector gives the capability to enrich Akeneo PIM product data with the rich Icecat catalog. It can be used with both an open Icecat free catalog or full Icecat paid catalog.

    Basic Requirements:

    • This module works with Akeneo 3.0.x, 3.1.x, 3.2.x, 4.0.x and 5.0.x. Download Akeneo from here
    • Node and Yarn packages need to be installed.
    • This module is compatible with the Akeneo community and Enterprise(Flexibility) edition.
    • If you want to use this extension on Akeneo EE Serenity mode, please contact us.
    • For the Akeneo installation, your Akeneo server should meet these system requirements.

    Features

    • EAN attribute and product code will be used to match Icecat products via their web API.
    • In this Akeneo PIM attributes must also be mapped to Icecat features.
    • Akeneo products will enrich via running a product enrich job.
    • In this, you can map Icecat common attributes like Ean, Product code, Vendor (Brand), Name, Description, Short description, Summary description, Short summary description, and Pictures with Akeneo attribute through UI.
    • Icecat Akeneo Connector is compatible with the latest Akeneo version 5.0.x
    • In this, you can also do other Icecat feature mapping to map other Icecat feature attribute with the Akeneo attribute.
    • You can also map the Icecat locale with the Akeneo locale.

    Module Installation for Version 4.x to 5.x

    Before installing the module you must require the connector dependencies.

    php -d memory_limit=4G /usr/local/bin/composer --prefer-dist --no-scripts require guzzlehttp/guzzle 6.*;
    php -d memory_limit=4G /usr/local/bin/composer --prefer-dist --no-scripts require prewk/xml-string-streamer 0.9.*;

    Please follow the below steps for installing the Akeneo Icecat Connector module in your Akeneo PIM platform.

    • Unzip the respective extension zip then merge the “src” folder into the Akeneo project root directory.
    src-icecat-1
    • Goto config/Bundles.php then add line:
    Webkul\IcecatConnectorBundle\IcecatConnectorBundle::class => ['all' => true],
    Screenshot-from-2021-01-27-13-41-31

    in return array.

    • Copy the “config” folder into akeneo project root directory for routing.
    conf-icecat
    • 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.
    php bin/console ca:cl && php bin/console icecat:setup:install

    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;

    Module Installation for Version 3.x

    Before installing the module you must require the connector dependencies.

    php -d memory_limit=4G /usr/local/bin/composer --prefer-dist --no-scripts require guzzlehttp/guzzle 6.*;
    php -d memory_limit=4G /usr/local/bin/composer --prefer-dist --no-scripts require prewk/xml-string-streamer 0.9.*;

    Please follow the below steps for installing the Akeneo Icecat Connector module in your Akeneo PIM platform.

    • Unzip the respective extension zip then merge the “src” folder into the Akeneo project root directory.
    src-icecat-2
    • Goto app/AppKernel.php then add the following line in function registerProjectBundles().
    new Webkul\IcecatConnectorBundle\IcecatConnectorBundle(),
    app-kernel
    • Goto app/config/routing.yml then add these lines at top of the file
    webkul_icecat_connector:
        resource: "@IcecatConnectorBundle/Resources/config/routing.yml"
        prefix: /
    Screenshot-from-2021-01-27-13-42-22
    • 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.
    php bin/console ca:cl && php bin/console icecat:setup:install

    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
    Webpack-error-4

    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.

    Workflow

    After successfully installing the module in Akeneo, you will see the Icecat connector icon in Akeneo from the bottom left as shown below.

    icecat-connector-1


    Setup Credential

    To set up credential you have to click on the icon on the Icecat Connector.

    After that it will redirect you to the new page in which you have to fill details like:

    • Icecat username
    • Icecat password
    Akeneo-Icecat-Connector-1

    After that you have to click on Save to save the credentials.

    Icecat Common Attributes Mapping

    In this, you have to map you Akeneo attributes with the Icecat attribute so that they can syn properly and while import data from Icecat to Akeneo there will be no error.

    You have to map the following attributes:

    • EAN attribute
    • Product code
    • Vendor (Brand)
    • Name
    • Title
    • Description attribute
    • Short description attribute
    • Short summary description attribute
    • Pictures attribute
    • Summary description attribute
    Akeneo-Icecat-Connector-2

    Icecat Other Attribute Mapping

    In this you can add new icecat attribute that is imported from Icecat then you can map that attribute with Akeneo attributes.

    Akeneo-Icecat-Connector-3

    To add Icecat attribute for that you have to create an import profile.

    import-feature-mapping

    After that click to Save button. Then click to Import now to run the execution job.

    feature-mapping

    Then after running the complete job you can see the imported attributes and the select the attribute according to your requirment.

    select-more-attribute

    Icecat attribute type mapping

    In this you can add new icecat attribute that is imported from Icecat then you can map that attribute with Akeneo attribute type.

    Akeneo-Icecat-Connector-4

    Locale Mapping

    In this section you can map Akeneo local with Icecat local.

    Akeneo-Icecat-Connector-5

    Create a Simple Product

    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.
    ice-cat-simple-product

    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.

    In this SKU will be filled of the product that you want to import from Icecat to Akeneo.

    icecat-product-sku-1
    icecat-product-sku

    After that click to Save.Then the product will be created on Akeneo.

    icecat-product

    After that assign the product in the particular category to import the data in that particular category products.

    Import Jobs

    In this Icecat Akeneo Connector there are three types of import jobs.

    • Features Mapping
    • Import Attribute
    • Enrich Product
    Import-profiles-management

    Now to import enrich Akeneo PIM product data with the rich Icecat catalog you have to create an import job for that navigate to Import>>Create Import Profile

    Import-profiles-management-10

    After clicking on create Import Profile it will redirect you to the new page in which you have to fill in details like:

    • Code
    • Label
    • Job
    create-import-profile

    Click Save then go to the Content section and select your channel & locales.

    After that, you can use various filters for deciding which products to import. Therefore you can even import some specific products using their SKU values use commas for more than one SKUs.

    incecat-content

    After that, click to Global setting in this you can do two things:

    • Enable/Disable Download Image
    • Fallback locale
    global-setting

    Click Save to apply your changes then click Import Now button then wait for the product execution job to get completed.

    product-impoted

    Once the import process is finished, you can see the product data filled.

    product-details

    Support

    This was all about the Akeneo Icecat Connector. I hope you must have the got the idea of our module. Thanks for taking the time in reading this blog. And also, please doesn’t forget to share your feedback and suggestions under the comment box given below.

    Moreover, If you have any queries or suggestions, then feel free to add a ticket at our HelpDesk system or reach out to us at [email protected].

    Please explore our Akeneo Development Services and Quality Akeneo Extensions.

    Current Product Version - 2.0.0

    Supported Framework Version - Akeneo - 3.x.x, 4.x.x & 5.x.x

    Blog Version - Akeneo - 3.x.x, 4.x.x & 5.x.x
    • Version Akeneo - 3.x.x, 4.x.x & 5.x.x
    • Version Akeneo - 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x and 4.0.x
    • Version Akeneo - 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x and 3.2.x
    . . .
    Discuss on Helpdesk

    Leave a Comment

    Your email address will not be published. Required fields are marked*


    Be the first to comment.

    Back to Top

    Table of Content

    Hide Index