Visitors app
Use the Visitors app to manually edit or delete consent given by website visitors.
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.
Configuration
Workspaces
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.
Privacy module writes into the contacts app
Visitors app adds also contacts
In the Magnolia DX Core 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.
GDPR data is stored on public and must be synchronized on clusters
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 contacts workspace.
You must synchronize the consent records stored if you use several public instances.
The instances, or in our sample implementation at least the visitors, pendingContacts and contacts workspaces, must be clustered to share accounts between the different instances.
Alternatively, implement observation-based synchronization to replicate visitor and contact data across instances.
App definition
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.
| Node name | Value |
|---|---|
📁 modules |
|
📁 magnolia-privacy-sample |
|
📁 config |
|
📁 personalFields |
|
⸬ name |
|
⸬ fieldNames |
|
⬩ firstName |
firstName |
⬩ lastName |
lastName |
| Property | Description | ||
|---|---|---|---|
|
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.
|
Usage
| 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. |
Showing dependencies
Click Show dependencies to show the data in other workspaces for the selected visitor.
You can click referenced content items to open the related app.
Deleting items
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.
Updating consent
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.
| Source | Example value |
|---|---|
Website |
http://www.example.org/travel/contact.html?mgnlFormToken=2b1084c4-fd7c-48c5-95ac-b6def1b5a840 |
mailto:hans.mueller@example.com |
|
Phone |
tel:+41-79-123-45-67 |
The source must comply with a certain format:
-
http(s)://for website URLs. -
mailto:for email addresses. -
tel:for phone numbers.
Updating references
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.
The referenced content items for a visitor are always shown, even if there is no update required.