Akeneo Visual Swatch Attribute

• This module works with Akeneo, Akeneo 4.x, 5.x,6.x and7.x. Download Akeneo from here
• Node and Yarn packages need to be installed.
• Also, the module is compatible with the Akeneo community and Enterprise(Flexibility) edition.
• In case, 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.

• Create a Visual Swatch type attribute with the options and swatch value.
• Can select color if images are not uploaded for visual swatch attribute options.
• Make a family variant axis for the visual swatch attribute.
• Can upload images in options of visual swatch attribute.
• Export Visual Swatch attribute options in CSV and XLSX.
• Import Visual Swatch attribute options in CSV and XLSX.
• You can create two type of visual swatch attributes Visual Swatch Multi Select and Visual Swatch Simple Select

Two different types of module installation processes are available for the module.

1. Composer Installation
2. Manual Installation

Read This Blog

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/visualswatchattributebundle/src/Webkul/VisualSwatchAttributeBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
        ],
        "post-install-cmd": [
           "vendor/webkul/visualswatchattributebundle/src/Webkul/VisualSwatchAttributeBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
        ],
        "post-create-project-cmd": [
          "vendor/webkul/visualswatchattributebundle/src/Webkul/VisualSwatchAttributeBundle/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/visualswatchattributebundle/composer_install.sh"
        ],
        "post-install-cmd": [
           "vendor/webkul/visualswatchattributebundle/composer_install.sh"
        ],
        "post-create-project-cmd": [
          "vendor/webkul/visualswatchattributebundle/composer_install.sh"
       ]
   },
  "repositories": [{
    "type": "composer",
    "url": "https://akeneorepo.webkul.com/"
  }]
}

3: Use composer to install the extension.

         composer require webkul/visualswatchattributebundle

4: Complete the authentication form.
5: Send a Message of Success
6: Delete your browser’s cache.

•  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/VisualSwatchAttributeBundle/install/config.sh COMPOSER=false NO_DOCKER=true

• After that run the command below over the PIM directory’s DOCKER instance.

./src/Webkul/VisualSwatchAttributeBundle/install/config.sh COMPOSER=false NO_DOCKER=false

To know how to install the Akeneo Visual Swatch Attribute module in Akeneo, please follow the below steps:

1. First, unzip the respective extension zip, then merge the “src” folder into the Akeneo project root directory.

2. Then goto config/Bundles.php then add the line:

Webkul\VisualSwatchAttributeBundle\VisualSwatchAttributeBundle::class => ['all' => true],

in return array.

3 – After that copy the “config” folder into akeneo project root directory for routing.

4 – 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 visualswatchattribute:setup:install;

5 – 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

For Akeneo 4

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;

After uninstalling the Visual Swatch Attribute Connector then you need to run the below command:(Run the following command after ssh to your akeneo server by terminal)

php bin/console d:q:s "delete from pim_catalog_attribute where attribute_type='pim_catalog_visual_swatch'"

• From the PIM directory, run the command below over the NO-DOCKER Instance.

./src/Webkul/VisualSwatchAttributeBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=true

• Run the command below over the PIM directory’s DOCKER instance.

./src/Webkul/VisualSwatchAttributeBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=false

• After uninstalling the Visual Swatch Attribute Connector then you need to run the below command: (Run the following command after ssh to your akeneo server by terminal)

php bin/console d:q:s "delete from pim_catalog_attribute where attribute_type='pim_catalog_visual_swatch'"

So, after installing the Akeneo Visual Swatch Attribute module, log in to your dashboard in Akeneo. Next, select Settings>Attributes.

After that click on Create Attribute to create new attributes.

Then, click the Create Attribute button. A pop-up window will appear; select Visual Swatch attribute type.

Visual Swatch Multi Select: If you want to select multiple swatches in a single Visual Swatch attribute, then you need to select this attribute type.

Visual Swatch Simple Select: If you want to select single swatches in a single Visual Swatch attribute, then you need to select this attribute type.

After that, you have to enter the code and label to create a new attribute.

In the Properties section, enter any value in Code then select any Attribute Group in which you want to assign this new visual swatch attribute.

Enter the table attribute label with translations and click the Save button.

A new tab labeled “Option” will appear in the attribute once you click the save button.

You have to enter the code of the option and label it in all locals.

In swatch once you will click on the drop-down button then you see the following option:

• Choose a color
• Upload a file
• Clear

Choose a color: The color picker will pop up once you select the option. Place your cursor in the color picker and choose the color you wish to use in the swatch.

 

Upload a file: In this, you can select the image which you want to add to the swatch instead of images.

Clear: Once you click on the option “clear,” the old image or color that you have selected will be deleted.

Sort automatically options by alphabetical order: Once you will enable this option all the options will be listed in alphabetical order.

Similarly you can create Visual Swatch Multi Select.

After that, you can see all the swatch attributes that were created

You must first assign them to a Family in order to use visual swatch attributes. In the next step is to navigate to Settings>Families>Edit>Add Attributes.

Click the Save button after selecting your new attribute.

After that, you can add the attribute while creating a variant to create a variant click on variants>> add variants.

Fill in the details and select the variant level and variant axis level.

Note: If you have enabled the option localizable, locale-specific and scopable in the attribute will create the visual swatch attribute the variant will not be created.

After that go to Products and create a product with the same family in which you have added the visual swatch attribute.

After that choose the swatch from the drop-down that applies to the selected products and click Save.

By clicking the + icon, you can add any other options you may have missed to include while creating the attribute.

Once you select the option, a new tab will open in which you must enter the code, label, and swatch that you want to add.

Once you will click on the save button you will see the new option in the list.

Product Model:

To create a product in Akeneo, go to Navigation to Products, then click the Create button. Now, you need to choose the product type – Product Model.

Now enter the required SKU, choose a family, variant then click the Save button.

After that, you need to provide product information according to the requirements. Then enter basic product details such as product name, description, SKU, price, etc.

After that, you can add variants by clicking on add variants.

Then select the variant which you want to add by clicking on the drop-down.

Then enter the code and click on the save button. A new visual swatch variant will be added.

If you have enabled the visual swatch attribute for use in the grid then you can check the attribute in the filter section.

However here you will find two different types of export job profiles for every use case:-

• Attribute option export in CSV
• Attribute option export in XLSX

First, go to Exports > Create Export Profile and enter a unique code, label and select a job profile

After that, click the Save button to view the export job profile you created. And fill in all the detail in the export job.

Export Now

After creating the export profile, click on the Export Now button. The execution of the export process will begin, and the page will refresh continually to update the information.

Execution Process

After that, wait for the execution process to complete and check the errors.

After that to export your product data you need to create a job profile and execute it.

Then clicking on “Download Generated Files,” you can download the CSV files. Similarly, you can export the attribute in the XLSX file

Once you click on “Download the generated archive,” you can download the visual swatch’s images.

Downloaded image file along with CSV as well XLSX file.

Once you will click on the files folder you will find all the images.

However here you will find two different types of import job profiles for every use case:-

• Attribute option import in CSV
• Attribute option import in XLSX

First, go to Imports > Create Import Profile and enter a unique code, label and select a job profile

After that, click the Save button to view the import job profile you created. And fill in all the detail in the import job.

Import Now

After creating the import profile enter the file path or upload the file, click on the Import Now button. The execution of the export process will begin, and the page will refresh continually to update the information.

Execution Process

After that, wait for the execution process to complete and check the errors.

Thank you for reading this documentation. For any queries or doubts, reach out to us at support@webkul.com. You can also raise a ticket at our HelpDesk System.

Please explore our Akeneo Development Services and Quality Akeneo Extensions.