Note
Intershop PWA 12.0.0 was developed and tested with Intershop Commerce Management (ICM) version ICM 14.4.0.
It will work with all versions from ICM 14.4.0 and later.
Other ICM versions may also work with some limitations, which are listed in the "CHANGES THAT REQUIRE MORE RECENT ICM VERSIONS" sections.
PWA 12.0.0 with the feature toggle legacyEncoding enabled should work as well with ICM 11 and ICM 7.10.x (versions newer than 7.10.38.0 should work). The "CHANGES THAT REQUIRE MORE RECENT ICM VERSIONS" sections list functionalities that are only available with ICM releases of the noted version or newer.
The PWA was developed and tested using Node.js version 22.22.0 LTS (including npm 10.9.4), which is the recommended version.
Intershop recommends using the PWA Helm Chart version 0.13.0 for PWA 12.0.0 deployments.
Important
For production deployments, set ALLOWED_HOSTS to the public hostname(s) under which the PWA is served (e.g., ALLOWED_HOSTS=shop.example.com,*.example.com).
When unset, only localhost is accepted.
Restricting the allowed hosts ensures that only requests with a trusted Host header are rendered server-side.
Failing to configure the correct ALLOWED_HOSTS will result in the following error message:
URL with hostname "abc.xyz.com" is not allowed.
Features
- add CMS include at the top of the registration page (#2108) (4950363)
- add Contributor License Agreement (CLA) Assistant workflow (#2096) (0e95b64)
- improve new-entry input UX in order template and wishlist select modals (#2105) (2fd6728)
- select quote when adding a product to one of many quotes (#2105) (3883552)
- independent support for Design View and preview context (#2089) (95ec1ac)
- improve customization options for modal dialogs (1ace514)
- use
ng-selectfor product filter dropdown component (#2090) (9264590) - introduce
DeferredItemComponentfor lazy loading used with new Swiper integration (#2078) (86f0080) - Bootstrap: replace
ProductRatingStarComponentwithNgbRating(#2126) (cf69f64) - Bootstrap: refactor breadcrumb component to be closer to the Bootstrap breadcrumb (#2109) (b5537c6)
- SSR: set
ALLOWED_HOSTSfor production mode in Angular 19 SSR (#2094) (87f178b)
Bug Fixes
- display customer approval message after registration (#2132) (93d5acd)
- handling of environment switch
TESTINGto be evaluated correctly (111d01b) - validation display in address fields (b3c4b93)
- error message in quick order forms (4e49b2d)
- empty placeholder of ng-select form field (72a990e)
- support SSO authentication together with Captcha by using
X-Captcha-Tokenheader (#2122) (e9985e8) - fix SSO continue registration process (#483) (1dc1364)
- move order template item to a new order template (#1666, #2120) (c079274)
- ok button and link on move order template confirmation dialog (#2120) (94e5197)
- set focus to the 1st invalid element after form submit (99b3e63)
- fix link to newly created list (1c762a7)
- route product master variation filtering to ICM search service instead of SPARQUE (#2116) (484e78d)
- prevent false-positive
missing translationerrors in SSR (#2117) (c861699) - change captcha v3 token fetching mechanism (#2112) (7953c03)
- scrollable and fullscreen modal styling (#2115) (aee898e)
- improve ApiTokenService finishing of subscriptions (8c77f17)
- reset form directive on opening a dialog (#2113) (400c9ea)
- improve product review caching (#2102) (ce4e388)
- NGINX: bad array subscript error parsing wastatistics (#2118) (3a71025)
Documentation
- add Helm Chart deployment configuration examples for SSO identity provider (#2140) (d4f6280)
- add versioning policy documentation (#2134) (80ed077)
- improve PCI DSS documentation (#2106) (ca2c93d)
Dependencies
- update
ngx-translateto version 18 (#2094) (0d5cfbf) - update
ngx-translateto version 17 (#2094) (25196f3) - introduce Perfectionist ESLint rules to enforce sortings in code (#2094) (d5eb591)
- update Angular 19 dependencies (125d25b)
- migration to Swiper 12 (#2078) (f9b53c3)
- nginx: update OpenResty version to 1.31.1.1 (#2129) (c536b81)
Code Refactoring
BREAKING CHANGES
- SSR: The
ALLOWED_HOSTSenvironment variable must be set to the appropriate value for production mode when using SSR. This change may require updates to deployment configurations and environment variable settings to ensure that the application functions correctly in production environments. - Angular 19 upgrade including necessary migrations (see Migrations / From 11.2.0 to 12.0.0 for more details).
ngx-translate17 upgrade (see Migrations / From 11.2.0 to 12.0.0 for more details).ngx-translate18 upgrade (see Migrations / From 11.2.0 to 12.0.0 for more details).- Swiper has been upgraded to version 12 (see Migrations | From 11.1.0 to 12.0.0 for more details).
- Design View integration no longer works with
PreviewContextID=DESIGNVIEWand initializing the Design View was replaced by a query parameterDesignView(see Migrations / From 11.1.0 to 12.0.0 for more details). - Bootstrap: The
ProductRatingStarComponentwas removed. - The order template and wishlist handling was reworked based on the improved ICM 14.2.0
/wishlistsREST API that results in less REST calls.