Personalization module

Personalization Bundled: DX Core

Edition DX Core

License

MLA

This module includes GeoLite2 data created by MaxMind, available from www.maxmind.com.

Issues

MGNLPN

Maven site

Personalization

Latest

3.0.1

Available on SPA/Headless

Yes
Updating

Updating to Personalization 2.1.x is only possible from the 2.0.x module versions. To update from the Magnolia 5 UI Personalization module (1.6.x versions), you need to update to Personalization 2.0 first.

Bundling

Magnolia 6.2 webapps are shipped with the Personalization 2.0.x module versions.

Personalization and Delivery API

Personalization support for the Delivery API is only available in Personalization 2.1.0 or higher.

Personalization

Personalization refers to adapting content to a particular user according to his or her personal preferences, needs and capabilities. In order to do so, you first select a set of traits of a visitor or a visit, then compose rules using these traits to define what content is presented to which visitors and when.

Modules

Magnolia’s Personalization feature consists of the following modules.

  • Blossom-compatibility: Provides personalization of Blossom components.

  • Compatibility: Provides the 5 UI framework modules.

  • Components: Support for creating component variants.

  • Core: Personalization core.

  • Integration: Personalization support for creating page variants and fields for selecting traits and audiences.

    Since version 2.0, this submodule has been deprecated and its functions relocated to the Compatibility submodule.

  • Pages: Personalization integration for the Pages app.

  • Personas app: App for creating hypothetical visitors who represent your target audience.

  • Preview app: App for testing content delivery by impersonating a visitor.

  • REST: Personalization support for the Delivery API.

  • Segmentation app: Provides the Segments ppp for grouping visitors into segments.

  • Traits: Example traits country, date, cookie and visitor.

  • Widgetset: Widgetset for client-side extensions needed for the variant-selectors.

<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-compatibility</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-components</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-core</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-integration</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-pages</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-personas-app</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-preview-app</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-rest</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-segmentation-app</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-traits</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>. 
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-widget</artifactId>
  <version>3.0.1</version> (1)
</dependency>
1 Should you need to specify the module version, do it using <version>.

Part of the module is also the magnolia-personalization-blossom-compatibility.

To be able to use personalization in the Delivery API, you should:

  1. Add the Blossom dependency (magnolia-personalization-blossom-compatibility) only if you are using the Blossom modules in your project:

    <dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-blossom-compatibility</artifactId>
  <version>3.0.1</version> (1)
</dependency>
    1 Should you need to specify the module version, do it using <version>.

  2. Make sure that in the content of your pom.xml for your webapp you include the following two dependencies if your project is generated from the Magnolia webapp archetype:

    ...
  <dependencies>
   ...

   <!-- include p13n for rest -->
    <dependency>
        <groupId>info.magnolia.personalization</groupId>
        <artifactId>magnolia-personalization-rest</artifactId>
        <version>2.1.1</version>
    </dependency>

  </dependencies>
...

    If you use personalization version 2.1.0, you also need to add the following dependencyManagement into your webapp’s pom.xml file.

    ...
<dependencyManagement>
    <dependencies>
    <!-- include dependency management for p13n 2.1.0 -->
        <dependency>
            <groupId>info.magnolia.personalization</groupId>
            <artifactId>magnolia-personalization-parent</artifactId>
            <version>2.1.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
...

Configuration

See an overview of differences between FreeMarker and headless templating.

Components submodule

Nested variants occur when a page variant contains component variants. Control the ability for editors to create nested variants using the allowNestedVariants property on the module level configuration.

Node name Value

personalization-components

     config

         allowNestedVariants

false
Property Description

allowNestedVariants

optional, default is false

Allows you to create component variants inside a page variant if set to true.

Traits submodule

Provides out-of-the-box functionality for the following trait types:

  • All name-and-value based traits.

  • Cookie trait.

  • Header trait.

  • Request parameter trait.

Compatibility submodule

The magnolia-personalization-compatibility submodule provides the following pre-configured trait types, inherited from the older (pre-2.1) versions of the Personalization module:

  • Date

  • Country

  • Visitor

  • Cookies

Custom traits

Each trait has a configuration which can be adjusted. For configuration details, see the Registering a trait section on Creating custom traits page.

Issues

Missing CountryVoter

You may encounter the following issue:

2024-09-18 15:30:30,533 WARN  agnolia.transformer.ClassPropertyBasedTypeResolver: Encountered the 'class' property but failed to resolved the type from its value: [info.magnolia.personalization.geoip.CountryVoter]
java.lang.ClassNotFoundException: info.magnolia.personalization.geoip.CountryVoter

Solution

  1. Add the following dependency to your webapp:

      <dependency>
        <groupId>info.magnolia.personalization</groupId>
        <artifactId>magnolia-personalization-compatibility</artifactId>
        <version>${personalization.version}</version>
  </dependency>

  2. If needed, copy the related configuration from /modules/personalization-traits.

Related topics
Feedback

DX Core

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules