Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: MOTION-157

...

This page of the tutorial shows you how to configure these fields for a cookie named visits. Please read Cookies trait configuration before you begin.

Table of Contents

Info

You can import the XML files provided in the Download configuration files section if you prefer not to configure manually.

Configuring the rule field

The rule field defines values for the trait when you choose an audience. The input entered into the rule field(s) is used to construct a voter. The voter decides if the visitor or visit matches the rule. When the rule is met, Magnolia delivers personalized content.

...

Adding the switchable field option  

Options in the switchable field display in the Choose audience dialog when the user selects Visits in the Cookie field.

...

The configuration should look like this:

...

heading0
multiplefalse
enableHeadingAttributesfalse
enableSortingfalse
classm5-configuration-tree
enableHighlightingfalse

Image Added

...

Mgnl n
cookies

...

Mgnl n
ruleField

...

Mgnl n
options

...

Mgnl n
visits

...

Mgnl p
label

...

Visits

...

Mgnl p
value

...

visits

...

Mgnl n
weatherLocality

...

Mgnl n
tourType

Adding the select field options

...

To add the visits options, in /modules/personalization-traits/traits/cookies/ruleField/fields :

  1. Add a   visits/options node structure.
  2. In the /options node: 
    1. Add one content node for each option. Our options are one, two, three, four and any. These are the internal names of the options.
    2. Add two properties to each option node:
      1. label<Option label>: The label displayed in the field. 
      2. value<Option value>: The option value stored in the repository.
  3. Optionally, add a sortOptions property to /visits node and set the value to false. This ensures that the options render in configuration order and not alphabetically.

The configuration should look like this:

...

heading0
multiplefalse
enableHeadingAttributesfalse
enableSortingfalse
classm5-configuration-tree
enableHighlightingfalse

...

Mgnl n
cookies

...

Mgnl n
ruleField

...

Mgnl n
options

...

Mgnl n
fields

...

Mgnl n
visits

...

Mgnl n
options

...

Mgnl n
one

...

Mgnl p
label

...

Mgnl p
value

...

Mgnl n
two

...

Mgnl p
label

...

Mgnl p
value

...

Mgnl n
three

...

Mgnl p
label

...

Mgnl p
value

...

Mgnl n
four

...

Mgnl p
label

...

Mgnl p
value

...

Image Added

...

Mgnl n
any

...

Mgnl p
label

...

Mgnl p
value

...

Mgnl p
class

...

info.magnolia.ui.form.field.definition.SelectFieldDefinition

...

Mgnl p
defaultValue

...

any

...

Mgnl p
sortOptions

...

false

...

Mgnl n
tourType

...

Mgnl n
weatherLocality

...

Mgnl p
class

...

info.magnolia.ui.form.field.definition.SwitchableFieldDefinition

...

Mgnl p
transformerClass

...

info.magnolia.personalization.cookie.CookieFieldTransformer

Configuring the value field

The value field defines the options that display in the Preview app. The field is used to preview variants when testing personalized content delivery.

...

The value field is an Option group field.  The The option values should match the option configurations in the rule field

...

The configuration should look like this:

...

heading0
multiplefalse
enableHeadingAttributesfalse
enableSortingfalse
classm5-configuration-tree
enableHighlightingfalse

...

Mgnl n
cookie

...

Mgnl n
ruleField

...

Mgnl n
valueField

...

Mgnl n
options

...

Mgnl n
visitsOne

...

Mgnl p
label

...

Visits: One

...

Mgnl p
value

...

visits=1

...

Mgnl n
visitsTwo

...

Mgnl p
label

...

Visits: Two

...

Mgnl p
value

...

visits=2

...

Mgnl n
visitsThree

...

Mgnl p
label

...

Visits: Three

...

Mgnl p
value

...

visits=3

...

Mgnl n
visitsFour

...

Mgnl p
label

...

Visits: Four

...

Mgnl p
value

...

visits=4

...

Mgnl n
visitsAny

...

Mgnl p
label

...

Visits: Any

...

Mgnl p
value

...

visits=any

...

Mgnl n
tourTypeAny

...

Mgnl n
...

...

Mgnl p
class

...

info.magnolia.ui.form.field.definition.OptionGroupFieldDefinition

...

Mgnl p
multiselect

...

true

...

Mgnl p
sortOptions

...

Image Added

Download configuration files

...