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:
This package contains all of the files needed to install the Envisage blog, these include:
- 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.
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
You will have noticed the 'Blog Category' is a dropdown list, the settings for this field are shown below:
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.
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
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.
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:
The controls are listed below:
The second file you will need to copy across are the Templates. This folder contains two templates:
These will need to be copied across to you 'Templates' folder which can be found:
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:
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:
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:
Within the web.config file you need to navigate down to the '<controls>' section, this can be found nested with:
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.
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