Module name:
discussion
The Discussion Gear lets users participate in threaded online discussions with other users in the community. Registered users can create discussion boards as well as read, reply to, and post messages. Portal Administrators and Community Leaders can moderate these forums and edit the discussion boards as necessary.
Instance Configuration
To configure an instance of the Discussion Gear:
Enter the Community Administration and click the configure link for the gear instance.
In the configuration basics page, enter a gear name and description. Select sharing and Make visible to options and click Done.
Click the additional configurations link. The additional configurations page has five subpages, select/administer forums, Display Attributes, access controls, alerts, and resource bundle.
select/administer forums: Create and delete discussion boards, and to make discussions from other communities available in this instance of the Discussion Gear. To create a new discussion board, click the create new forum link. Enter a name for the new discussion board. Select private to make the discussion board available only to members of this community. Select public to allow other communities to view the discussion board in shared instances of the Discussion Gear.
Display Attributes: Set the number of forums and posts and the length of texts that appear in the shared and full views of the gear.
access controls: Specify which classes of users can post to the discussion boards in this gear instance.
alerts: You can configure whether alerts are generated by the gear instance.
resource bundle: You can change the resource bundle for this gear. You should not need to change the resource bundle unless this gear instance is intended for a language other than English.
Discussion Gear messageThread Cache
The Discussion Gear maintains forums in a SQL repository. If the messageThread
item cache in the repository is too small, the Discussion Gear’s performance will not scale as the size of the forum or threads increase. The item cache must be large enough to hold a list of all threads in the forum, and it must be large enough to hold a list of all replies to a thread in the forum. The default size of the item cache is 1000. The appropriate size for your site depends heavily on the amount of activity in a forum.
Set the item cache in the definition of the messageThread
item descriptor in the Discussion Gear repository definition file. Set the item-cache-size
attribute by including a file like this in your CONFIGPATH at /atg/portal/gear/discussion/discussionRepository.xml
:
<gsa-template> <item-descriptor name="messageThread" item-cache-size="50000"> </item-descriptor> </gsa-template>