Liferay Portal 7.4 GA125 and Liferay Commerce 4.0 GA125 Release

We are pleased to announce the release of Liferay Portal 7.4 GA125 and Liferay Commerce 4.0 GA125!

 

 

Download options

Liferay Portal and Liferay Commerce share the same Bundle and Docker image.  To get started using either Liferay Portal or Liferay Commerce, choose the best download option suited for your environment below.

Docker image

To use Liferay Portal 7.4 GA125:

docker run -it -p 8080:8080 liferay/portal:7.4.3.125-ga125

Bundles and other download options

If you are used to binary releases, you can find the Liferay Portal 7.4 GA125 and Liferay Commerce 4.0 GA125 release on the download page.  If you need additional files (for example, the source code, or dependency libraries), visit the release page.

Dependency Management

For development using the Liferay Platform, update Liferay Workspace to use the  lat est dependencies, by adding the following line to the build.gradle file:

dependencies {
	compileOnly group: "com.liferay.portal", name: "release.portal.api"
}

All portal dependencies are now defined with a single declaration. When Ausing an IDE such as Eclipse or IntelliJ all apis are immediately available in autocomplete for immediate use.  

By setting a product info key property it will be possible to update all dependencies to a new version by updating the liferay.workspace.product property in the liferay workspace projects gradle.properties file:

liferay.workspace.product = portal-7.4-ga125

When using an IDE such as Eclipse or IntelliJ all apis are immediately available in autocomplete for immediate use.

Features

Commerce

Defining Permissions Defaults

Feature Status: Release  

This enhancement introduces configurable default permissions for newly created pages. Admins can set these permissions at both the instance and site levels. Instance-level settings are managed in a new Instance Settings panel, while site-specific overrides can be configured in the Site Configuration area.

Documentation: Setting Default Permissions

Create Product Specifications with Picklists

​​​​​​​Feature Status: Release​​​​​​​ 

This feature introduces the ability to create and manage custom picklists for product specifications. Users can now define specific values for product attributes, improving data consistency and efficiency. The feature includes the option to create new picklists or add existing ones directly on the specification page.

Documentation: Using Specifications with Picklists

Notification Template for an order built on Objects

​​​​​​​Feature Status: Release​​​​​​​

A new out-of-the-box (OOTB) email notification template based on Objects. This template will be automatically sent to the order creator when an order status changes to 'pending'.

The notification includes:

  • Order number

  • Order date

  • Account name

  • Shipping address

  • Order item summary

  • Order total

We will move away from Commerce notifications and deprecate them and we will use Objects for the new ones


 

Documentation: ​​​​​​​

Objects Permissions Management via Roles Administration

​​​​​​​Feature Status: Release​​​​​​​

Roles Managers can now define permissions for Object entries directly within the Roles UI. A new “Objects” main menu item has been added to the Define Permissions tab, listing all Custom Objects, allowing easier granular permission assignment.

​​​​​​​

Documentation: Defining Role Permissions

UPS Shipping Method Client Extension

​​​​​​​Feature Status: GA

Enhance your checkout experience by offering customers accurate UPS shipping costs based on their order details. Easily integrate this feature into your online store with our client extension available for purchase on the Marketplace.

Documentation: Using the UPS Shipping Method

Adyen Payment Method Client Extension

​​​​​​​Feature Status: GA

Enhance Your Online Store with Adyen Payment Connector.
Liferay DXP now offers seamless integration with Adyen, a leading global payment platform. This powerful combination empowers businesses to accept a wide range of payment methods, reduce fraud, and optimize checkout processes. By simplifying payment management, Liferay DXP with Adyen helps you focus on growing your business.

Documentation: Adyen

Content Management

Display date for D&M

​​​​​​​Feature Status: Release​​​​​​​​​​​​​​

Users can now set a display date for the documents so they can scheduled them to be published in the future, just for one document or when uploading multiple documents.

Documentation:

Size and Dates filters on Content Dashboard

​​​​​​​Feature Status: GA

Users can now efficiently locate images or videos by specific size categories (small, medium, or large) using the new filter feature on the Content Dashboard. Additionally, they can easily filter content or documents based on a range of dates for various lifecycle events, including creation, display, expiration, modification, publication, or review. This enhancement streamlines content management and improves user accessibility to relevant documents.

Documentation: Content Dashboard Interface

Easily identify private documents & media

​​​​​​​Feature Status: GA

Users can readily spot documents & media that is not visible to Guest users through an icon, whether it's in list, card or table view or within the document editor. Additionally, this feature is accessible in the item selector, empowering users to discern which documents are not viewable by Guest users.


 

Documentation: Documents and Media Permissions Reference

Identify missing translations for web content fields

​​​​​​​Feature Status: Release​​​​​​​​​​​​​​

​​​​​​​Users can easily identify and filter fields that are already translated and those that still need translation within the content editor. Additionally, they can choose to mark a language as translated even if some fields are not yet translated. Users also have the option to reset a translation to its default values with ease. These features will streamline the translation process and enhance efficiency.

Documentation: Translating Web Content

Headless API’s for Document Shortcuts

​​​​​​​Feature Status: GA

Users can now create, update, delete, and retrieve information about document shortcuts in a programmatic way using headless API’s

​​​​​​​

Documentation: Document Shortcut API Basics

Site Management & Publications

Additional Workflow information when Reviewing Changes in Publications

​​​​​​​Feature Status: Release​​​​​​​​​​​​​​

​​​​​​​Since Publications provides a final end point for users to review changes, it would benefit content editors tremendously if they could also review their workflow changes.​​​​​​​


​​​​​​​Documentation: Using Workflow with Publications

Performance Improvements for Large Publications

​​​​​​​Feature Status: GA

There is an unacceptable decrease in performance observed within large Publications. With publications housing a large number of individual changes, the current system struggles to maintain acceptable performance levels, especially during conflict checking and publishing publications. These two phases leverage handwritten SQL queries to perform those tasks that allow Publications a shortcut through our persistence layer to maximize performance in small publications. In large publications though, further considerations must be taken to ensure consistent performance.

Improve consistency of Publications & Production data post-upgrade

​​​​​​​Feature Status: GA

Some upgrade processes may not consider the ctColectionId column which may generate inconsistencies for customers using Publications, especially for older versions.

Simplify the Process of Enabling Change Tracking for Headless APIs

​​​​​​​Feature Status: GA

Add changeTrackingEnabled to the standard rest-config.yaml so that services must specify Publications support. This will simplify the process of enabling change tracking for future Headless APIs.

Notify Data Migration Center users when they are scoped to publications

​​​​​​​Feature Status: GA

Data Migration Center users should be sufficiently notified if actions can only be made in Production since DMC doesn’t support Publications yet.

Page Management

Enable CRUD Nested Object Entries in The Page Builder Through 1:1 Relationships

​​​​​​​Feature Status: Release​​​​​​​​​​​​​​

​​​​​​​We introduced a new feature to streamline workflows with 1:1 relationships between objects! Now, the user can create and update nested objects directly from the primary object's CRUD views, and enjoy seamless delete and view operations translated from the Data Set Manager (DSM). This update makes managing data smoother and more efficient.

Documentation: Using Fragments to Build Forms

Mapping repeatable fields of Web Content

​​​​​​​Feature Status: Release​​​​​​​​​​​​

​​​​​​​Allow users to map Repeatable fields of a Web content Structure already defined in Fragments and Collection Displays.

Documentation: Mapping Repeatable Fields to Fragments

Platform Experience & Search

Search Headless APIs Enhancements

​​​​​​​Feature Status: Release​​​​​​​​​​​​​​

The /search and /suggestions APIs comes with the following enhancements:

  • New, optional scope parameter supporting Site (Group) IDs and External Reference Codes (ERCs) in /search. The scope parameter of /suggestions has also been updated to have the same semantics.

  • /search now is in RELEASEstatus.

  • The APIs now are available under the /o/search/v1.0/ endpoint with backward compatibility for current /o/portal-search-rest/v1.0 calls through server-side forward.

Refer to the documentation for more details: https://liferay.atlassian.net/browse/LPD-11232

Documentation: Search Headless APIs

Elasticsearch 8.15 Compatibility

​​​​​​​Feature Status: GA

Elasticsearch 8.15.x has been tested and added to the compatibility matrix to the corresponding Liferay versions.

Note: Compatibility with newer Elasticsearch minor versions is tested in two ways:

  1. Latest-Latest: Testing the latest Liferay version with the latest available minor version of Elasticsearch → e.g. Master/2024.Q3 + Elasticsearch 8.15

  2. Minimum-Latest: Testing the minimum Liferay version where Elasticsearch 8 compatibility was first made available with the latest minor version of Elasticsearch → DXP 7.4 U81/DXP 7.3 U31 + Elasticsearch 8.15

This way Liferay can allow a broader deployment base to operate their stack with an up-to-date search engine version.

As Elasticsearch is usually releases a new Minor version roughly every two months, this is a recurring process and a planed activity in each quarter.

Documentation: Elasticsearch

Elasticsearch 7.17 EOL in 2025 & Updates

​​​​​​​Feature Status: GA

Per Elastic’s product lifecycle, Elasticsearch 7.17.x versions are supported and maintained until Elasticsearch version 9 is released. While Elastic does not provide specific release dates for future releases, for Elasticsearch 9.0.0, the new release is anticipated in early calendar year 2025.

Therefore, Liferay strongly recommends all customers with 7.17.x deployments to begin the planning phase for an upgrade project to the latest compatible Elasticsearch 8.x version.

Compatibility with Elasticsearch 8 is available on 7.4 U81+. →

Note: The Elasticsearch 8.x compatibility is provided through the bundled Elasticsearch 7 connector and the REST API Compatibility of Elasticsearch 8.

Liferay ships with an updated Elasticsearch connector using 7.17.21 as the client version and also as version of Sidecar Elasticsearch server for development and testing purposes.

Documentation: https://liferay.dev/blogs/-/blogs/operating-liferay-7-4-ga-update-81-with-elasticsearch-8

Optimized Search Blueprints Size

​​​​​​​Feature Status: GA

Clause Contributors configuration is now stored within the blueprint’s JSON with a smaller footprint, reducing the size of a blueprint by more than 90% when using the default setting (all contributors enabled → Enable All) or the new Disable All option.

The behavior of the different options is as follows:

  • with Enable All, all current and future query clause contributors introduced to the platform will be enabled automatically. Disable All behaves the opposite way,

  • with Customize, the configuration is locked to the specified contributor list.

Documentation: Creating and Managing Search Blueprints

Frontend Infrastructure

Allow Data Set Manager to have different types of sources for the filter values

​​​​​​​Feature Status: Beta

​​​​​​​The selection filters of the Data Set Manager has been revamped to allow chosing different type of sources. On top of the picklist, now the admin user may select an API Headless as filter values source, so the filter values might be populated with the values coming from the API response. This allow users to have a more automated process on the filter creation.

Documentation:

Manage Array Fields in Dataset Views

​​​​​​​Feature Status: Beta

Data Set Manager lets from now to map Array structures, so a given cell of a Data Set can show list of values, for example to list the roles of a user or the tags of a product.

​​​​​​​Documentation: ​​​​​​​Data Set View Visualization Modes

Allow Frontend Data Set Continuous Navigation

​​​​​​​Feature Status: Beta

When the users are facing a Frontend Data Set the items can show actions to interact with them that are set in the Data Set Manager. From now own, when the user navigates to a destination URL through an item or creation action, the current URL is added to the destination page, so the user can return to the Data Set after performing the action seamlessly.

​​​​​​​
 

​​​​​​​

Documentation: Data Set View Actions

Allow DSM CX Filter to know associated "Filter By" value

​​​​​​​Feature Status: GA

The CX Filter allow developers to build their own filters, with on demand bussiness logic and UI, to be added to a Data Set in the Data Set Manager and then be used for end-users in the Data Set. With this new value, the Client Extension can be generic, and the same Client Extension can be used to build filters that filter by different fields.

Documentation:

Documentation

All documentation for Liferay Portal and Liferay Commerce can now be found on our documentation site: learn.liferay.com.  For more information on upgrading to Liferay Portal 7.4 GA125 see refer to the Upgrade Overview.

Compatibility Matrix

Liferay's general policy is to test Liferay Portal and Liferay Commerce  against newer major releases of operating systems, open source app servers, browsers, and open source databases (we regularly update the bundled upstream libraries to fix bugs or take advantage of new features in the open source we depend on). 

Liferay Portal 7.4 GA125 and Liferay Commerce 4.0 GA125 were tested extensively for use with the following Application/Database Servers: 

Application Server

  • Tomcat 9.0

  • Wildfly 18.0, 23.0, 26.1

Database

  • MySQL 5.7, 8.0

  • MariaDB 10.2, 10.4, 10.6

  • PostgreSQL 12.x, 13.x, 14.x, 15.x

JDK

  • IBM J9 JDK 8

  • Oracle JDK 8

  • Oracle JDK 11

  • All Java Technical Compatibility Kit (TCK) compliant builds of Java 11 and Java 8

Search Engine Compatibility Matrix

Source Code

Source is available as a zip archive on the release page, or on its home on GitHub.

Bug Reporting

If you believe you have encountered a bug in the new release you can report your issue by following the bug reporting instructions.

Getting Support

Support is provided by our awesome community. Please visit getting started for more details on how you can receive support.

Fixes and Known Issues

​​​​​​​