SaaS CMS has officially launched! Learn more now.

How to create a hello world page.


Unfortuatnely, there seem to be no tutorials for creating hello world pages and blocks.

I have now figured out how to create blocks, with their optional models and partial views by copying "contentBlock" form Alloy.

The next problem is how to create a new page, with its own templates etc. 

E.g. if I just wanted to output this:

hello from block 1
hello from block 2

I have a block which can render a message.  Now I need a page to put the blocks on.

So I would guess I need some or all of the following:

1) a page template view. This is the thing which will have something like:


2) a page controller. This will do nothing except render the index action.

3) a page model. This will contain a single content area.

4) anything else?

The next problem is where to put the above files, and what they should contain.

If we look at alloys simplest page, "contact us".  it is of type "standard page"

Searching for how standard page was implemented, we see a view in


@using DxcAlloy
@model PageViewModel<StandardPage>

@{ Layout = "~/Views/Shared/Layouts/_LeftNavigation.cshtml"; }

<h1 @Html.EditAttributes(x => x.CurrentPage.PageName)>@Model.CurrentPage.PageName</h1>
<p class="introduction" @Html.EditAttributes(x => x.CurrentPage.MetaDescription)>@Model.CurrentPage.MetaDescription</p>
<div class="row">
    <div class="span8 clearfix" @Html.EditAttributes(x => x.CurrentPage.MainBody)>
        @Html.DisplayFor(m => m.CurrentPage.MainBody)
@Html.PropertyFor(x => x.CurrentPage.MainContentArea, new { CssClass = "row", Tag = Global.ContentAreaTags.TwoThirdsWidth })

This is a start. It contains only the body part - the Heading, nav and content.  Where is the outer part defined? the <head> for example?

Under Models/Pages we have

namespace DxcAlloy.Models.Pages
    /// <summary>
    /// Used for the pages mainly consisting of manually created content such as text, images, and blocks
    /// </summary>
    [SiteContentType(GUID = "9CCC8A41-5C8C-4BE0-8E73-520FF3DE8267")]
    [SiteImageUrl(Global.StaticGraphicsFolderPath + "page-type-thumbnail-standard.png")]
    public class StandardPage : SitePageData
            GroupName = SystemTabNames.Content,
            Order = 310)]
        public virtual XhtmlString MainBody { get; set; }

            GroupName = SystemTabNames.Content,
            Order = 320)]
        public virtual ContentArea MainContentArea { get; set; }

This is pretty straight forward, it defines two properites,t he main body and the content Area.  The other pages properties are defined in SitePageData.

So thats the models covered I think.


Under /Controllers we can see some block controllers, which is odd as most blocks wont have controllers, but I cant see a page controller for "Contact us" nor for "SitePageData" nor "Standard Page".  could it be using "DefaultPageController"? 

Default page controller looks like this:

namespace DxcAlloy.Controllers
    [TemplateDescriptor(Inherited = true)]
    public class DefaultPageController : PageControllerBase<SitePageData>
        public ViewResult Index(SitePageData currentPage)
            var model = CreateModel(currentPage);
            return View(string.Format("~/Views/{0}/Index.cshtml", currentPage.GetOriginalType().Name), model);

        private static IPageViewModel<SitePageData> CreateModel(SitePageData page)
            var type = typeof(PageViewModel<>).MakeGenericType(page.GetOriginalType());
            return Activator.CreateInstance(type, page) as IPageViewModel<SitePageData>;

This in herits from PageControllerBase, which has the login stuff and a strange section "modifyLAout" which just hides the header and footer, for no apparent reason.

Next we need to figure out how to create the most basic of views for a new page:


As we noted, /Views/StandardPage/index.cshtml is missing most of the markup.

There is no "DefaultPage" nor "BasePage", so where is this defined?  Where is the overall master tempage which renders most of the html?

By searcing all files, I found Views/Shared/Layouts/_Root.cshtml.

Where is this defined? how can I define that my page should use a different root  view (or no root view if I want to hard code it in my page).

Edited, Jun 20, 2020 10:06

I will just jump in, trying to answer some of your questions.

- Q: Where is <head> defined?
- A: \Alloy\Views\Shared\Layouts\_Root.cshtml

- Q: Where is it defines that the _Root.cshtml mentioned above is used?
- A: \Alloy\Views\_viewstart.cshtml

- Q: How can I define that my page should use a different root  view (or no root view)?
- A: Add a _viewstart.cshtml to the folder, or simply set the Layout in your view (in the same way as in _viewstart.cshtml).

- Q: Controller for "Standard Page" etc?
- A: The comment for DefaultPageController says: "Concrete controller that handles all page types that don't have their own specific controllers". Set a breakpoint to verify.

Edited, Jun 22, 2020 6:47

It's not that complicated, to create a new page type.

New page type definition, can also be used as the model:

using EPiServer.Core;

namespace Alloy.Models.Pages
    [SiteContentType(GUID = "F336C153-137B-4D55-AD95-5F5BB3F7CEFC")]
    public class NewPage : SitePageData
        public virtual ContentArea MyContentArea { get; set; }

And then, your view, placed in \Alloy\Views\NewPage\Index.cshtml

@model PageViewModel<NewPage>
@Html.PropertyFor(x => x.CurrentPage.MyContentArea)

Then, that's it! You have  a start, and can work from there...

Edited, Jun 22, 2020 6:56
* You are NOT allowed to include any hyperlinks in the post because your account hasn't associated to your company. User profile should be updated.