Setup Instructions

You can view our setup instructions here.

Theming and Master Page Customization

Overall, we tried to keep this a very simple website. The only real complicated portion of it is how we're handling the master page switching. By design, we wanted the ability to customize HTML wire frames for each section.

The theme folder is located at: /Content/Themes/. Each theme is associated with a section and contains its master page, imaging, and css. Keep this in mind when pathing your css. The theme selection will search for a section name first. If a theme doesn't exist, it will fall back to the Default theme. To create a new theme, simply create a folder with the same name as its corresponding section and copy the master file from Views/Shared/Template.master file into the new theme folder. Rename your copied master file to Site.Master. The default theme out there is just a sample placeholder from OSWD Feel free to replace it with your own or modify it however you like.

If you want to add views or controllers, don't forget to make all views inherit from the base class: IWS.SiteManager.Web.Views.LayoutView, which also supports the generic model version: IWS.SiteManager.Web.Views.LayoutView<T>. If you add controllers, take a look at the existing ones to see how it loads up the master page on construction.

Viewing the Website

The routes in global.asax.cs define how the site pulls content. But basically to browse any page, you need to use this format: /View/{section}/{permalink}. So for example, if your section is Home and your page's permalink is "welcome-to-our-site", then its url will be: /View/Home/welcome-to-our-site. If you make the section default for the site (in settings) and setup a default page for the section, you can browse to it with just the root path /. For default pages in a section, just browse to the section like in /Home. If you've logged in, you may browse links like this and it will give you the opportunity to create new pages on the fly. If the page doesn't exist, the PageNotFound view will display.

Editing the Website

In order to edit the website, you must first login. To login, browse to /Account/Logon. Every page you browse should contain an "Edit this Page" link in the top right. Click it to view the edit content page. From there, you can edit your content, define your tags, meta overrides, associated sections and a default section page flag. Make your changes and click Save to update the site. You may also browse to it manually through the management menu by first going to Section Management. Then drilling down to your page.

With regard to users, for the time being you can manage them with the configuration tool in visual studio. Eventually, we'll build in a user manager into this application.

SEO Settings

Here, you can change your sitemap filename, edit your Google Webmasters settings, and setup your Google Analytics ID. When these are setup, it automatically causes them to be rendered on the front end in the proper places. In the case of Google Webmasters, you have the option of choosing between the File verification or the Meta Tag verification. The meta tag method is less invasive and doesn't require file permissions. The file option is available and will automatically generate the html file Google requires for the file verification method.

The sitemap.xml file is regenerated every time a page is updated.

Other Settings

The Custom Settings section of the admin site will contain all of the SEO settings plus some other miscellaneous settings for the site. A very important one to check however is the hostname setting. Be sure to update this when publishing your site. It will affect SEO, Analytics and a few other components of the website.

Last edited Oct 27, 2009 at 6:04 PM by nlb6665, version 6


No comments yet.