Andreas Ylivainio
Apr 8, 2011
(0 votes)

Personalization outside of the box (...or HTML-editor)

Coinciding with the release of EPiServer 6 R2 the creative minds at Circuit came up with the idea that a client of ours should have the ability to time control the display of slideshow-like content on their start page, ensuring the slideshow content targeted the appropriate target audience during different times of the day.

Since I knew the personalization in R2 was just around the corner I suggested we use that feature instead of just restricting the editors to selecting a time of day.

Thinking of the editors experience with having to paste HTML and CSS (and JavaScript for older browsers) to make the slideshow work within the editor, we quickly realized we needed to create a method for the editor to pick a Visitor Group and that we as developers of the start page template would render the correct html.

There is however no built-in method to select an arbitrary Visitor Group or to evaluate a Visitor Group match outside of the HTML-editor.

Enter Circuit.PropertyTypes.PropertyVisitorGroup! This custom property renders a dropdown-list of all defined Visitor Groups (using the Dynamic Data Store API) and saves the selected group in a property on the page.

I then hacked together a class named VisitorGroupsHandler used for activating the criterias in the selected Visitor Group and evaluating them. The class has three methods:

MatchAllCriteriasInGroup(VisitorGroup …)
MatchAnyCriteriasInGroup(VisitorGroup …)


IsMatch(VisitorGroup …) 

which uses both the preceding methods. The functionality does not yet handle points matching.

Here is an example of the MatchAllCriteriasInGroup method, minus argument validation:

public static bool MatchAllCriteriasInGroup(VisitorGroup visitorGroup)
            var httpContextBase = new HttpContextWrapper(HttpContext.Current);
            foreach (var criteria in visitorGroup.Criteria)
                var type = Type.GetType(criteria.TypeName, true);
                if (typeof(ICriterion).IsAssignableFrom(type))
                    var criterion = (ICriterion)Activator.CreateInstance(type);
                    if (!criterion.IsMatch(httpContextBase.User, httpContextBase))
                        return false;
            return true;
The end result is that the template code can decide what content to display based on the call to:
bool isBusinessVisitor = VisitorGroupsHandler.IsMatch(CurrentPage.BusinessVisitorGroup);
// Set active slide based on the isBusinessVisitor value

or when not using Page Type Builder:

bool isBusinessVisitor = VisitorGroupsHandler.IsMatch((PropertyVisitorGroup)CurrentPage["BusinessVisitorGroup"]).
// Set active slide based on the isBusinessVisitor value

The source code is downloadable here.

One thing I haven't solved is how to activate the Visitor Group interface when in edit mode to be able to preview the page with the different Visitor Groups used in the property. I will update the post when that is solved.

Feedback is very welcome!

Apr 08, 2011

Comments Apr 8, 2011 05:06 PM

There is an API for checking if the current request matches against a visitor group role.

Add the EPiServer.Personalization.VisitorGroups namespace to your code file then you will get an new overload to the EPiServer.Security.PrincipalInfo.CurrentPrincipal.IsInRole method which takes an enum specifying what type of role to query. One of the enum values is for Visitor Groups.

Apr 8, 2011 05:54 PM

Thank you Paul! That also takes care of the impersonation issues. I also found that implementing the interface IPersonalizedRoles for my property made the Visitor Groups GUI appear.

My public IEnumerable GetRoles() just returns the selected Visitor Group guid.

Please login to comment.
Latest blogs
Configured Commerce - Introduction to Long-Term Support (LTS) Releases

First off, for those who have not had a chance to meet me yet, my name is John McCarroll, and I am the Technical Product Manager for the Optimizely...

John McCarroll | Sep 29, 2023

Auto-translate with OpenAI in Optimizely CMS

You can now auto-translate content using your favorite online AI service, inside the old trustworthy Episerver.Labs.LanguageManager!

Tomas Hensrud Gulla | Sep 29, 2023 | Syndicated blog

Vulnerability in CMS 12 shell module configuration

Introduction A potential security vulnerability has been identified in Optimizely CMS 12, triggered by a certain shell module configuration. To be...

Magnus Rahl | Sep 28, 2023

AI-Assistant: The 'Change Tone' Shortcut

The AI-Assistant for Optimizely is constantly evolving, adjusting, and transforming to meet your digital needs, providing a cutting-edge advantage...

Luc Gosso (MVP) | Sep 27, 2023 | Syndicated blog

How to fix scheduled job 'Remove Abandoned BLOBs' if it keeps failing

Optimizely inlcudes a job named 'Remove Abandoned BLOBs'. This post will help you fix it if it's no longer working.

Henning Sjørbotten | Sep 26, 2023 | Syndicated blog

Optimizely Web Experimentation Metrics

Within the domain of Optimizely Web Experimentation Metrics, the emphasis is on objective key performance indicators (KPIs) selected to assess an...

Matthew Dunn | Sep 23, 2023 | Syndicated blog