Introduction
With the help of the Akeneo Category Image and Description module, you can extend as well as enrich your Akeneo category entity.
So now instead of just adding a name and translations in a category, you will be able to upload an image and add a text description also.
You can select a different language for the description. Akeneo Category Image and Description module will also work with CSV connector by using Akeneo API which will basically allow you to import/export/update rich category information easily.
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
- 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
- Works with all types of categories at any level – main category, sub-category
- Export categories data with the image as well as description fields in Akeneo CSV Connector
- Import categories data with the image as well as description fields in Akeneo CSV Connector
- Update and add image and description for existing category tree
- Rich text editor enabled for the Description field.
- Supports various image file extensions such as – jpg, jpeg, png, gif
- This module is compatible with the latest Akeneo version 7.0.x
- The source code is fully open for customization
- Export and import description fields in multilanguage.
- The image and Description module will also work with CSV connector and using Akeneo API.
Videos
Check out the following video tutorials below:
How can add a category image as well as a description
Composer Installation
Before beginning the composer installation
1: Get the ACCESS KEYS [Create a support ticket]
2: In Akeneo composer.json, add our repository and the installation script.
For Akeneo 6.x and 7.x
{
"scripts": {
"post-update-cmd": [
"vendor/webkul/categoryextendbundle/src/Webkul/CategoryExtendBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
],
"post-install-cmd": [
"vendor/webkul/categoryextendbundle/src/Webkul/CategoryExtendBundle/install/config.sh COMPOSER=true NO_DOCKER=true"
],
"post-create-project-cmd": [
"vendor/webkul/categoryextendbundle/src/Webkul/CategoryExtendBundle/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/categoryextendbundle/composer_install.sh"
],
"post-install-cmd": [
"vendor/webkul/categoryextendbundle/composer_install.sh"
],
"post-create-project-cmd": [
"vendor/webkul/categoryextendbundle/composer_install.sh"
]
},
"repositories": [{
"type": "composer",
"url": "https://akeneorepo.webkul.com/"
}]
}
3: Use composer to install the extension.
composer require webkul/categoryextendbundle
4: Complete the authentication form.
5: Send a Message of Success
6: Delete your browser’s cache.
Manual Installation For Akeneo 6 and Akeneo 7
- 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/CategoryExtendBundle/install/config.sh COMPOSER=false NO_DOCKER=true
- Run the command below over the PIM directory’s DOCKER instance.
./src/Webkul/CategoryExtendBundle/install/config.sh COMPOSER=false NO_DOCKER=false
Module Installation for Version 4.0.x to 5.0.x
Please follow the steps below for installing Akeneo Category Image and Description module after that:
1 – Once you have downloaded the module zip file, extract it. Then, find the “src” folder then merge it with Akeneo project root directory.
2 -After that goto config/Bundles.php then add line
Webkul\CategoryExtendBundle\CategoryExtendBundle::class => ['all' => true],
in return array.
3 – Then copy the “config” folder into akeneo project root directory for configuration.
4 – After that 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 category_extend: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
Module Installation for Version 2. x to 3. x
Please follow the steps below for installing Akeneo Category Image and Description module after that:
1 – Once you have downloaded the module zip file, extract it. Then, find the “src” folder then merge it with Akeneo project root directory.
2 – Go to app/AppKernel.php then add the following line:
new Webkul\CategoryExtendBundle\CategoryExtendBundle(),
in function registerProjectBundles()
3 – After that go to app/config/config.yml then add these lines in the import section.
For version Akeneo 2.x
- { resource: "@CategoryExtendBundle/Resources/config/config.yml" }
For version Akeneo 3.x
- { resource: "@CategoryExtendBundle/Resources/config/3.x/config.yml" }
4 – After that 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 category_extend:setup:install
5 – If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.
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 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.
Uninstall Module: For Akeneo 6 and Akeneo 7
- From the PIM directory, run the command below over the NO-DOCKER Instance.
./src/Webkul/CategoryExtendBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=true
- Run the command below over the PIM directory’s DOCKER instance.
./src/Webkul/CategoryExtendBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=false
- Restart the Php-fpm and apache service
Managing Category
Once you installed the module, after that you can add images as well as descriptions to your categories.
Then go to Settings>Categories.
You’ll then get a list of all root categories and a create button to add a new root category.
After that, in the Properties section, then you will find Image as well as Description fields.
Then simply upload an image from your computer after that some description content.
With the icon shown below in the image, you may download the image or view it on fullscreen.
Fullscreen category image.
After that, you must provide multilingual category description translations.
After you’ve finished adding the information, click Save to save your changes.
Support
So, that was much about the User Guide of Akeneo Category Image and Description 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
Be the first to comment.