You can use personalization in Magnolia without writing any Java code by using traits for just about any kind of personalization feature.
Below, we focus on configuring cookie traits.
Cookie traits
The cookie trait supports multiple cookies.
You can configure as many cookies as you like for multiple use cases and use them simultaneously.
Cookies are supported also in headless scenarios.
Two Magnolia cookie trait implementations
Version 2.1.0 of the Personalization module provides two implementations of cookie traits.
New cookie trait implementation
In the new implementation, the Cookie trait leverages a generalized NameAndValueTraitDetectorFilter that is also used to retrieve traits from the request header (collectHeaders) and request parameters (collectRequestParameters).
The NameAndValueVoter is then used to render the appropriate content variation according to configuration.
In addition, this implementation comes with the @TraitType annotation for easier configuration:
<light-module>/traits/color.yaml
$type:cookieTrait# name: is omitted as it is taken from the name of the yaml fileCopy
The new implementation is part of the magnolia-personalization-traits submodule.
Deprecated cookie trait implementation
The deprecated approach is part of the magnolia-personalization-compatibility submodule and was originally introduced in version 1.1.2 of the Personalization module.
The Cookies trait (info.magnolia.personalization.cookie.Cookies) uses a specialized CookiesDetectorFilter that can read cookies from the HTTP request with httpServletRequest.getCookies(), but cannot collect the traits from the request header or request parameters.
The CookieVoter is then used to render the appropriate content variation according to configuration.
There is no need to write further Java classes.
All you need to do to create a custom cookie is to is adapt the cookie trait configuration and write some FreeMarker and JavaScript code.
You can include your code in a light module.
Cookie traits in Magnolia demo
The DX Core Demo bundle has two example cookie traits:
tourType, used in the Travel Demo to set user’s tour type preference.