Table of contents
Episerver Shell contains a profile API store for storing editor settings; similar to the ASP.NET profile but more practical to use and has a client API available for Dojo components.
Client API
This section shows how to use the profile from client-side code.
Initializing the client profile object
Usually, the client profile is registered in the service locator where multiple components can manipulate the same profile and observe changes on the profile. The CMS application already performs this initialization so it you do not have to when you create CMS components.
JavaScript
initialize: function (settings) {
dojo.require("epi.shell.Profile");
this.registerDependency("epi.shell.Profile", new epi.shell.Profile());
}
Accessing and storing the global profile object on a component
To work with the client profile, assign an object field during component initialization.
JavaScript
postCreate:function () {
this._profile = epi.dependency.resolve("epi.shell.Profile");
},
Reading from the client profile object
To access values in the profile, use the get method.
JavaScript
getProfileValue: function(){
return this._profile.get("MyKey");
},
Writing to the client profile object
To set values in the profile, use the set method.
JavaScript
setProfileValue: function(value) {
this._profile.set("MyKey", value);
}
Observing changes to the client profile
The profile is a Dojo observable object and you can use the Dojo API for observing changes.
JavaScript
postCreate:function () {
this._profile = epi.dependency.resolve("epi.shell.Profile");
this._profile.watch("MyKey", dojo.hitch(this, function (name, oldValue, value) {
this.doSomethingUsefulWith(value);
}));
},
Server API
This section shows how to use the Shell profile from server-side code.
Reading profile data
To read profile values, use the profile repository.
C#
using EPiServer.Shell.Profile;
public class ProfileManipulator : TemplatePage
{
public object GetMyValueFromProfile()
{
if(User.Identity.IsAuthenticated)
{
var repository = Locate.ProfileRepository();
var profile = repository.GetOrCreate(User.Identity.Name);
object value;
if (profile.Settings.TryGetValue("MyKey", out value))
{
return value;
}
}
return null;
}
}
Writing profile data
To set profile values programmatically, get a profile using the profile repository, change it, and use the save method on the profile repository. Keep in mind that the value must be a type supported by DDS.
C#
using EPiServer.Shell.Profile;
public class ProfileManipulator : TemplatePage
{
public void StoreValueInProfile(bool isOrIsnt)
{
if(User.Identity.IsAuthenticated)
{
var repository = Locate.ProfileRepository();
var profile = repository.GetOrCreate(User.Identity.Name);
profile.Settings["MyKey"] = isOrIsnt;
repository.Save(profile);
}
}
}
Giving new profiles default values
Setting values on a profile involves listening to events on the profile repository, and manipulating the profile object before it is used for the first time. A good place for doing this is in an initializable module.
C#
using EPiServer.Shell.Profile;
public class ProfileInitializer : IInitializableModule
{
public void Initialize(InitializationEngine context)
{
var repository = context.Locate.ProfileRepository();
repository.ProfileCreated += OnProfileCreated;
}
void OnProfileCreated(object sender, ProfileEventArgs e)
{
e.Profile.Settings["MyKey"] = true;
}
}
Do you find this information helpful? Please log in to provide feedback.