HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Content

Introduces the concept of content and content types in Optimizely.

Content in Optimizely Content Management System (CMS) can be pages, blocks, media files, and folders. It can also be catalog content in Optimizely Customized Commerce. In the Optimizely content model, a content type is inherited from the Content interface and contains specific properties.

Content in Optimizely can be almost anything as long as it is a class that implements the IContent interface.

Graphic showing Content in Optimizely can be almost anything as long as it is a class that implements the IContent interface

This means that if you have an instance of a class that implements IContent, you can use the Optimizely API to save it to the CMS database. The IContent interface also provides a set of important basic properties such as the content display name, references, and unique identifiers for the content item.

namespace EPiServer.Core {
  // Summary:
  //     Interface that must be implemented by a component that is to be stored in
  //     the content repository.
  public interface IContent: IContentData {
    // Summary:
    //     Gets or sets the unique identifier of this EPiServer.Core.IContentData instance.
    //      It is used as identifier of this item when it is transferred outside of
    //     the current system.
    Guid ContentGuid {
      get;
      set;
    }
    //
    // Summary:
    //     Gets or sets a reference to this EPiServer.Core.IContentData instance.  It
    //     is used as a identifier for this item within the EPiServer system.
    ContentReference ContentLink {
      get;
      set;
    }
    //
    // Summary:
    //     Gets or sets the ID of the content type that describes this EPiServer.Core.IContentData
    //     instance.
    int ContentTypeID {
      get;
      set;
    }
    //
    // Summary:
    //     Gets or sets a value indicating whether this instance is deleted.
    bool IsDeleted {
      get;
      set;
    }
    //
    // Summary:
    //     Gets or sets the name of this EPiServer.Core.IContentData instance.
    string Name {
      get;
      set;
    }
    //
    // Summary:
    //     Gets or sets a link to the parent content item in the EPiServer system.
    ContentReference ParentLink {
      get;
      set;
    }
  }
}

Content model and types

When developing your solution, plan a content type model hierarchy and use class inheritance to reduce code and access built-in features in Optimizely. Use MVC conventions for controllers, models, and views. This provides flexibility when extending your solution, and you can create content types by adding model classes.

Create a page type that implements IContent to get the basic properties, add custom properties like author, an editorial area, and publish date.

Example: A page type created using the Optimizely Visual Studio extension.

namespace MyOptimizelySite.Models.Pages {
  [ContentType(
    GroupName = "Basic pages",
    Order = 1,
    DisplayName = "StandardPage",
    GUID = "abad391c-5563-4069-b4db-1bd94f7a1eea",
    Description = "To be used for basic content pages.")]
  public class StandardPage: SitePageData {
    [CultureSpecific]
    [Display(
      Name = "Main body",
      Description = "The main body will be shown in the main content area of the page, using the XHTML-editor you can insert for example text, images and tables.",
      GroupName = SystemTabNames.Content,
      Order = 1)]
    public virtual XhtmlString MainBody {
      get;
      set;
    }
  }
}

Settings defined in the user interface take precedence over settings from your model, and content types can be added and modified from the administrative user interface. However, these will not be strongly typed, and this approach is not recommended. Managing content types from code also makes deployment to multiple environments easier.

Initialize and sync

During site initialization, the initialization scans assemblies in the bin folder, and the synchronization engine adds classes decorated with the EPiServer.DataAbstraction.ContentType attribute. A content type is constructed by merging the settings from the model class with any settings defined in the administration view.

You can see examples of different content types if you install a sample site.

Built-in functionality

When using the Optimizely content model, certain functionality is available by default for content types. You get wastebasket support, content reference checking when deleting content items, and drag-and-drop support from the assets panel into any overlay or editor that handles files.