Cavemanon/cavemanon-wagtail-personalisation
Archived
7
Fork 0
Code Issues Pull Requests Activity

Personalized content documentation

Browse Source
This commit is contained in:
Jasper Berghoef
2017-01-23 12:19:17 +01:00
committed by Boris Besemer
parent 154442a303
commit 824db4dc7c
2 changed files with 38 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/conf.py
View File

@ -47,7 +47,7 @@ master_doc = 'index'
# General information about the project.
project = 'wagtail-personalisation'
copyright = '2016, Lab Digital BV'
copyright = '2017, Lab Digital BV'
author = 'Lab Digital BV'
# The version info for the project you're documenting, acts as replacement for

43
docs/usage_guide.rst
View File

@ -2,7 +2,7 @@ Usage guide
===================================================
Creating a segment
---------------------------
------------------
As soon as the installation is completed and configured, the module will be visible in the Wagtail administrative area.
@ -13,14 +13,45 @@ On this page you will be presented with a form. Follow the steps to create a seg
1. Enter a name for your segment.
2. (Optional) Select wether to match any or all defined rules.
"Match any" will result in a segment that is applied as soon as one of your rules matches the visitor.
When "match all" is selected, all rules must match before the segment is applied.
``match any`` will result in a segment that is applied as soon as one of your rules matches the visitor.
When ``match all`` is selected, all rules must match before the segment is applied.
3. (Optional) Set the segment persistence.
When persistence is enabled, your segment will stick to the visitor once applied, even if the rules no longer match on the next visit.
When persistence is enabled, your segment will stick to the visitor once applied, even if the rules no longer match on the next visit.
4. Define your segment rules.
Wagxperience comes with a basic set of rules that allow you to get started quickly. The rules you define will be evaluated once a visitor makes a request to your application.
Wagxperience comes with a basic set of rules that allow you to get started quickly. The rules you define will be evaluated once a visitor makes a request to your application.
5. Save your segment.
Click "save" to store your segment. It will be enabled by default, unless otherwise defined.
Click "save" to store your segment. It will be enabled by default, unless otherwise defined.
Creating content for your segment
---------------------------------
Once you've created a segment you can start serving these visitors with personalised content. To do this, you can go one of two directions.
1. Create a copy of a page for your segment.
2. Create StreamField blocks only visible to your segment.
Method 1: Create a copy
^^^^^^^^^^^^^^^^^^^^^^^
To create a copy from a page for a specific Segment (which you can change to your liking after copying it) simply go to the Explorer section and find the page you'd wish to personalize.
You'll notice a new "Variants" dropdown button has appeared. Click the button and select the segment you'd like to create personalized content for.
Once you've selected the segment, a copy of the page will be created with a title that includes the segment. Don't worry, you'r visitors won't be able to see this title.
You can change everything on this page you'd like. Visitors that are included in your segment, will automatically see the new page you've created for them.
Method 2: Create a block
^^^^^^^^^^^^^^^^^^^^^^^^