This documentation is still in progress. We are working hard to update all our screenshots to the new Magnolia 6 style. Please bear with us.
Magnolia stores a data item in the Visitors app for every visitor who submits personal data and consents to their data being stored. A visitor can often withdraw their consent by, for example, clicking a link on webpage. Alternatively, consent can be edited manually using the Visitors app in Magnolia.
The Visitors app operates on the
visitors JCR workspace.
Note that data displayed in the Visitors app may have references to data stored in other workspaces too. You can see these dependencies using the Show dependencies action.
Visitors app adds also contacts
In the Magnolia EE Pro Travel Demo, the
contacts workspace is registered in the configuration of the Privacy module for demonstration purposes of dealing with personal data. This means the Visitors app interacts not only with the
visitors workspace but also with the
contacts workspace, which is otherwise primarily used by the Contacts app.
Data is stored on the public context - synchronization between public nodes may be required
The record of consent for form-based data in the
visitors workspace is created on the public Magnolia instance, never on the author instance. This is also true for referenced content, for instance in the
You must synchronize the consent records stored if you use several public instances. The instances, or in our sample implementation at least the
contacts workspaces, must be clustered in order to share accounts between the different instances. Alternatively, implement observation-based synchronization to replicate visitor and contact data across instances.
The Visitors app is defined using YAML in the Magnolia Maven module
magnolia-privacy-ui, which is part of the Privacy module.
If you want to change the app definition, you can decorate it, create a copy in the resources workspace with the Resource Files app or create a copy in a file-based light module using the Magnolia resources origins loading order.
Personal fields configuration
The personal fields section contains a list of fields for which a visitor must give consent.
Properties of a personal field:
The name of the node that defines a personal field.
The node name is arbitrary but it must be unique.
|The node |
The name of a field that is used for a specific purpose for which a user must give consent.
The field name must be identical to the one used in the form where the visitor provides the data.
If you want to make a form privacy-aware (and so require users to give consent for a given form field), you may have to add an additional property to the
fieldNames node. See Creating a GDPR compliant form and Making an existing form GDPR compliant.
Website visitor-related data is created on the public instances. You must use the Visitors app on the public instance.
Use the Visitors app to:
- Edit and delete existing data for a visitor.
- View and update dependencies with data items stored in other workspaces for a visitor.
You cannot add new items manually with this app.
The email address of a visitor is used as the Visitor ID, which makes it easy to find a particular visitor.
Click Show dependencies to show the data in other workspaces that exists for the selected visitor.
The example above shows that data also exists in the Contacts app for the visitor Jonathan Zweistein.
You can click referenced content items to open the related app. In the example, if you click the line starting with "contacts", Magnolia opens the Contacts app.
Click Delete item to delete existing data for a visitor including any referenced data.
If the item contains references to other data stored for the visitor, the Visitors app shows you the related content and asks you to confirm the deletion.
Click Yes, delete to confirm the deletion of the visitor item and all its related content.
Click Update consent to update a visitor's consent manually. This may be necessary in cases where, for example, consent is given over the phone.
In the Edit consent dialog you can add or remove a predefined set of fields for which a website visitor is asked to give or deny consent.
When you update a visitor's consent manually, you must provide a source. The source can be a website (where you run your Magnolia instance), an email address or a phone number.
The source must comply with a certain format:
http(s)://for website URLs.
mailto:for email addresses.
tel:for phone numbers.
If consent is updated or withdrawn for a given item, you must also update or withdraw it for any related items.
Click Update references to update referenced data.
The system informs you of what referenced data may be updated and asks you to confirm the action by clicking Proceed.
In this example, the visitor Jonathan Zweistein has withdrawn his consent for his name to be stored. The Update references action will remove his First name and Last name referenced in the Contacts app.
The referenced content items for a visitor are always shown, even if there is no update required.