Ektron 9.00
Working with Discussion Boards
The discussion board feature provides topic discussions on your website. A site or membership user with Add Topic permission creates a topic and posts a starter question. Site visitors can then reply. Ektron supports an unlimited number of discussion boards. A discussion board consists of a hierarchy. The following example shows the hierarchy with sample data, to explain how each element is used.
On the website, if you click a discussion forum, you see its topics. If you click a topic, you see its posts.
In the Workarea, a discussion board appears as a top-level folder () in the folder structure. Forums appears under them. If you click a discussion board, its subjects and forums appear in the right panel.
To implement a discussion board into your website, place a Forum server controla server control uses API language to interact with the CMS and Framework UI to display the output. A server control can be dragged and dropped onto a Web form and then modified. on a Web page. Then, select a discussion board. All subjects and forums within that board appear on the Web page. You cannot selectively suppress subjects or forums. Keep this in mind when determining the contents of a discussion board.
To view a discussion board, select it from the Folders display. When viewing the board, you see all of its forums. You can click any forum to see its details.
An administrator determines the following discussion board features.
NOTE: Some items appear only when editing a discussion board’s properties.
br, hr, b, i, u, a, div, ol, ul, li, blockquote, img, span, p, em, strong, font, pre, h1, h2, h3, h4, h5, h6, address, embed
NOTE: Add the embed tag if you want users to insert WMV files into their posts.
bmp, conf, doc, gif, jpe, jpg, jpeg, png
Effect of this Field on the Website
Check this box if a site visitor must sign in to post to the discussion board. If the user cannot access a login screen, the user cannot post. If this box is unchecked, site visitors can post without signing in.
Effect of this Field within the Workarea
If this field is checked, only users with Add Topic or Edit Topic permissions for the discussion board can create or reply to posts. See Also: Modifying Permissions for a Discussion Board
siteroot/Workarea/threadeddisc/themes/standard.css
. Alternatively, enter a path below the site root folder to your custom CSS file in the path box. See Also: Working with Discussion BoardsNOTE: If you edit a CSS file, you should save it under a new name. This prevents your changes from being overwritten during an upgrade.
Effect of Assigning Taxonomy Categories to a Topic
When a discussion board server control is placed on a Web page, its display includes a small taxonomy icon (circled below).
When a site visitor clicks this icon, taxonomy categories are displayed. When the user selects a category, the user sees its subcategories followed by all forum posts assigned to that category. Below is an example of how a discussion board’s posts might be organized by taxonomy category.
NOTE: You can also add a subject by selecting a discussion board then selecting New > Subjects.
Subjects are sorted alphabetically unless you use the Sort Order field. The Sort Order field accepts a number and uses it to sort a discussion board's subjects. The lowest numbers appear near the top of the page.
To access the Sort Order field:
When you delete a discussion board, its subjects, forums, and posts are also deleted. When deleted, they cannot be retrieved.
Discussion boards have a permission table that lets you determine the functions a user can perform. (See Managing Folder and Content Permissions.) Because discussion boards have different functions than folders, the permission table is slightly different from regular folders.
In addition, each Forum has its own permission settings. By default, a forum inherits permissions from its parent discussion board, but you can break inheritance and customize permissions for a forum.
To access a discussion board’s permission table, navigate to and click the board so it appears in the Workarea. Then, click View > Permissions ().
NOTE: Only Administrators group members can access the discussion board Permission Table.
The following example shows a discussion board permission table for regular users. Membership users have fewer permissions.
When you create a discussion board, it gets it initial permissions from the parent folder but it then is disconnected from the parent folder’s permission table. Subsequent changes to the parent folder’s permissions have no effect on discussion board permissions.
The permission table has the following initial values from the parent folder (Parent Folder Permission—Discussion Board Permission):
NOTE: Because there are no corresponding permissions for the discussion board’s Moderate and Post/reply permissions, their initial value is blank.
For example, if user JSmith has permission to perform all functions for a folder, and a discussion board is created in that folder, JSmith initially receives the default permissions for the discussion board. You can modify these permissions.
The following table lists all permissions that you can grant to regular users. Only some permissions can be granted to membership usera user with limited privileges, such as writing to a community forum, but not having the same privileges as a forum moderator, or an administrator who has access to the Workarea. (A community user is the same as a membership user.)s.
Permission |
Allows user to |
Can be assigned to membership users |
Read only |
View forums and posts; cannot submit a post |
Yes |
Edit Topic |
Edit a topic’s title (Editing a Topic Title) |
No |
Add Topic |
Add new topics (Adding a Topic to a Forum) |
Yes |
Delete Topic |
Delete a topic (Deleting a Topic) |
No |
Post/Reply |
Post a new topic or reply to an existing one, either from the Workarea or the site. (Adding a Topic to a Forum and Replying to a Post) |
Yes |
Moderate |
Approve and delete posts and topics. Also, receive notifications when a post is reported using the report post feature; only applicable if the forum’s properties field Moderate Comments is checked. (Moderating from the Control Panel) NOTE: Everyone who has Moderate permission will receive notifications when a post is reported. See Also: Setting Up Post Reporting |
Yes |
Add Forum |
Create a new forum (Creating a Forum) |
No |
Edit Forum |
Edit a forum (Editing a Forum) |
No |
Delete Forum |
Delete a forum (Deleting a Forum) |
No |
By default, membership users are assigned the following permissions:
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.
After you remove a user, discussion boards do not appear in that user's Workarea.
You can change the number of topics or posts shown on a page by changing the ek_PageSize
value in the web.config
file.
A discussion board's Terms & Conditions convey your expectations to its users. If you add Terms & Conditions, anyone posting to the board sees the following screen the first time a post or reply is sent to a forum. Users can only post after agreeing to its Terms & Conditions.
To add terms and conditions text to a discussion board:
This sections show you how to create and edit subjects in a Discussion board.
A forum is a particular thread within a discussion board. For each forum, you define:
Prerequisite
At least one subject.
The Smart Desktop has a Forum Topics and Posts category. This tells you how many posts currently require your approval before they appear on the site.
A discussion board can also be locked. If a board is locked, a message on this screen indicates that. In that case, no posting is allowed to this forum regardless of this setting.
You can use the discussion board permission features with any forum. See Also: Modifying Permissions for a Discussion Board
When you first view a forum’s permission table, you see a check box that lets you maintain inheritance or break it. A forum initially inherits (that is, copies all permissions from) its parent discussion board’s permission settings.
To later restore inheritance, check the box. When you do, the parent discussion board’s permissions overwrite any forum-specific changes. The forum then reverts to a read-only state. While inheritance is enabled, you must make permission changes at the discussion board level.
If you are not using authentication for the forums and want to block a site visitor from posting to the forum, use the Restricted IP feature.
NOTE: In addition to using Restricted IPs for a specific forum, you can access the Restricted IP feature from the Workarea > Settings > Configuration > Discussion Board > Restricted IPs. If you have more than one forum, this lets you select the Discussion Boards to which the Restricted IPs are applied.
The User Ranking feature lets you recognize active forum contributors. You can create a ranking system that moves a contributor to the next level after submitting a specified number of posts. This is known as a ladder system, which lets forum contributors build credibility. For example:
To each rank, you can assign an image that appears below the user’s name on any post. The rank also appears on a user’s forum profile.
You can also create ranks that are independent of the ladder system. Such ranks have no relationship to a contributor's number of posts. For example, after a forum user acquires Ektron Developer Certification, the user is assigned the Ektron Developer rank.
You can move contributors from a non-ladder rank to the ladder system and vice versa. Whether or not a contributor is in a ladder system, Ektron keeps a tally of posts. So, if the user is moved into a ladder system at any time, he is assigned the correct 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.
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 the person's rank—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:
The discussion board’s Email Notification feature generates email for registered users when certain forum activities occur. For example, you register to be notified when a new forum post is created. When that event occurs, registered users receive an email with a link to the new post. After the messages are set up, you don’t need to do anything—everything happens in the background.
You can create an email message to be sent when these discussion board events occur.
A simple editor lets you apply some XHTML formatting the message. To create a message:
Message text can include variables that retrieve information about the new post or topic. 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.
Use the following variables in discussion board email notifications.
A topic is a specific issue to be discussed in a forum. For example, in a medical research forum, a topic might be New Cancer Treatments. Before creating a topic, you must create a forum into which to place it. To view a topic from the Workarea:
If an option is underlined, you may perform it; if not, you cannot. For example, if a post’s status is approved, approve is not underlined because it is already approved.
When you create a new topic, its first post is created from the topic message. If you add a topic but are not a forum moderator, you only see the topic in the Workarea after it is approved.
NOTE: You also can create new topics from the OnTrek user interface (Support > Support Forums).
To create a topic:
Announcement—topic always appears at the top of the list. If a list has more than one announcement, they are sorted by date with most recent on the top. The Announcement icon () indicates its priority to the left of the title.
Sticky—topic appears near the top of the list, just below the announcements. If a list has more than one sticky topic, they are sorted by date with most recent on the top. The Sticky icon () indicates its priority to the left of the title.
Normal—Topics with this priority follow Announcements and Sticky topics. The Normal icon () next to the topic indicates its priority.
The only part of a topic you can edit is its title.
A topic needs approval if is created by a user without moderate permissions for the forum. An unapproved topic is surrounded by a yellow border in the Workarea, and must be approved before it appears on the website.
To approve a topic:
In a forum, topics are sorted by priority. You can set a topic’s priority when you create it. A forum moderator can change a topic’s priority. To set a topic property:
Locking a topic prevents users from posting a reply to it. For example, you might create an announcement, but don’t want people to reply to it. Or, you might decide that a topic has had enough discussion and want to stop further replies. If a topic is locked, only Administrator user group members can post to it, or edit or delete posts from the website or the Workarea. To lock a topic:
When you delete a topic, its posts are deleted, too. When deleted, they cannot be retrieved.
When a new topic is created, the first post is created from the topic's message. Posts to a topic are replies to the first post. You can search posts by clicking Search.
You can edit the text of a post but you cannot edit its title.
Quoting a post means that your reply begins with the original post. You can then add comments and even edit the quoted post. For example, you can include only the portion on which you are commenting. To quote a post:
Add your comments below the quote.
You can add an attachment to a post. The Attached Files field lists allowed file types. The list of file extensions and maximum file upload size are defined for the discussion board.
<object width="425" height="350"> <param name="movie" value="http://www.youtube.com/v/8K_NQe57C-k"></param> <param name="wmode" value="transparent"></param> <embed src="http://www.youtube.com/v/8K_NQe57C-k" type="application/x-shockwave-flash" wmode="transparent" width="425" height="350"></embed> </object>
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.
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.
If you want the Replace Words feature to modify words that contain a word you to replace, 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.
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.
IMPORTANT: This topic applies to the eWebEdit400 editor only.
An emoticonan icon that is used to express an emotion in text communication. 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.
siteroot\Workarea\threadeddisc\emoticons
folder. Users with forum moderate permissions can do so from the Control Panel by clicking the Moderate link.
Prerequisite
Only users who are assigned the Moderate permission may approve a post.
When defining a forum, you can check the Moderate Comments field. If you do, forum posts must be approved before they appear on the website. There are 2 ways to approve a post in the Workarea.
You can let site visitors report inappropriate posts, such as spam or offensive posts.
When you set up forum post reporting, you add a Report Post button to the bottom of each post to let site visitors report posts. When a site visitor clicks Report Post, an email notification is sent to all forum moderators. Any moderator can review the post and decide to edit, delete, or leave it alone.
NOTE: Your Ektron Web server must be set up to send emails. See Installing Ektron.
To edit the report post message, go to the Workarea and choose Settings > Configuration > Discussion Boards > Messages and select ReportForumPost.
This section explains how to manage a discussion board on your site.
The Control Panel lets logged in users view your profile, read, reply to, and delete private messages. It also lets users with moderate permissions moderate the forum. The Control Panel button is located at the forum level.
The Inbox view appears by default. From it, you can...
IMPORTANT: When replying to a private message, you add your response to the existing message. Only one message is created.
A topic needs to be approved when a user who does not have moderate permission for the forum adds a topic. When you view topics on the site, those that need approval have a different background color.
From this screen, you can click Approve next to the topic’s title. You could also click the topic’s title to view it and click Approve on that screen.
On the first click, items are sorted first by numeric (1-10) values, then by alpha values (A to Z). Click a column title a second time to sort the items in reverse. When first viewed, the list is sorted by Last Post date and time.
Prerequisite
Topics can be deleted from a forum by the users who created them or by users with the Moderate permission. This includes Membership users.
WARNING! When you delete a topic, its replies and posts are also deleted.
Anyone browsing a discussion forum can view contributor information by clicking the user name. However, if the forum server control’s HideUserProfile
property is true
, non-administrator users cannot see the profile, even if the Private Profile setting is set to Public. Administrators can see the profile, regardless of how the HideUserProfile
property is set. The profile contains the following user information.
Users can determine if their profile is viewable via the Private Profile drop-down box on the Membership Registration screen and the Edit Profile screen. The Membership Registration screen appears wherever your developer inserts the Membership Server Control. If Private Profile is set to Private, profile information is suppressed. If it is set to Colleagues, only a user’s colleagues can see the person's profile. When set to public, everyone can see a user’s profile information.
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.
If you want to suppress the display of user names as an administrator:
If the user is a membership user, go to Settings > Community Management > Memberships > Users and select the user whose information you want to suppress.
NOTE: If the forum server control’s HideUserProfile
property is set to true
, non-administrator forum visitors cannot see the profile, even if the Private Profile check box is unchecked.
You can output a forum as an RSS feed by clicking the RSS feed button (). Each level of the forum has an RSS feed button. This lets you output a specific topic as an RSS feed.
<?xml version="1.0" encoding="UTF-8" ?> - <rss version="2.0"> <!-- Generated by Ektron --> - <channel> <title>Ektron Medical Center Forum</title> <link>http://test/webform.aspx</link> <description>Ektron Medical</description> - <item> <title>Research</title> <link>http://test/webform.aspx?g=topics&f=108</link> - <description> <![CDATA[ Latest medical research ]]> </description> <pubdate>Mon, 7 Feb 2012 09:56:00 GMT</pubdate> </item> </channel> </rss>
After clicking the button, the following screen appears.
To review forum subscriptions, go to the Control Panel and click Notifications in the lower left corner. A screen indicates each discussion board level to which you have subscribed.
To delete a subscription, check the corresponding box and click Delete.
Logged-in users can send a private message to the person who created a post or reply. Only the sender and receiver can view private messages. This requires both users to be either an Ektron user or a Membership user.
A Community Group can have its own discussion board. This provides a forum for community-based discussions that are limited to forum members. All discussion board features are available to a forum in a community group. The image below shows a discussion forum on a community group page.
To use a group discussion board, first add the group discussion forum to the database. Each group needs to do this one time when they decide to host a discussion forum for their group. To add a group discussion forum database:
To view and update the file types that may be uploaded to a Community Group:
Ektron provides 3 server controls for use with discussion boards.
After creating at least one hierarchy of discussion board elements, place a Forum server control on a Web page. If you want to require site visitors to authenticate, the Web page that hosts the forum should also contain:
NOTE: You should add text below the Login server control to remind the site visitor to enter the person's email address at the User field. For example, “At the User field, enter your email address.”