The 5.7 branch of Magnolia reached End-of-Life on December 31, 2023, as specified in our End-of-life policy. This means the 5.7 branch is no longer maintained or supported. Please upgrade to the latest Magnolia release. By upgrading, you will get the latest release of Magnolia featuring significant improvements to the author and developer experience. For a successful upgrade, please consult our Magnolia 6.2 documentation. If you need help, please contact info@magnolia-cms.com.

EditionEE Std (page) / EE Pro (component), Cloud
License
MLA
IssuesMGNLPN
Maven sitepersonalization
Latest version

Related topics:


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 consist of the following modules.

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

  • Components: Support for creating component variants.

  • Traits: Example traits country, date, cookie and visitor.
  • Preview app: App for testing content delivery by impersonating a visitor.
  • Segmentation app: App for grouping visitors into segments.
  • Personas app: App for creating hypothetical visitors who represent your target audience.
  • Samples: Example personas and segments.

Installing

Maven is the easiest way to install the module. Add the following to your bundle. The parent POM of your webapp project should set the latest version of the module automatically. Should you need to use a specific module version, you can define it using the <version/> in the dependency.

<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-integration</artifactId>
</dependency>
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-components</artifactId>
</dependency>
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-traits</artifactId>
</dependency>
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-preview-app</artifactId>
</dependency>
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-segmentation-app</artifactId>
</dependency>
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-personas-app</artifactId>
</dependency>
<dependency>
  <groupId>info.magnolia.personalization</groupId>
  <artifactId>magnolia-personalization-samples</artifactId>
</dependency>

Configuration

personalization-components submodule

Node nameValue

 
personalization-components


 
config


 
allowNestedVariants

 false
PropertyDescription

allowNestedVariants

optional, default is false 

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

Usage

3 Comments

  1. Jeremy Price

    The release notes for Magnolia 5.7.x reference 1.6.x versions of the personalisation module.
    This page suggests that 1.7 is the correct version of the personalisation module for Magnolia 5.7 ( and 6.0 )
    Could you clarify which is correct?

  2. Steven Nash

    When trying to run version 1.8 with Magnolia 5.7 the following error occurs

        Module Magnolia Personalization Samples (version 1.8.0) is dependent on core (version 6.1/*), but Magnolia Core Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Preview App (version 1.8.0) is dependent on core (version 6.1/*), but Magnolia Core Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Preview App (version 1.8.0) is dependent on templating (version 6.1/*), but Magnolia Templating Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Preview App (version 1.8.0) is dependent on ui-framework (version 6.1/*), but Magnolia UI Framework (version 5.7.5) is currently installed.
        Module Magnolia Personalization Segmentation App (version 1.8.0) is dependent on core (version 6.1/*), but Magnolia Core Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Segmentation App (version 1.8.0) is dependent on ui-framework (version 6.1/*), but Magnolia UI Framework (version 5.7.5) is currently installed.
        Module Magnolia UI JCR integration (version 6.1.0) is dependent on core (version 6.0-SNAPSHOT/*), but Magnolia Core Module (version 5.7.5) is currently installed.
        Module Magnolia UI JCR integration (version 6.1.0) is dependent on ui-framework (version 6.0-SNAPSHOT/*), but Magnolia UI Framework (version 5.7.5) is currently installed.
        Module Magnolia Media Editor (version 6.1.0) is dependent on config (version 6.1/*), but Magnolia Configuration Framework (version 5.7.5) is currently installed.
        Module Magnolia Media Editor (version 6.1.0) is dependent on ui-framework (version 6.1/*), but Magnolia UI Framework (version 5.7.5) is currently installed.
        Module Magnolia Personalization Traits (version 1.8.0) is dependent on core (version 6.1/*), but Magnolia Core Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Traits (version 1.8.0) is dependent on ui-admincentral (version 6.1/*), but Magnolia Admincentral (version 5.7.5) is currently installed.
        Module Magnolia Personalization Personas App (version 1.8.0) is dependent on core (version 6.1/*), but Magnolia Core Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Personas App (version 1.8.0) is dependent on ui-framework (version 6.1/*), but Magnolia UI Framework (version 5.7.5) is currently installed.
        Module Magnolia Personalization Integration (version 1.8.0) is dependent on core (version 6.1/*), but Magnolia Core Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Integration (version 1.8.0) is dependent on templating (version 6.1/*), but Magnolia Templating Module (version 5.7.5) is currently installed.
        Module Magnolia Personalization Integration (version 1.8.0) is dependent on enterprise (version 6.1/*), but Enterprise Edition (version 5.7.5) is currently installed.

    What is the latest version of the Personalization module that is compatible with 5.7.x?

  3. Martin Drápela

    Hi there,

    yea sorry for the confusion, only the top right corner box on this page was correct re module version. Should be now fixed even in the Installing section.

    Cheers,

    Martin