NOTE: Some items in this table only appear when editing an existing discussion board’s properties.

Modifying Discussion Forum Permissions for Membership Users

By default, membership users are assigned the following permissions:

• Read only
• Add Topic
• Post Reply

They cannot be granted Edit or Delete topic nor advanced permissions (Add, Edit or Delete forum). However, if a membership user creates a new topic, the user can delete it.

1. Navigate to and click the discussion board so it appears in the Workarea.
2. Click View > Permissions.
3. Click the User Type drop-down field and choose Membership Users.
4. The View Permissions for Board screen appears.
5. Add new member users and groups, remove them, or change their permissions.

Granting Discussion Board Permissions

1. Navigate to and click the discussion board so it appears in the Workarea.
2. Click View > Permissions.
3. Click Add. All users and groups who are not currently assigned permissions appear.
4. Click any user or group. The Add Permission for Folder screen appears with the selected user or group.
5. Assign appropriate standard and advanced permissions then click Save.

Removing Discussion Board Permissions

1. Navigate to and click the discussion board so it appears in the Workarea.
2. Click View > Permissions.
3. Click Delete ().
4. Select a user or group that you want to remove from the Permission table. A confirmation message.
5. Click OK. The user is removed.

After you remove a user, discussion boards do not appear in his Workarea.

Editing Discussion Board Permissions

1. Navigate to and click the discussion board so it appears in the Workarea.
2. Click View > Permissions.
3. Click the user or group whose permissions you want to edit. The Edit Permissions screen appears.
4. Change the settings as appropriate.
5. Click Save.

Adding an IP Address to the Restricted List

1. In the Workarea, click the Content tab.
2. Select a forum from the folder structure.
3. Click New > Restricted IP.
4. Enter the IP Address to be blocked in the Block IP field.
5. Click Save. A list of restricted IP addresses appear.

Editing a Restricted IP Address

1. In the Workarea, click the Content tab.
2. Select a forum from the folder structure.
3. Click View > Restricted IPs. A list of restricted IP addresses appears.
4. Click the IP address to be edited.
5. Click Edit.
6. Edit the IP address in the Block IP text box.
7. Click Save.

Deleting a Restricted IP Address

1. In the Workarea, click the Content tab.
2. Select a forum from the folder structure.
3. Click View > Restricted IPs. A list of Restricted IP addresses appears.
4. Click the IP address to be deleted.
5. Click Delete (). A dialog asks if you are sure you want to delete the restricted IP address.
6. Click OK to continue. A list of the remaining restricted IP addresses appear.

Adding a User Rank

To add a user rank:

NOTE: You can also access the User Ranks screen from Workarea > Settings > Configuration > Discussion Board > User Ranks. If you have more than one forum, this screen lets you pick the discussion board to which a rank is assigned.

1. In the Workarea, click the Content tab.
2. Select a discussion board.
3. Click New > User Rank. The User Ranks screen appears.
   

   

   • Name—The name of the rank. For example, New User, Expert User, Developer, or Associate.
   • Rank Image—Click Upload to browse and select an image to upload. When uploaded the path where the image is stored appears in the text box. Images are optional. If you assign an image, it appears below the user’s name on any post.
   • Number of Posts—Enter the number of posts it takes to reach this rank. If the Starting Rank check box is checked, the number is 1 and cannot be changed.
   • Ladder System—Check this box if this rank is part of a ladder system. That is, a rank based on the number of posts a user has submitted to this discussion forum. If you uncheck Ladder System, both Starting Rank and Number of Posts become inactive, since those fields set up and manage the ladder system.
   • Starting Rank—If you are using a ladder system, use this check box to designate this rank the Starting Rank. A user is assigned to this rank when the user submits the first post. A discussion forum can only have one Starting Rank. Also,if this is the Starting Rank, you cannot enter a number of posts.
   • Applies To—If you accessed this screen from Workarea > Settings > Configuration > Discussion Board > User Ranks, use this field to select the discussion forum to which this rank applies.
4. Click Save.

Deleting a User Rank

1. In the Workarea, click the Content tab.
2. Select a discussion board.
3. Click View > User Ranks.
4. Select the rank you want to delete.
5. Click Delete ().
6. Click OK to the confirmation message.

Changing a User’s Rank

A user’s rank appears below the user name on any post the user has made. You can only move a user into and out of a ladder system. You cannot change his rank within a ladder system—that is determined by the number of posts.

To change a user’s current rank, you must know what it is. To change a user’s rank:

1. In the Ektron Workarea, go to Content and navigate to the forum to which the user has posted.
2. Click View > User Ranks.
3. Select the rank that you want to move the user out of. The User Ranks screen appears. The lower half shows all users assigned that rank.
   

   

4. Click the user that you want to move out of the rank. The screen displays all ranks. The current one is selected.
   

   

5. Click next to the desired rank.
6. Click Save.

Creating the Email Message

You can create an email message to be sent when these discussion board events occur.

• a new post is added
• a new topic is added
• someone reports a post See Also: Setting Up Post Reporting

A simple editor lets you apply some XHTML formatting the message. To create a message:

1. In the Workarea, go to Settings > Configuration > Discussion Boards > Messages.
2. Click Add.
3. Enter a title that describes the message.
4. At the Type field, select either NewForumTopic, ReportForumPost, or ForumPost.
5. Select whether to make the email message a Default message.
6. Enter the message subject.
7. In the editor, enter the message text. Use the variables listed in the table above to retrieve information about the about the new post or topic and display it in the message.
8. Click Save.

Including Variables in the Default Message

The messages can include variables that retrieve information about the new post or topic and display it in the message text. The variables are surrounded by at signs (@). For example:

@appPosterDisplayName@ has created a thread you have subscribed to.

In the email, this text might read:

Alan Administrator has created a thread you have subscribed to.

You can use the following variables in the body of discussion board email notifications.

• @appTopicTitle@—The title of the topic.
• @appTopicId@—The integer ID of the topic.
• @appRecipientDisplayName@—The display name of the person receiving the email.
• @appRecipientId@—The recipient’s integer ID.
• @appRecipientFirstName@—The first name of the person receiving the email.
• @appRecipientLastName@—The last name of the person receiving the email.
• @appRecipientEmail@—The email address of the person receiving the email.
• @appHostUrl@—The host site’s URL.
• @appForumUrl@—The forum’s URL.
• @appPostMessage@—The text of the message that was posted to the discussion board.
• @appPosterId@—The integer ID of the person who created the post.
• @appPosterDisplayName@—The display name of the person who created the post.
• @appPosterProfileUrl@—The profile URL for the person who created the post.
• @appPostUrl@—The URL of the post on the Web site.

1. Create a new post or reply to an existing post.
2. Click Attachments. The Attachments window appears.
   

   

3. Click Browse... to navigate to the file that you want to attach.
4. Click Open.
5. Click Attach to attach the file to the post.The file appears in the list of Current File Attachments.
6. When all attachments have been added, click Close.

1. Click Attachments below the editor.
2. Highlight the attached item.
3. Click Remove.
4. Click Close.

Adding Video to a Post

You can add video to a post by clicking Insert WMV () in a forum post using eWebEdit400. The following are prerequisites for this action.

• the embed tag must be added to the Accepted HTML property in the Workarea forum’s properties.
• a user must be using eWebEdit400
• the video must be in the .wmv format
• the video must reside in a hosted location. For example,
  
  http://www.example.com/myvideos/fridaylunch.wmv

Moving a Topic and Its Posts to Another Forum

To move a topic and its associated posts in one forum to another, the forum to which you want to move the topic and posts must exist.

1. Access a page on your Web site that has a login button.
2. Sign in as a member of the Administrators group or as a Moderator of the board.
3. Navigate to a page with discussion board and select a forum.
4. Navigate to a topic page.
5. Click the Move to... drop-down list.
6. Select the topic to which you want to move.
7. Confirm that you want to move all posts.

Replacing Words in a Post

You can configure Ektron to replace unwanted words in a post such as obscene or indecent words that should not appear on your site. You also can fix commonly misspelled words. For example, the can replace teh.

The Replace Words feature works with exact matches but does not append words. For example, if you replace car with auto, the sentence I bought the car from the cartel becomes I bought the auto from the cartel. Note that cartel did not change to autotel even though the word car appears in cartel.

Using regular expressions

Using Regular Expressions

If you would like the Replace Words feature to modify words that contain a word you do not want used, you can use Regular Expressions. A Regular Expression, often referred to as regex, is a pattern of metacharacters placed around a word that describes a string. Used for string manipulation, regex lets you detail a succinct description of a group of words without having to detail each word in the group.

• .—Matches any character, similar to a wildcard. For example, .ar matches any 3-letter word ending in ar, such as car, bar, tar or far.
• |—Acts as an or operator. For example, steak|stake would find steak or stake.
• [ ]—Matches one character that is between the brackets. For example, [rst] matches r, s or t. [d-g] matches d, e, f, or g. Another example, [bc]ar matches bar and car. If you need to match a dash (-), use it a the beginning or end of the group. For example, [xyz-] or [-xyz].
• [^ ]—Matches one character that is not in the group. For example, [^rst] matches any character other than r, s or t. Another example, [^bc]ar does not match bar or car, but does match words, such as tar or far.
• ^—Matches the beginning of any line. For example, ^[bc]ar matches bar or car, but only at the beginning of a line.
• $—Matches the end of any line. For example, ^[bc]ar matches bar or car, but only when it appears at the end of a line.
• ( )—Marks a sub expression. For example, alt(a|e)r finds altar or alter.
• *—When an expression is followed by *, it matches zero or more versions of the expression. For example, [rst]* finds (blank), r, s, t, rs, sr, rt, tr, st, ts, rst, rts, srt, str, trs and tsr.
• +—When an expression is followed by +, it matches one or more versions of the expression. This differs from * because it does not match (blank). It must match at least one character. For example, r+ matches r, rr, rrr and so on.
• {x,y}—Must match at least x times and not more than y times. For example, s{2,4} matches ss, sss and sss. You can also use {x} to specify an exact match. For example, s{3} matches sss. You can use {x,} to specify that the match is at least x amount of times. For example, s{4} matches ssss, sssss, ssssss and so on.
• ?—Must match the preceding character zero or one times. For example, Boa?rder matches boarder and border.

Viewing replacement words

Viewing Replacement Words

1. In the Workarea, click the Content tab.
2. Select a forum from the folder structure.
3. Choose View > Replace Words. A list of word to be replaced appears.

Adding a replacement word

Adding a Replacement Word

NOTE: In addition to using Replace Words for a specific forum, you can access the Replace Word feature from the Workarea > Settings > Configuration > Discussion Board > Replace Words. If you have more than one forum, this allows you select to which discussion boards the Replace Words feature is applied.

1. In the Workarea, click the Content tab.
2. Select a forum from the folder structure.
3. Click New > Replace Word. The Replace Words screen appears.
4. Click Add.
5. Add the word to be replaced in the Old Word textbox.
6. Add the replace word in the New Word textbox.
7. Select the language for the Replace Word.
8. Click Save.

Editing a replacement word

Editing a Replacement Word

1. In the Workarea, click the Content tab
2. Select a forum from the folder structure.
3. Click View > Replace Words.
4. Click either the Old Word or the New Word to edit.
5. Click Edit.
6. Change the Old Word, New Word or Language.
7. Click Save.

Deleting a replacement word

Deleting a Replacement Word

1. In the Workarea, click the Content tab.
2. Select a forum from the folder structure.
3. Click View > Replace Words.
4. Click either the Old Word or the New Word to delete.
5. Click Delete. A dialog box asks if you are sure you want to delete.
6. Click OK.

Adding Emoticons to a Post

An emoticon is an icon used to express emotion in a forum post. In the post editor, click the emoticon () symbol.

You can also enter a few characters that resemble the image. For example, to insert , enter O:\). While working in a post, the user only sees the text. But when the post is saved, Ektron converts the text to the corresponding emoticon. In all subsequent work with the post, users see only the emoticon. You can add new emoticons at Settings > Configuration > Discussion Boards > Emoticons.

You also can place emoticon images in the following folder: webroot\Workarea\threadeddisc\emoticons. Administrators reference these files when editing or creating new emoticons.

Creating or editing an emoticon

Creating or Editing an Emoticon

1. Within the Ektron Workarea, go to Settings > Configuration > Discussion Boards > Emoticons.
2. Click the emoticon text or image that you want to edit.
3. Click Add or Edit.
   • Emoticon Text—Enter or update the characters a forum participant would enter to insert this emoticon.
   • Emoticon Image—Enter the name of the image file that will appear after a user enters the above Emoticon text and saves the post. Administrators place emoticon images in the siteroot\Workarea\threadeddisc\emoticons folder.
   • Regex—See Using Regular Expressions
   • Language—Select the emoticon’s language from the drop-down list. If a forum is language-specific, only emoticons assigned to that language or all languages are available.

Deleting an emitocon

Deleting an Emoticon

1. Within the Ektron Workarea, go to Settings > Configuration > Discussion Boards > Emoticons.
2. Click the emoticon that you want to delete.
3. Click Delete.
4. Reply to the confirmation message.

NOTE: If the forum server control’s HideUserProfile property is set to true, non-administrator forum visitors cannot see a user profile, even if the Private Profile field is set to Public.

The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio^® help.

• AllowAnonymousPost (Boolean)

  Set to True to allow site visitors the option of posting anonymously to the forum. When true, a Post Anonymous checkbox appears above the text editor used to create a post.

  

  If a site visitor adds a check mark to this box, the word Anonymous appears where the Display Name normally appears. The default is True.

  • True—make the Post Anonymous checkbox available to site visitors when they create a post.
    
  • False—disable Post Anonymous checkbox.
• Authenticated (Boolean)

  Indicates if you are logged into the CMS Explorer and can use it to browse to content, collections, and so on. See Also: Browsing Your Ektron Site Using CMS Explorer.

• BoardID (Long)

  The ID of the discussion board to display on this page if one is not defined in a query string parameter. If you don’t know the ID, click Ellipses (), then sign in and select a discussion board.

• CacheInterval (Double)

  The number of seconds that the server control’s data is cached. The default is 0 (zero). For example, if you want to cache the data for 5 minutes, set to 300. See Also: Caching with Server Controls.

• CustomOrderBy (String)

  Provide a property’s Friendly Name to order search results by that property. For example, if you define DocAuthor, results will be sorted by the document’s author. Results can be ascending or descending based on OrderDirection. If you enter an invalid property, no search results are returned. If you specify both CustomOrderBy and OrderBy, the OrderBy property is ignored.

• DefaultObjectID (Long)

  The Static ID of a community group.

• DynamicForumParameter (String)

  Gets or sets the QueryString parameter to read a forum ID dynamically. The default is “f”. Note that a Forum resides one level below a discussion board.

• DynamicGroupParameter (String)

  Gets or sets the QueryString parameter to read a group’s ID dynamically. The default is “g”.

• DynamicObjectParameter (String)

  Dynamic Parameter for the community group id. Default is “id”.

• DynamicParameter (String)

  Gets or sets the QueryString parameter to read a discussion board’s ID dynamically. Set to None - Use Default—if you want to always display the default discussion board. Note that a discussion board is one level above a Forum.

  • boardid—reads a Threaded discussion board’s ID dynamically.
  • None - Use Default—use the default discussion board’s ID.
  • ID—reads a discussion board’s ID dynamically.
• DynamicThreadParameter (String)

  Gets or sets the QueryString parameter to read an individual thread’s ID dynamically. The default is “t”. Note that a Thread resides 2 levels below a discussion board and one level below a Forum.

• EditorCSS (String)

  Set the style sheet for the Editor when a site visitor creates or edits a post. By default, this property is blank. When a style sheet is not supplied, the style sheet defined in the Theme property is used.

• EditorToolbar (String)

  Enter a comma separated list of items that you want to appear on the Editor’s toolbar. The default is StyleMenu, FontMenu, ParagraphMenu, TextFormatMenu, LinkMenu, ClipBoardMenu, SymbolsMenu, EmoticonSelect, WMV, Table. See Also: Adding and Removing Toolbar Items From the Editor.

• EnableForumQuickSelect (Boolean)

  If you set this property to true, a drop-down list of all forums appears below the topic list. The site visitor can click a forum and jump immediately to it.

• EnableThreadRating (Boolean)

  If you set this property to true, a ContentReview server control appears on any topic screen run by this server control. The site visitor can use the control to rate the topic thread. An average rating for the thread appears next to each topic on the forum screen.

  

• ExcludeList (String)

  Enter a comma-separated list of custom user properties to exclude from the Forum’s profile page. For example, to suppress the Subscriptions field value, enter subscriptions.

• FilterXslt (String)

  Enter the path to an XSLT file used to filter forum content, such as, HTML Attributes, Tags and unwanted words in a user’s forum post. The path can be relative or absolute. The user’s post is filter when the user clicks Submit. By default, this property points to <webroot>/siteroot/Workarea/Xslt/ForumFilter.xslt. This file removes hrefs with javascript:, vbscript: and “on” events in the link. You can modify this file or create a new one.

  WARNING! If you want to edit this file, make a copy, change its name and move it outside of your Web site’s Workarea folder. If you make changes to this file and do not move it out of the Workarea folder, this file and the changes will be lost when you upgrade.

  For additional sample code used to create a filter XSLT, see the following KB article: http://dev.ektron.com/kb_article.aspx?id=485

• Hide (Boolean)

  Hides or displays the output of the control in design time and run time.

  • True—Hide the control output.
  • False—Display the control output.
• HideUserProfile (Boolean)

  Set to True to suppress user profiles. The default is True.

  • True—hides user profiles from non-administrator users.
    
  • False—displays user profiles from non-administrator users. However, an administrator can view a profile regardless of how this property is set.

  On the other hand, if the Private Profile is set to Private for any user, his profile information is not visible, regardless of this setting. If Private Profile is set to Colleagues, only colleagues can see profile information. When the profile is visible, only properties and their values not listed in the ExcludeList property (above) appear.

• JavascriptEditorHeight (Integer)

  Set the height in pixels for the eWebEdit400 content designer. The default is 400. The minimum height is 300.

• JavascriptEditorWidth (Integer)

  Set the width in pixels for the eWebEdit400 content designer. The default is 625. The minimum width is 500.

• Language (Integer)

  Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).

  Setting this property to -1 (negative one) causes the Forum server control to display topics from all available languages.

• ObjectType (String)

  Describes the type of forum displayed by this server control.

  • CommunityGroup—Used for forums inside a Community page.
  • DiscussionBoard—Used for forums on templates that are not Community pages.
• OrderBy (String)

  The order of search results. For example, you want to sort search results by last modified date.

  • Title—The content title (alphabetical).
  • ID—The content ID number.
  • Date Created—The date the content was created.
  • Date Modified—The date the content was most recently modified.
  • Editor—The user who last edited the content (alphabetical).
  • Rank—The rank assigned to the content.

  NOTE: The OrderDirection field determines the direction of the search results. For example, if you sort by ID and OrderDirection is set to Descending, the results sort by ContentID number with the highest number at the top of the list.

  WARNING! Specifying a CustomOrderBy property overrides this property.

• OrderDirection (String)

  The direction in which search results are sorted. The default is Ascending.

  • Ascending—Alphabetical results from A to Z; numeric values low to high; dates from oldest to most recent
  • Descending—Alphabetical results from Z to A; numeric values high to low; dates from most recent to oldest
• ProfileLink (ItemLinkTargets)

  Enter a link to the user’s social networking profile page, a part of Ektron’s community platform. This allows a user to click another user’s name link or avatar and be taken to the user’s profile page. The link has 2 variables that represent the user’s ID and display name.

  • {0}—user ID
  • {1}—user display name

  You need to have both variables in the link. The Web form can be relative or absolute. For example:

  userprofilepage.aspx?uid={0}&dn={1}

  The default for this property is ?g=profileu={0}.

  When the default for this property is used, users are forwarded to a user’s profile page that is included with the forum control.

• ProfileLinkTarget

  Determines the type of window that appears when you click a link in the server control.

  • _Self (default)—opens in same window.
  • _Top—opens in parent window.
  • _Blank—opens in new window.
  • _Parent—opens in the parent frame.
• ShowCategories (Boolean)

  If set to True, when this server control appears, the user see a Filter by Category option. This option helps a site visitor zero in on relevant content. If False, the Filter by Category option does not appear.

• SuppressWrapperTags (Boolean)

  Suppresses the output of the span/div tags around the control.

  • True—Suppress wrap tags.
  • False (default)—Allow wrap tags.
• TaxonomyCols (String)

  Use this property to determine the number of columns on the Taxonomy screen available from this discussion board. In the illustration below, taxonomy categories are arranged in 3 columns (the default value).

  

• TaxonomyMarkupLanguage (String)

  Identify the template markup file that controls the display of the server control. For example, mymarkup.ekml. If the EkML file is located in the same folder as the Web form containing the server control, just enter its name. Otherwise, the path to the file can be relative or absolute. See also: Controlling Output with Ektron Markup LanguageControlling Output with Ektron Markup Language

• Theme (String)

  Enter the custom theme’s folder name. The theme can be relative to the site root or located in the current folder. For example:

  • Relative—Theme=”/workarea/csslib/themes/winter”
  • Current Folder—Theme=”mytheme”

  If you do not specify a theme, the property uses the location defined by the discussion board’s CSS theme property in the Workarea. See Also: Using a Custom Theme

• WrapTag (String)

  Lets a developer specify a server control’s tag.

  • Span (default)—designate an inline portion of an HTML document as a span element.
  • Div—apply attributes to a block of code.
  • Custom—Lets you use a custom tag.

Updating the Page Command

To prevent an error from appearing when a user posts a reply to the Web page that hosts the Forum server control:

1. Open the Web form onto which you inserted the Forum server control.
2. Access Source view.
3. Go to the top line of the Web form, which begins with @ Page.

   <%@ PageLanguage="VB"AutoEventWireup="false" CodeFile="Default2.aspx.vb"Inherits="Default2" %>

4. Near the end of the line, enter validaterequest=false.
5. Build the page.

Using a Custom Theme

This property lets you specify a custom location for your themes. By doing so, you prevent them from being overwritten when you upgrade.

If you do not specify a theme in the server control, Ektron uses what is defined in the discussion board’s properties CSS Theme field located in the Workarea.

To create a custom theme:

1. Create a new subfolder on your site. In this example, we use a winter theme:

   <web root>/<your site>/Workarea/csslib/winter.

2. Copy all files in the /Workarea/Threadeddisc/themes folder to the winter folder.
3. Change the image files to match your theme. To find the name of an image:
   1. Right click on it while viewing it in a browser.
   2. Select Properties. The name appears at the top of the dialog box.
4. Change the discussion board’s .css file to match your theme and save it with a custom name. (You do not need to do this if an existing .css file meets your theme’s needs.)

   IMPORTANT: Make sure the CSS theme property in the Workarea is pointing to the proper CSS file.

5. View the discussion board in a browser to see the changes.

Adding and Removing Toolbar Items From the Editor

WARNING! You cannot create new buttons and add them to the Forum Editor. You can only add and remove existing buttons.

You can add and remove toolbar items on the Forum Editor by editing the EditorToolbar property. This property contains a series of string values that represent each item, listed below.

• StyleMenu—Display a list of paragraph styles. Users can select from the list to apply a style to selected text.
• FontMenu—Display a list of available font styles, sizes and colors.
• ParagraphMenu—Controls the display of buttons that affect a paragraph. This includes:
  • Numbered List
  • Bullet List
  • Outdent
  • Indent
  • Align Left
  • Align Center
  • Align Right
  • Justify
  • Horizontal Rule
• TextFormatMenu—Controls the display of buttons that format text. This includes:
  • Bold
  • Italics
  • Underline
• LinkMenu—Controls the display of buttons that allow a user to add and remove hyperlinks links and work with the library. This includes:
  • Hyperlink Manager
  • Remove Link
  • Library
• ClipBoardMenu—Controls the clip board buttons that allow a user to cut, copy and paste content. This item also controls the Undo and Redo buttons.
• SymbolsMenu—Controls the display of the Symbol button which allows users to insert symbols and special characters.
• EmoticonSelect—Controls the display of the Emoticon button.
• WMV—Controls the display of the Insert WMV button.
• Table—Controls the display of the Insert table button.

The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio^® help.

• Authenticated (Boolean)

  Indicates if you are logged into the CMS Explorer and can use it to browse to content, collections, and so on. See Also: Browsing Your Ektron Site Using CMS Explorer.

• BoardID (Long)

  The ID of the board from which to get entries. If you don’t know the ID, click Ellipses (), then sign in, browse to, and select a discussion board.

• CacheInterval (Double)

  The number of seconds that the server control’s data is cached. The default is 0 (zero). For example, if you want to cache the data for 5 minutes, set to 300. See Also: Caching with Server Controls.

• DisplayMode (eDisplayMode)

  Choose between Active or Recent. In Active mode, the server control displays a list of the most active posts. In Recent mode, the server control displays a list of recently added posts. The default is Active.

  • Active—display a list of the most active posts.
    
  • Recent—display a list of the recently added posts.
• DoInitFill (Boolean)

  By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.

• Hide (Boolean)

  Select False to display this server control on the page. Select True to suppress it.

• Language (Integer)

  Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).

• MaxNumber (Integer)

  The maximum number of topics listed. The default is 10.

• SuppressWrapperTags (Boolean)

  Suppresses the output of the span/div tags around the control.

  • True—Suppress wrap tags.
  • False (default)—Allow wrap tags.
• URLPath (String)

  Enter the path to the Forum server control’s Web page. For example: http://<your site>/siteroot/forum.aspx or /CMS400Developer/forum.aspx. If your Forum page and your Active Topics page are in the same folder, you can just enter the name of the page. For example: forum.aspx.

• WrapTag (String)

  Lets a developer specify a server control’s tag.

  • Span (default)—designate an inline portion of an HTML document as a span element.
  • Div—apply attributes to a block of code.
  • Custom—Lets you use a custom tag.

The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio^® help.

• Authenticated (Boolean)

  Indicates if you are logged in to the CMS Explorer and can use it to browse to Content, collections, and so on.

• BoardID (Long)

  The ID of the discussion board from which to get a user's posts. If you don’t know the ID, click Ellipses (), then sign in, browse to and select the discussion board.

• CacheInterval (Double)

  The number of seconds that the server control’s data is cached. The default is 0 (zero). For example, if you want to cache the data for 5 minutes, set to 300. See Also: Caching with Server Controls.

• DoInitFill (Boolean)

  By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.

• Hide (Boolean)

  Hides or displays the output of the control in design time and run time.

  • True—Hide the control output.
  • False—Display the control output.
• Language (Integer)

  Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).

• MaxNumber (Integer)

  The maximum number of posts listed. The default is 10.

• SuppressWrapperTags (Boolean)

  Suppresses the output of the span/div tags around the control.

  • True—Suppress wrap tags.
  • False (default)—Allow wrap tags.
• URLPath (String)

  The URL path to the page the where the Forum server control is located.

• UserID (Long)

  The ID of the user for whom to get the post history.

• WrapTag (String)

  Lets a developer specify a server control’s tag.

  • Span (default)—designate an inline portion of an HTML document as a span element.
  • Div—apply attributes to a block of code.
  • Custom—Lets you use a custom tag.