03rd December, 2014 by Samuel Watts

How to install the Envisage blog.

Installing the Envisage blog

Before we start the installation of the Envisage blog package, you will need to make sure you have the Envisage blog package file:

(Envisage_Blog.zip Download)

This package contains all of the files needed to install the Envisage blog, these include:

  • Controls
  • Templates
  • Services
  • App_Code
  • Web.config (Control references)

Installing the blog

Building the blog metadata forms

The first task we need to complete is the building of the Blog Meatadata forms, these include:

  • Blog Article
  • Blog Comment

If you haven't created a metadata form before, or need a refresher, you can read the 'Creating a metadata object' article.

Blog Article

Below is the structure and naming for 'Blog Article' meatadata form. You will need to copy the names exactly as they are referenced within the controls used for the blog to work.

The metadata form will be named 'Blog Article', and will consist of 3 fields:

  • Blog Title : Textbox
  • Blog Category : Dropdown List
  • Blog Short Description : Text Area

Blog Article Meta Data

You will have noticed the 'Blog Category' is a dropdown list, the settings for this field are shown below:

Drop Down Settings

The Dropdown list at default will appear blank, to populate it you wil either need to select a page id, where all the child pages of the selected page will be added to the list, or use the 'List Options' field and populate your values manually, in this example we have created some category pages within the site structure, and selected them:

You will notice the 'Blog Category' page has the same PageID as the one selected in the 'Parent Page' field for the drop down list settings.

Page Properties Blog Cat

Blog Category Site Structure

Blog Comment

Below is the structure and naming for the 'Blog Comment' metadata form. You will need to copy the names exactly as they are referenced within the controls used for the blog to work.

The metadata form will be named 'Blog Comment', and this will consist of 4 fields:

  • Comment Area : Text Area
  • Author Name : Textbox
  • Date Of Comment : Textbox
  • Email Comment : Textbox

Blog Comment

Moving Blog Files

Now that you have created your metadata forms, we need to copy the files from the 'Envisage_Blog.zip' package you should have downloaded at the beginning of the install.

Controls

First set of files you need to move are the 'Controls'. This folder contains 8 Folders which will need to be moved into your 'Controls' folder. Your controls folder will be located:

'<webroot>/Controls'

The controls are listed below:

ControlsImage

Templates

The second file you will need to copy across are the Templates. This folder contains two templates:

Blog Page Image

These will need to be copied across to you 'Templates' folder which can be found:

'<webroot>/Templates'

Services

The third set of files you will need to copy across are the Services. This folder may not exist so you can simply copy the whole folder, containing 1 file, to your webroot, as shown:

Services Folder

'<webroot>/Services'

The final file you need to move is the App_Code file. Again as with the 'Services' folder, this folder may not exist, so you can copy the whole folder, containing 1 file, to your webroot, as shown below:

AppCode Image

Updating Your Web.config

Now that you've copied all of the files to the correct location, the last thing we need to do to our files is update our web.config. You can locate your web.config from wihtin your webroot:

'<webroot>/web.config'

Within the web.config file you need to navigate down to the '<controls>' section, this can be found nested with:

<system.web>

   <pages>

          <controls>

          </controls>

   </pages>

</system.web>

Once you have navigated to the correct section, you will need to copy and paste the control declarations from the 'web.config.txt' file located within the package.

ControlDeclarations

If you would to read more about Blogs click on a article below:

How to build a blog

Does Envisage have blog and forum integration

About author

Samuel Watts

Sam is our resident video games expert. as well as being a dab hand (Or should that be knee) at muay thai. He is the man on the end of the phone dealing with your support requests.

Comment
We are always here to help you. Don’t hesitate to contact us anytime!

01202 555124 or hello@envisagecms.co.uk