Overriding EPiServer pages

It is not very frequent or pretty but still sometimes it’s inevitable: we have to “steal” the code of EPiServer through Reflector/ILSpy/other and modify it to suit our needs. This way you can customize pages or user controls anyway you wish, beyond the way EPiServer allows through conventional channels.

The process is simple. Through Reflector or ILSpy you “steal” the code of the page you want to override. You compile that class, with a different namespace, into a new assembly. Then, you modifiy the markup file to point to your new class. That’s it.

Let’s see an example, let’s say you want to customize the NewPage.aspx that EPiServer provides. What would you do:

  1. Open NewPage.aspx in a text editor to figure out what class it inherits from ( e.g. EPiServer.UI.Edit.NewPage )
  2. Open the assembly that contains that class in Reflector or ILSpy ( typically the assembly is EPiServer.UI.dll – at least for EPiServer 5 that I’m currently using )
  3. Find the class and save it into a C# code file.
  4. Edit this class in a text editor and change the namespace.
  5. Compile this class into a new assembly and copy the assembly in EPiServer’s installation bin folder.
  6. Edit NewPage.aspx and change the class it inherits from, setting it to your new class.

At this point, the NewPage.aspx should still work but now the code is yours to do as you please.

Hopefully you won’t have to do many of these hacks. But regardless of that, you should be careful on the maintenance of your code. An idea could be that you keep all of these “stolen” classes in a separate assembly. Also you could mirror the namespace structure of the classes you’re “stealing”, so if you’re taking the code from the class EPiServer.UI.Edit.NewPage, you can place its copy at MyProject.UI.Edit.NewPage. This way of organizing the “stolen” code offers the advantage that we know immediately the original location of the class we “stole” from, in case we need to check back for the original. It also removes the need of thinking where the “stolen” code should be placed and serves as a straight forward convention for the developers to use.

Another good idea is to add comments in the code about all the things you change and why you are doing it. These hacks should be justified and easy to isolate. Otherwise upgrading to the next EPiServer version might become difficult. You should know what your hacks do and why you implemented them in the first place; maybe the next EPiServer version will have them as built-in features thus making your hacks obsolete. And if you still need the hack, you should be able to identify and isolate the customized part of the code in order to try and reapply the hack in the next version.

Hope this helps.


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s