Dec 20, 2010
(1 votes)

Dynamic Content Just Got Easier

EPiServer CMS 6 R2 includes some improvements to Dynamic Content (DC from now on) both for developers and editors.

Simplified Implementation

In previous versions of DC, you had to create a class that implemented the EPiServer.DynamicContent.IDynamicContent interface. You then needed to render the DC in some way. This could be done directly from the IDynamicContent.Render method or by returning a instance of a System.Web.UI.Control.

One of the developer improvements in CMS 6 R2 is to be able to take a web control and use it directly as the DC implementation. No need to worry about the IDynamicContent implementation any more!

The “fairy dust” that makes this possible is a new attribute called EPiServer.DynamicContent.DynamicContentPlugInAttribute. You decorate your DC web control with this and the framework will do the rest for you.

The attribute class has the following properties that can be set in your code:

public string ViewUrl

This should contain the Url of the control that implements the Dynamic Content (i.e. the control the attribute has been applied to).

As the DynamicContentPlugInAttribute derives from the existing EPiServer.PlugIn.GuiPlugInAttribute, the following properties are also available:

public string DisplayName
public string Description
public string Url
public string UrlFromUi
public string UrlFromUtil

One of the Url, UrlFromUi or UrlFromUtil properties may be set if you want to provide your own edit control for editors to create and update instances of your Dynamic Content. If none of these are set then the default EPiServer.UI.Edit.DynamicContentSettings control will be used.

The default edit control will provide a user interface for all properties on your DC control that meet the following criteria:

  • Have a public getter and setter
  • Is of type System.String, System.Boolean, System.Int32, EPiServer.Core.PageReference or derived from EPiServer.Core.PropertyData
  • Is an instance member
  • Is not inherited from a base class

Note that these editable properties will also be automatically serialized / de-serialized as the state of your DC instance. Since a DC is stored inline in a XHTML string, the state is encoded as a Base64 string which can make the state rather large. Keep this in mind and try to use as little state as possible for you DC.

The following example shows a version of Rating Dynamic Content Control first blogged about here.

   1:  [EPiServer.DynamicContent.DynamicContentPlugIn
   2:      (
   3:          DisplayName="Rating",
   4:          Description="Provides a rating facility for pages",
   5:          ViewUrl="/Templates/Public/Units/Placeable/RatingControl.ascx"
   6:      )]            
   7:      public partial class RatingControl : UserControlBase
   8:      {
   9:          private Rating _currentRating;
  10:          private const string PageObjectName = "Rating";
  12:          /// <summary>
  13:          /// The text to display before the rating icons
  14:          /// </summary>
  15:          public string InstructionText
  16:          {
  17:              get;
  18:              set;
  19:          }
  21:          /// <summary>
  22:          /// The text to display after the rating icons. 
  23:          /// If the string includes a format placeholder the average value will be inserted there
  24:          /// </summary>
  25:          public string PostRateText
  26:          {
  27:              get;
  28:              set;
  29:          }
  31:          protected void Page_PreRender(object sender, EventArgs e)
  32:          {
  33:              // Display the average rating
  34:              if (_currentRating == null)
  35:              {
  36:                  PageObjectManager pom = new PageObjectManager(this.PageBase.CurrentPage);
  37:                  _currentRating = pom.Load<Rating>(PageObjectName);
  38:              }
  40:              if (_currentRating != null)
  41:              {
  42:                  this.AverageRatingLabel.Text = string.Format(PostRateText, _currentRating.Average.ToString());
  43:              }
  44:              else
  45:              {
  46:                  // Not rated yet
  47:                  this.AverageRatingLabel.Text = string.Format(PostRateText, "0");
  48:              }
  49:          }
  51:          protected void StarImage_Command(object sender, CommandEventArgs e)
  52:          {
  53:              // The command argument is the rating value
  54:              int value = int.Parse(e.CommandArgument.ToString());
  56:              PageObjectManager pom = new PageObjectManager(this.PageBase.CurrentPage);
  58:              // See if we already have a rating object for this page
  59:              _currentRating = pom.Load<Rating>(PageObjectName);
  61:              if (_currentRating == null)
  62:              {
  63:                  _currentRating = new Rating();
  64:              }
  66:              _currentRating.Rate(value);
  68:              // And save
  69:              pom.Save(PageObjectName, _currentRating);
  70:          }       
  71:      }

No more web.config registration

Another nice feature in CMS 6 R2 is that Dynamic Content no longer needs to be registered in the web.config. Note that this only applies when the DynamicContentPlugInAttribute is used as an alternative.

The full source code for this example can be found here on EPiServer World Code.

The Beta version of EPiServer CMS 6 R2 can be found here.

Dec 20, 2010


Dec 20, 2010 05:03 PM

Great work. This will make it a'lot easier for developers to get started with dynamic content. Thanks!

Eric Dec 21, 2010 09:16 AM

This is awsome no i can stop use Allans old but great plugin :) Dec 22, 2010 05:36 PM

Just to add that even if you create Dynamic Content the old way by creating a class that implements IDynamicContent you can still use the DynamicContentPlugInAttribute on that class to avoid registering the DC in the web.config. Obviously, don't specify a ViewUrl if you don't render with a control.

In fact the section has been removed from the default web.config.

Please login to comment.
Latest blogs
Optimizely SendGrid SMTP host is deprecated

SendGrid is a services for sending email that is included in Optimizely DXP. Previously was the recommended SMTP server to use,...

Tomas Hensrud Gulla | Dec 4, 2022 | Syndicated blog

Hosting Optimizely CMS 12 on Docker Engine

Since Optimizely CMS can now be deployed as a Docker container, here is a demonstration of building, running and scaling an Optimizely CMS 12 site ...

Stefan Holm Olsen | Dec 4, 2022 | Syndicated blog

How to use CacheTagHelper with content areas in Optimizely CMS 12

I might be going out on a limb here - if you have a better solution, feel very free to share it!  Upgrading your Optimizely web application from .N...

Andreas J | Dec 2, 2022

The 1001st Piece in your 1000 Piece Puzzle: .NET Default Interface Functions

I was recently working with a client who wanted a reasonably large subsystem added to Optimizely that would add automated management to their...

Greg J | Nov 28, 2022 | Syndicated blog

Video Demonstration, creating a CMS12 Alloy Sample Site

Hey All Below you will find a quick video demonstration on how to install a local version of Alloy Sample based on CMS12 / .Net 6. As you will see ...

Minesh Shah (Netcel) | Nov 28, 2022

How to create an admin user I Optimizely CMS – with Episerver CLI

In this blog post I’ll show how to create an admin user for Optimizely CMS in a new environment where you don’t have access to the admin interface.

Ove Lartelius | Nov 28, 2022 | Syndicated blog