Akeneo Connector for Adobe Commerce release process
Akeneo Connector for Adobe Commerce release process
Summary
Versioning policy
Akeneo connector for Adobe Commerce's versioning policy is designed to provide our users with a clear understanding of how we manage and release software versions. Akeneo goal is to enhance the performance, security, and functionality of our connector.
Our versioning policy explains the structure of version numbers, release schedules, and the significance of each release type, whether it's a major release with groundbreaking features or a minor release with bug fixes and enhancements. This policy aims to help you stay informed about the evolution of Akeneo connector for Adobe Commerce, ensuring you can plan for updates and optimizations that best suit your e-commerce needs.
Akeneo connector for Adobe Commerce follows a standard convention for naming evolutions and bug fixes in its versioning policy. This convention ensures consistency and clarity in communicating the nature of each software update. Major releases, typically containing significant new features and enhancements, are denoted by a change in the first digit of the version number (e.g., from version 2.0 to 3.0). Minor releases, which primarily include bug fixes and smaller enhancements, are indicated by a change in the second digit (e.g., from version 2.0 to 2.1).
This naming convention helps users easily distinguish between major updates that may bring substantial changes and minor updates that focus on stability and refinement. It allows you to make informed decisions about when to upgrade your Adobe Commerce connector based on your specific needs and priorities.
You will find below the evolutions list starting in 2022. You can also follow the app store release notes for more details. The release note below only concerns the enterprise version of the connector and focuses on evolutions.
105.X.X and 104.X.X
Compatibility Information for Akeneo PIM and Adobe Commerce Integration The latest integration update for Akeneo PIM includes compatibility with Akeneo’s newest PHP client. However, please note that full compatibility may vary based on Adobe Commerce modules and configurations due to specific PHP dependencies.
Key Points on Compatibility
PHP Client Version Requirements:
Akeneo's latest PHP client requires "psr/http-message" version 2.0, but this may conflict with some Adobe Commerce modules still dependent on "psr/http-message" versions 1.0 or 1.1.
Examples of modules with different requirements include both third-party modules and certain native Adobe Commerce modules, such as Live Search, which may rely on the older versions of "psr/http-message."
Merchant Module Configuration:
The compatibility of this integration depends on the specific modules a merchant has installed. Merchants using modules that strictly require "psr/http-message" 1.0 or 1.1 may encounter compatibility issues with the upgraded integration.
Merchants with modules that support "psr/http-message" 2.0 or that don’t require strict dependencies should be compatible with the latest Akeneo PHP client.
Compatibility Recommendation:
Before upgrading, we recommend reviewing the module dependencies installed on your Adobe Commerce instance. For merchants with mixed requirements, consider consulting with your development team to determine the best approach or configuration adjustments necessary for compatibility.
105.X.X +104.X.X maintained, 103.X.X not supported anymore
In version 105.0.0, we have introduced a compatibility breaker as our PHP client is now compatible with the PHP version 8.2 only fully compatible with Adobe Commerce 2.4.7.
The 105.X.X and 104.X.X are maintainted on bugs and evolutions. By concentrating our efforts thos versions and subsequents releases, we're dedicated to delivering a more powerful and secure platform, along with exciting new features and enhancements. The 103.X.X is therefore not supported anymore and the 104.X.X is in support mode.
Version
Evolutions
Release date
105.0.0 - 105.0.1
Translate reference entity option label based on reference name
Akeneo PHP API client updated to 11.4.0. Major version: to adapt to Adobe Commerce 2.4.7, there is a compatibility break between 104.X.X versions and 105.X.X.
Adobe Commerce
PHP
Akeneo Connector
Maintained
\>= 2.4.4 && < 2.4.7
\>= 8.0
104.X.X
Maintained with evolution
\>= 2.4.7
\>= 8.2
105.X.X
Main version
Q4 2024
104.3.9-104.3.15
Do not update the default store status when multiple websites
"Create Empty Attributes Columns" step is now optional
Adds a config option to disable InnoDB Strict Mode in the session
Optimize media import
Only fill completeness when we have products
Allow to create one configurable per level 1
Symfony HTTP Client requirement updated
Q3 2024
104.3.0 - 104.3.8
Allow to assign an image to the parent (configurable, grouped, bundle) or child only (simple, virtual) - 104.3.8
Add possibility to use InnoDB as temporary table format Version - 104.3.5
Create empty columns only for price attributes that are mapped but empty in Akeneo - 104.3.3
Filter attributes, add wording to the helper - 104.3.3
Bug fixes
Q1 2024
104.3.0
Add possibility to import product bundle
Log report improvements
Allow altering properties after construct method
Bug fix
Dec. 14th
104.2.0
Allow manual retry from last step when an error occurred
Bug fix
Nov. 30th
104.0.7
Bug fix
Nov. 30th
104.1.0
Log report - Improve log interface
Pre-existing Ecommerce - Being able to map pre-existing categories
Import images for category attributes (documentation)
Allow to disable updated mode filter (documentation)
Warning: Careful, PHP Client 8.0 compatibility breaker on this version. All versions of the Akeneo connector before the version 104.0.0 will be maintained only on bugfixes
July, 21 2023
103.5.0
Select category trees to import instead of trees to exclude
Select families to import instead of families to exclude
Schedule task with a cron expression in jobs pages
Import enriched category attributes
Import Swatch colors and images
Filter products by “updated mode” in advanced mode
Assets compatibility warning removed
Allow to override default attribute values (like tax_class_id)
Allow attribute named visibility in Akeneo
Bug fixes since last release
July, 13 2023
103.4.3, 103.4.2, 103.4.1
Bug fixes
April, May 2023
103.4.0
New endpoint to link product with the UUID
Last Successful updated import date by family
Allow to import product visibility from Akeneo attribute
Improve filter and options in the log grid on family
Manage visual and text swatch attributes
Export configuration improvement
"Product Status Mode" parameter missing when selecting version 5.0 Akeneo edition
Magento to Adobe Commerce rebranding
Bug fixes since 103.3.1
March,17 2023
103.3.1
Hot fix
March, 6 2023
103.3.0
Add localizable and scopable image attribute import (documentation)
Add job grid automatic refresh in order to provide real time progress of jobs (documentation)
Add attribute option mapping when a select / multi-select attribute is mapped with an existing attribute on Adobe (documentation)
Improve extension coding standards
Fix column size improvement to manage uppercase attribute codes
Manage empty attribute values returned by Akeneo API by creating missing columns inside the product temporary table
Fix asset retro-compatibility patch from version 103.1.0 to manage empty asset configurations Warning: change of behavior on empty values
Dec 9, 2022
103.2.0
Improve column sizes per attribute type inside product temporary table in order to reduce the MYSQL table volume
Add batch for large inserts during asset association
Bug fix since 103.1.4
103.1.4, 103.1.3, 103.1.2, 103.1.1
Hot fixes
103.1.0
Rewamp asset collection attribute image import
Add the possibility to map assets to specific Magento image types
Add the possibility to import multiple asset image attributes from the same asset
Add the possibility to map different asset collection attributes to configurable and simple / grouped / virtual products
Add a configuration to hide image assets from the product gallery
Separate JSON import configuration from asset image import in the product gallery
Improve asset image import performances
Warning : When upgrading your connector to this version, make sure to double check your asset collection image import configuration if applicable.
August 25, 2022
103.0.0
Add compatibility for Magento 2.4.4 and PHP 8.1: Documentation
Remove deprecated Akeneo API client EE
Bump Akeneo API client to version 9
Replace Guzzle HTTP client by Symfony HTTP Client
Fix function usage for PHP 8
Update extension PHP compatibility to 7.4 and 8.1
Fix "special_price" and "cost" attribute being set to 0 when empty on MariaDB
May 19, 2022
102.5.0
Add product status mode "Attribute mapping" in order to map a Yes/No attribute to the status attribute
March 10, 2022
102.4.0, 102.3.2, 102.3.1, 102.3.0, 102.2.1
Hot fixes and technical improvements
102.2.0
Add new "Status mode" in order to assign simple product status from a completeness level (Documentation)
