Creating the Forums page

  Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic! Mail us feedback on this topic!  

The forums page will host the site's discussion forums. All the forum content will be displayed by this single page using the Forum group web part. In order for the page to display some content, there has to be some forum group defined via the administration interface.

 

Before you start creating the page, it is therefore recommended to create one forum group. In this chapter, you can see how a sample forum group can be created.

 

If you needed some more information about the Kentico CMS Forums module, you can find it in Kentico CMS Developer's Guide -> Module Forums.

 

1. Go to CMS Desk, select the root of the content tree and click New. Choose the Page (menu item) document type.

 

commguide_clip0211

 

2. In the following dialog, choose to Create a blank page using the Simple layout. Enter Forums into the Page name field and click Save.

 

commguide_clip0212

 

3. Switch to the Properties -> Template tab and click the Edit template properties link.

 

commguide_clip0213

 

4. In the pop-up window, switch to the Layout tab and replace the layout code with the following code:

 

<!-- Container -->

<div class="forumSearch">

 <cc1:CMSWebPartZone ID="zoneLeft" runat="server" />

</div>

 

Click Save.

 

commguide_clip0214

 

5. Switch to the Design tab. You can see only one web part zone on the page, so let's start adding web parts to it. First, we need a heading. Click the Add web part (AddWebPart) icon of the zoneLeft web part zone and choose the Text -> Editable text web part. Set the following properties of the web part, leave the rest of them as they are:

 

Web part control ID: editabletextHeader
Editable region title: Header
Editable region type: Text box
Content before: <h1 class="header">
Content after: </h1>

 

Click OK.

 

6. Switch to the Page tab and enter Forums into the Editable text web part's text box. Click Save.

 

commguide_clip0216

 

7. Switch back to the Design tab. Because some forums might be accessible only to authenticated users, we will add the Logon miniform web part below the heading. It will be displayed only to unauthenticated anonymous site visitors. Click the Add web part (AddWebPart) icon of the zoneLeft web part zone and choose the Membership -> Logon miniform web part. Set the following properties of the web part, leave the rest of them as they are:

 

Display to roles: _notauthenticated_
Logon failure text: Error logging in.
Username text: username
Content before: <div class="ForumLogonBox">
Content after: </div>

 

Click OK.

 

8. Below the logon mini form, the Forum search box web part will reside. It will enable users to search in the forum contents. Click the Add web part (AddWebPart) icon of the zoneLeft web part zone and choose the Forums -> Forum search box web part. Set the following properties of the web part, leave the rest of them as they are:

 

Advanced search path: /Forums/Forum-search
Context search: enabled

 

Content before:

 

<div class="ForumSearchBox">

<table cellspacing="0" cellpadding="0">

<tr><td style="vertical-align:top;padding-top:3px;"><b>Search forums:&nbsp;</b></td>

<td style="text-align: right">

 

Content after:

 

</td></tr></table></div><div class="clear"></div>

 

Click OK.

 

9. Below the Forum search box, we will place the Forum group web part. In order for it to display any content, you should have created some sample forum group as mentioned in the beginning of this chapter. Click the Add web part (AddWebPart) icon of the zoneLeft web part zone and choose the Forums -> Forum group web part. Set the following properties of the web part, leave the rest of them at the default values:

 

Group name: choose your previously created forum group
Enable favorites: enabled
Thread view mode: Flat - oldest to newest
Allow private messaging: enabled
Allow friendship request: enabled
Access denied page URL: ~/Special-pages/Access-denied.aspx
Use friendly URLs: enabled
Friendly Base URL: ~/Forums
Content after: <div style="height: 15px;"></div>

 

Click OK.

 

10. Below the Forum group, we will place the Forum search results. The web part will be displaying results of forum search performed by the Forum search box web part above. Click the Add web part (AddWebPart) icon of the zoneLeft web part zone and choose the Forums -> Forum search results web part. You can leave all properties of the web part at the default values.

 

11. The last web part on the page is the On-line users web part. We will set it up so that it displays the number of users who are currently browsing the forums section. Click the Add web part (AddWebPart) icon of the zoneLeft web part zone and choose the Membership -> On-line users web part. Set the following properties of the web part:

 

Transformation name: Community.Transformations.MembersOnline
Path: /Forums
Use default cache dependencies: enabled
Content before: <br />

 

Click OK.

 

12. The page is now finished. In Design tab, it should look as in the following screenshot.

 

commguide_clip0324

 

13. Finally, we will save the page as a new page template so that it can be reused in the future (we will use it when creating the Forum search page). Switch to the Properties -> Template tab and click the Save as new template link. In the pop-up dialog, enter the following details:

 

Template display name: My Community Site - Forums
Template code name: MyCommunitySite.Forums
Template category: My Community Site templates
Template description: some text describing the page template

 

Click OK. Click Save.

 

commguide_clip0227

 

Page url: http://devnet.kentico.com/docs/5_5r2/communitysiteguide/index.html?creating_the_forums_page.htm