Page Rating Dynamic Content Module

Based on CMS 6

Back in January Paul Smith blogged about a pretty cool Page Rating Dynamic Content widget he built using Page Objects. I found this to be pretty useful for demonstrating the concept of basic rating in EPiServer CMS. After all, some things are better to show than to say “sure you could add that, it’s easy”. The code you will find in that blog was based on RC1 and the actual release had a few breaking changes which needed to be fixed for this to work. As a result I’ve hijacked Paul’s code, updated it, and uploaded it here. I also used a different star image for the rating system that I felt worked better within the Alloy Technologies templates. Paul’s looked a little too Captain America(ish) for my taste but I know it’s because he loves Americans and American English! Winking smile Of course, you can swap this out with any image you choose by placing your preferred image in the Images folder with the correct name. Note, with my update all page versions and languages of the page will share the rating. If you prefer a different approach this is changeable in the RatingControl.ascx.cs code by modifying the third parameter to pom.Save().

The configurable Dynamic Content widget looks as follows:

And the resulting page:

I have included a Visual Studio project which will auto-magically copy the necessary files to the expected locations *if* you place the core “Rating” folder in the code download in the root directory of your EPiServer site, add it to your main solution, and Build the project. Additionally you will need to add the line highlighted in yellow below to the <dynamicContent> section of episerver.config:

<dynamicContent>
  <controls>
    …
    <add description="Displays a Rating facility" name="Rating" 
	type="EPiServer.Samples.RatingDC, Rating" />

    …
  </controls>
</dynamicContent>

Enjoy!

Feb 16, 2011

Comments

Anders Hattestad Feb 16, 2011 11:55 PM

Like the icons, but you can rate any number of times.. Thats a small drawback :(

Jeff Wallace Feb 21, 2011 08:58 PM

Hi Anders. Thanks for the feedback. You are correct, anyone can rate the item any number of times. Many customers will want a single rating tied to a user and require that the user be logged in before enabling the rating feature. The idea here is just an example of how easy it is to add something like this in EPiServer. This should be solid for *basic* demos and also a good starting point for someone who wants to expand the capability with functionality such as that listed previously, configurable items such as star rating vs. thumbs up/down, etc. Maybe this will come in a future blog post? :)

Anyway, thanks again for the feedback.

Please login to comment.