Virtual Happy Hour this month, Jun 28, we'll be getting a sneak preview at our soon to launch SaaS CMS!

Try our conversational search powered by Generative AI!

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
Remove a segment from the URL in CMS 12

Problem : I have created thousands of pages dynamically using schedule jobs with different templates (e.g. one column, two columns, etc..) and stor...

Sanjay Kumar | Jun 21, 2024

Copying property values part 2

After publishing my last article about copying property values to other language versions, I received constructive feedback on how could I change t...

Grzegorz Wiecheć | Jun 18, 2024 | Syndicated blog

Enhancing online shopping through Optimizely's personalized product recommendations

In this blog, I have summarized my experience of using and learning product recommendation feature of Optimizely Personalization Artificial...

Hetaxi | Jun 18, 2024

New Series: Building a .NET Core headless site on Optimizely Graph and SaaS CMS

Welcome to this new multi-post series where you can follow along as I indulge in yet another crazy experiment: Can we make our beloved Alloy site r...

Allan Thraen | Jun 14, 2024 | Syndicated blog

Inspect In Index is finally back

EPiCode.InspectInIndex was released 9 years ago . The Search and Navigation addon is now finally upgraded to support Optimizely CMS 12....

Haakon Peder Haugsten | Jun 14, 2024

Change the IP HTTP Header used for geo-lookup in Application Insights


Johan Kronberg | Jun 10, 2024 | Syndicated blog