Content
Content in Optimizely Content Management System (CMS) 13 can be pages, blocks, media files, and folders. It can also be catalog content in Optimizely Commerce Connect. In the Optimizely content model, a content type inherits from the Content interface and includes specific properties.
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 CMS REST API to save it to the CMS 13 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
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 create content types by adding model classes.
Create a page type that implements IContent to get the basic properties. Then add custom properties like author, an editorial area, and publish date.
The following example shows 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 UI take precedence over settings from your model. Add and modify content types from the administrative UI, but these are not strongly typed, and this approach is not recommended. Managing content types from code makes deployment to multiple environments easier.
Initialize and sync
The initialization module scans assemblies in the bin folder during startup, 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 page.
Install a sample site.
Built-in functionality
The Optimizely content model provides built-in functionality for all content types: 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.