Guidelines
23-May-2026 • 4Q8274 • Table Of Contents NgRx Pitfalls Using Services and catchError Using switchMap can Lead to Race Conditions Should I put XYZ into the Store or the Component? Testing NgRx Artifacts Using the State Management in Tests Reducers and Actions Selectors Effects NgRx Pitfalls Using Services and catchError The
Guidelines
23-May-2026 • 4827M2 • Table Of Contents Setup Workflow Further References We integrated Address Doctor to verify address data for correctness. The current integration is based on the Address Doctor API 6.0.0. Setup First, activate the feature toggle addressDoctor . You will also have to provide the endpoint and additional
Concepts
23-May-2026 • 48P273 • Table Of Contents Rewriting Concept Rewriting Artifacts matchXRoute XRoutePipe ofXRoute (optional) Further References The PWA allows to supply localized and SEO optimized URLs for categories and product detail pages. Rewriting Concept This feature is mainly built on top of Angular's UrlMatcher for parsing
Concepts
23-May-2026 • 4827B1 • Table Of Contents Usage Examples Localization of Simple Text Localization with Parameters Localization with Pluralization Localization with Formatted Dates Localization of Text with HTML Tags Localization in the component(.ts) File Localization of Text with HTML-Anchors (Links) & OnClickHandlers (Callback-Functions)
Guidelines
23-May-2026 • D48270 • Table Of Contents Configure Cookie Consent Options Control Cookie Consent Banner Display Cookie Consent Settings Enable PWA Functionality Dependent on Cookie Consent Settings Displaying the Cookie Consent Options PWA Required Cookies Disabling the Integrated Cookie Consent Handling The Intershop PWA
Guidelines
23-May-2026 • 48K269 • Table Of Contents Building Configuration HTTPS or SSL Basic Auth Multi-Site Ignore Parameters During Caching Access ICM Sitemap Override Identity Providers by Path Add Additional Headers Content Security Policy Other Features Cache Cache Clearing Shared Redis Cache Cache Timing Clearing the Redis Cache
Guidelines
23-May-2026 • X48268 • Table Of Contents Customer Projects PWA Development Recommendations for the Process of Updating 0. Before the Update 1. Updating Angular Dependencies 2. Updating Third-Party Project Dependencies 3. Update Project Utilities for Testing, Reporting and Linting 4. Cleanup Dependencies 5. Update Utilities
Guidelines
23-May-2026 • 482N67 • Table Of Contents Building Building Multiple Themes Running Development Local ICM Cache Heap Dumps Creation Analysis Further References Building To simply build the Intershop PWA in server-side rendering mode, you can use the package.json script npm run build , which builds the Intershop PWA with the
Concepts
23-May-2026 • 4826R6 • Table Of Contents Different Levels of Testing Unit Module Integration End-to-End Test File Locations Deviation from Standard Angular Test Frameworks PageObject Pattern Handling Test Data Further Help Different Levels of Testing Testing the PWA follows the basic principle of the test pyramid (https://martinfowler
Guidelines
23-May-2026 • 4826U5 • Table Of Contents Understanding PCI DSS 4.0 Applicability Secure Angular PWA Code & Dependencies Prevent Cross-Site Scripting (XSS) Attacks Secure API Calls & Prevent CORS Attacks Use Secure HTTP Headers to Prevent Browser Attacks Enforce Secure Authentication & Session Management Secure Server-Side
Guidelines
23-May-2026 • 4H8263 • Table Of Contents Overview Formly-Form Component FormlyFieldConfig Customizing Form Logic Custom Field Types Custom Wrappers Custom Extensions Validation Extras Formly Config Service Testing Formly Testing Custom Types Testing Wrappers Configuring Formly Intershop's Custom Formly Parts Field Types Wrappers
Guidelines
23-May-2026 • 4826N4 • Table Of Contents Configuration Additional chatflowConfig Variables Customize Chatbot Override Chatbot Styling handleToolCall Actions The Intershop PWA provides an integration with Intershop Copilot for Buyers. Official Intershop Documentation: Overview - Intershop Copilot for Buyers The Intershop Copilot
Guidelines
23-May-2026 • 482D62 • Table Of Contents Overview Prerequisites Version Dependency for PayPal Architecture Key Building Blocks Adapter Types Buttons Messages CardFields GooglePay Google Pay Payment Flow Google Pay Production Checklist ApplePay Apple Pay Payment Flow Domain Verification Page Types Styling Customization Pay
Guidelines
23-May-2026 • 482P61 • Table Of Contents Configuring ESLint Custom ESLint Rules Further Reading The PWA uses ESLint for static code analysis and to enforce best practices. In order to use ESLint with Angular, we use the typescript-eslint and angular-eslint packages extensively. The PWA's ruleset is configured in eslint.config
Guidelines
23-May-2026 • 48260G • Table Of Contents Multiple Themes Developing the PWA with Several Themes Configurable Theme ICM Requirements Configuration Parameters Configuration JSON Developing with the Configurable Theme Multiple Themes It is possible to create multiple themes for the PWA, and the Intershop Progressive Web App currently
Guidelines
23-May-2026 • 4825Y9 • Table Of Contents JSDoc Tags Document Only When Needed! The JSDoc comment format is used for general information. Examples for the comment styling pattern can be found here: TypeDoc - DocComments. Use this format to describe components, modules, etc., but also methods, inputs, variables and so on. Example
Guidelines
23-May-2026 • 482M58 • To enable user tracking and setting it up with Google Tag Manager, the popular library Angulartics2 is used. Note The standard Intershop PWA Google Tag Manager integration is very basic and currently only supports the tracking of route changes. Please refer to the angulartics2 documentation for information
Guidelines
23-May-2026 • 48R257 • Table Of Contents Login Registration Token Lifetime Logout This document describes the main authentication mechanism if the ICM server is used as identity provider. If you need an introduction to this topic, read the Authentication Concept first. Login If the user wants to login by clicking a login link
Concepts
23-May-2026 • 482H56 • Table Of Contents Introduction Angular CMS Components Navigation Components Account Content Pages View Contexts View Context Requests with Resource Set ID Design View Integration with an External CMS Introduction The Intershop REST API contains resources reflecting the aspects of Intershop's integrated
Concepts
23-May-2026 • 48255E • Table Of Contents Introduction Library angular-oauth2-oidc Implementation and Configuration of Identity Providers PWA Initialization Login, Registration, Token Refreshment, Logout Vanishing of the apiToken Cookie Further References Introduction Several ICM REST operations require an authenticated user