Skip to content
/ color Public

A product image color categorization module for Magento 2

Notifications You must be signed in to change notification settings

mage2pro/color

Repository files navigation

A product image color categorization module for Magento 2.
The module is free and open source.
It uses the Google's Cloud Vision API (based on deep learning) to detect the dominant color of a product's primary image, and then it automatically assigns the proper color swatch to the product.

When a product is saved, the module checks whether the product is a configurable child.
If so, the module checks whether the product's base image was changed. If so, the module analyses the image's colors using Google Cloud Vision API:
Then the module calculates the difference between the primary color and all swatches using the Delta E (CIE 2000) algorithm.
Sometimes the algorithm does not produce the result you want. In this case, you can correct the algorithm by specifying additional swatches for a desired color:
The module uses all samples in a color distance calculation and picks the minimum result as the distance between the swatch and the product image's dominant color. The module has a tesing sandbox. Put test images to the pub/media/mage2pro folder, and then go to the /mage2pro-color page. The sandbox will show what the module thinks about the images colors:
Please note that the module uses only color of the color Magento product attribute, so to make the module operate more colors, just add more swatches to the color attribute.

The module requires Google Application credentials. Put them to the app/etc/google-app-credentials.json file.

How to install

Hire me in Upwork, and I will:

  • install and configure the module properly on your website
  • answer your questions
  • solve compatiblity problems with third-party checkout, shipping, marketing modules
  • implement new features you need

2. Self-installation

bin/magento maintenance:enable
rm -f composer.lock
composer clear-cache
composer require mage2pro/color:*
bin/magento setup:upgrade
bin/magento cache:enable
rm -rf var/di var/generation generated/code
bin/magento setup:di:compile
rm -rf pub/static/*
bin/magento setup:static-content:deploy -f en_US <additional locales>
bin/magento maintenance:disable

How to upgrade

bin/magento maintenance:enable
composer remove mage2pro/color
rm -f composer.lock
composer clear-cache
composer require mage2pro/color:*
bin/magento setup:upgrade
rm -rf var/di var/generation generated/code
bin/magento setup:di:compile
rm -rf pub/static/*
bin/magento setup:static-content:deploy -f en_US <additional locales>
bin/magento maintenance:disable
bin/magento cache:enable