Published on:Aug 10, 2011
Views: 10284
Number of votes: 9
Average rating:

Page Type Tabs For EPiServer

Since I started developing in EPiServer, I have always found how nicely written their framework is.  One thing i have noticed though, is the fact that you really can't hook into their "Create New", "Delete Page" pages.  I have also had an issue that there is not a way to group PageTypes in the admin mode or Create new screen.

I have been working on a project at work where there are a boat load of PageTypes and it has become quite tiresome searching for the right PageType.  You know the PageType exists, you just can't find it in the list.  So I decided to dig into the create new page and find a way to group these PageTypes and allow searching as well in case they do not want to use the tabs.  The only issue that i have found so far is there is no admin/edit interface to group PageTypes but that is okay with me since i am a coder.  I have although created the same thing without using PageTypeBuilder but as mentioned earlier, I am a coder so I chose to use this blog and spend more time with this project.

Using PageTypeTabs

In order to use PageTypeTabs, you will need to make sure you have reference PageTypeBuilder in your project.  This code does use PageTypeBuilder to find the proper PageTypes based on the classes we marked with a PageTypeTab Attribute.

Creating a Tab

   1: public class NewTab : PageTypeTab
   2: {
   3:     public override string Name
   4:     {
   5:         get { return "New Tab"; } // name of tab in ui
   6:     }
   8:     public override int SortIndex
   9:    {
  10:         get { return 300; } // default is 100
  11:    }
  12: }


Adding PageTypeTab Attribute To Our PageType Class

Now that we have our PageTypeTab created, we need to assign it to a PageType by adding an attribute to the PageType class we created using PageTypeBuilder. Below, you will see find the syntax of adding the attribute to the class.

   1: [PageTypeTab( Tab=typeof(NewTab))]
   2: [PageType(Filename = "/NewPage.aspx", Name = "Album Page", AvailableInEditMode = true, Description = "This pagetype is of NewPage.")]
   3: public class NewPage : TypedPageData
   4: {
   5: }

Adding Virtual Path Mapping

Now that wasn't so hard now was it?  It is the same process as adding a tab to a PageTypeProperty in PageTypeBuilder.  This isn't by accident, I used some of Joel's framework architecture to make it as common as possible so you don't have to do it another way all the time.

There is one last step to do and that is tap into the CreateNew page URL and show our page instead of EPiServer’s page.  The following code will need to be added to the episerver.config file in order for us to intercept the CreateNew page URL.

   1: <virtualPath customFileSummary="~/FileSummary.config">
   2:     <providers>
   3:         <clear />
   4:         <add showInFileManager="false" virtualName="CreateNewPage" virtualPath="~/Templates/PageTypeTemplates/Overrides/CreateNewPage.aspx" bypassAccessCheck="false" physicalPath="" name="CreateNewPageMapping" type="EPiServer.Web.Hosting.VirtualPathMappedProvider,EPiServer" />
   5:     </providers>
   6:     <filters />
   7: </virtualPath>
   8: <!-- virtualPathMappings are used by "VirtualPathMappedProvider". -->
   9: <virtualPathMappings>
  10:     <add url="~/secure/CMS/Edit/NewPage.aspx" mappedUrl="~/Templates/PageTypeTemplates/Overrides/CreateNewPage.aspx" />
  11: </virtualPathMappings>

What We've Achieved (Search built in)




Get The Files

Aug 10, 2011

Elena Gonzalez
( By Elena Gonzalez, 8/11/2011 4:43:45 PM)

Thanks Joshua!

( 8/11/2011 5:12:56 PM)

Nicely done! I bet this will come in handy for larger projects!

Joshua Folkerts
( By Joshua Folkerts, 8/11/2011 5:25:19 PM)

Very much so on large project, we're working on one with over 40 pagetypes (including widgets) and it makes it so much easier. Thanks for the compliments.

Erik Nordin Wahlberg
( By Erik Nordin Wahlberg, 8/11/2011 5:43:36 PM)

I like what I see! This is really handy when different editors uses different page types as well. Any way to extend it so a certain page type can be shown on two different Tabs?

( 8/11/2011 6:08:24 PM)

Very nice!

Mikael Swawola
( By Mikael Swawola, 8/11/2011 8:18:23 PM)

Very good work ! And why not a NuGet package ?
( By, 8/11/2011 8:33:16 PM)

Really nice!

Joshua Folkerts
( By Joshua Folkerts, 8/11/2011 9:20:49 PM)

I definitely can make this so you can add the same pagetype to multiple tabs. The only issue right now is i do remove the pagetypes from the available list and what isn't put under a tab, remains under the default tab. Any ideas how you would like this and i will modify to fit your needs.

Also, I did add it to nuget so hope this helps as well.

BTW, thanks for the compliments.

( 8/11/2011 9:56:02 PM)

Good stuff! Great way to organize a larger number of page types....and to find the one you want via search.

( 8/14/2011 10:14:25 AM)

+1 Very nice

( 8/14/2011 6:47:39 PM)

Awesome work, Josh!

( 8/14/2011 9:10:18 PM)

Really, really cool! Great job!

( 8/15/2011 12:55:06 PM)

Excellent work Josh!

( 8/15/2011 8:02:16 PM)

Great job with a very useful result for editors!
( By, 8/15/2011 9:08:49 PM)


Patrik Berglund
( By Patrik Berglund, 8/16/2011 12:01:17 PM)

Looks great! But how do I install and use it?

I have:
- Copied the dll file to a Dependencies folder and added a reference to the dll in the project.
- Created a new class for the tab
- Added the appropriate attribute to one of my PageTypeBuilder classes.
- Added a virtual path provider, and a virtual path mapping (and made changes to the paths to correspond to where I have EPiServer UI located).

After recompiling everything, I still get to the old page for selecting page types.

I'm running EPiServer CMS 6 R2.

Joshua Folkerts
( By Joshua Folkerts, 8/18/2011 6:38:05 PM)

Did you try restarting IIS. I have noticed that sometimes this has been an issue, just open command prompt and type in -> iisreset

( 9/2/2011 3:21:01 PM)

Great work! Is the source code available? I would like to globalize the CreateNewPage.aspx.

David Sandeberg
( By David Sandeberg, 9/5/2011 3:34:44 AM)

Great idea!
I'm running CMS 6 R2 and have the same issue as PaddtSe above. Everything works except for the virtual path mapping that does not seem to take effect. I can browse to CreateNewPage.aspx directly.
Anyone else experiencing this? Is there a solution?

Lars Kolsaker
( By Lars Kolsaker, 9/8/2011 2:31:04 PM)

Great work!
Some questions:

1. Which version of PageTypeBuilder have you used ? I am using the the latest version form Joel (1.9.2) and in this version PageTypeBuilder.Discovery.PageTypeDefinitionLocator does not have a parameterless constructor?

2. We are using Composer which already have a virtualpathmapping of newpage
. Any ideas on how to handle that?


Martin Emanuelsson
( By Martin Emanuelsson, 1/13/2012 8:44:05 AM)

Great addition to the platform!
One little problem that I've come across though. I've included the classes using Nuget and now I'm trying to declare these tabs in a class library where we have all our PageTypeBuilder classes declared but for some reason this won't build. If I move my PageTypeTab-class to the web applicaiton it works fine, do you know if it should be possible to declare the PageType tabs in an external class library or do we need to move our PageTypeBuilder classes to our web application project? Or am I doing something else wrong?
Best regards

Ulrik Andersson
( By Ulrik Andersson, 1/14/2012 11:06:21 AM)

Looks great but I am unable to use it with CMS 6.0. Is the source code available for this project, since it uses PageTypeBuilder?

( 3/19/2012 10:20:49 AM)

I ran across a problem though. Administrators can only effectively set create permissions on the page types on the default tab. On any other tab, all page types are listed regardless of the permissions and the editors group memberships.

Also, an easy way to rename the default tab to a custom label name would be nice.

Please login to comment.