Edit configuration property settings in the contentreview-config.xml
file to enable moderation and to specify what moderators should receive email notification when content requires moderation. Restart your applications to see the changes.
Before you begin
To edit configuration files, you must use the wsadmin client. See Starting the wsadmin client
Connections using scripts accessed with the wsadmin client. These scripts use the connectionsConfig object available in WebSphere
® Application Server wsadmin client to interact with the IBM
Connections configuration file, which is named contentreview-config.xml
The properties in the contentreview-config.xml
file cannot be edited using the updateConfig command nor displayed using the showConfig command. Instead, you must check out the configuration file using the checkOutContentConfig command, and then edit the property values by opening the checked out property file from the temporary directory using a text editor. After editing the property file, save the file in Unicode format and check the file back in using the checkInContentConfig command and restart the application servers to see the changes.
About this task
If moderation is enabled, moderators can review and approve blog comments and entries, forum posts, and community files from a central location. You can configure who has the right to review and approve content with a setting in the contentreview-config.xml file as follows:
- If ownerModerate=true in contentreview-config.xml, a blog, forum, or community owner can moderate content for a blog, forum, or community they own. In addition, content an owner creates is published directly, without requiring moderation.
- If ownerModerate=false in contentreview-config.xml, only users assigned the J2EE moderator role in the WAS console can manage content on the site. For information on assigning users to the moderator role, see the topic Roles.
You can also configure the flag inappropriate content application for Blogs and Forums to specify categories for what type of content to flag, and to specify designated reviewers who will receive email notifications when content is flagged. There are two default categories for inappropriate content: Legal issue
and Human resources issue
. You can edit those categories, add new ones, or remove all categories. The file is also configured with placeholders for the email addresses of designated reviewers. Change those to actual email addresses for users assigned the moderator role who can review flagged content.
When you enable moderation, users cannot upload thumbnail images in Media Gallery widgets.
To change moderation configuration settings, complete the following steps:
Parent topic: Moderation overview
Optional post-installation tasks
Moderating blog content
Moderated content states for blogs
Moderating the content in a community
Moderating blogs programmatically
Moderating community files and comments programmatically
Moderating forum content programmatically
Starting the wsadmin client
Specifying an administrator email address for Blogs notifications
Managing flagged content for a blog
Moderating Blog comments
Retrieving the Blogs moderation service document
Retrieving the Forums moderation service document
Retrieving the Files moderation service document
- Start the wsadmin client from the following directory of the system on which you installed the deployment manager:
is the WebSphere Application Server installation directory and <dm_profile_root>
is the Deployment Manager profile directory, typically dmgr01. For example, on Windows:
You must run the following command to start the wsadmin client from this specific directory because the Jython files for the product are stored here. If you try to start the client from a different directory, then the execfile() command that you subsequently call to initialize the administration environment for an IBM
Connections component does not work correctly. See the topic Starting the wsadmin client
- Use the wsadmin client to access and check out the IBM Connections configuration file:
- Access the IBM Connections configuration file using the following command:
If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, you must pick the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.
- Check out the IBM Connections content configuration file using the following command:
- <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.
- <cell_name> is the name of the WebSphere Application Server cell hosting the IBM Connections application. This argument is case-sensitive, so type it with care. If you do not know the cell name, type the following command while in the wsadmin command processor:
- Microsoft Windows:
- From the temporary directory to which you just checked out the IBM Connections configuration files, open the contentreview-config.xml file in a Unicode text editor.
Note: Editing the file using a standard text editor that does not support Unicode could corrupt the file.
- To configure settings for managing content in the pre-moderated state, that is, before it is published or when it is updated, set the following options for each application:
Set to "true" to require moderation for the specified application. By default this is set to "false". When the setting is set to false, moderation is not automatically enforced for an application, but moderation API command and filters still work. Moderators can still perform moderation tasks.ownerModerate
Set to "true" to specify that blog owners and community owners can moderate content in blogs or communities they own. By default this is set to "false" so that only users assigned the J2EE moderator role in the WAS console can moderate content. For information on assigning users to the moderator role, see the topic Roles.
In the following example, moderation is enforced for blogs so that all content must be approved by a moderator before it is published or updated in a blog. Each blog owner can moderate content for the blogs they own.
<ownerModerate enabled="true" />
- To configure settings for managing content in the post-moderated state, that is, content that is flagged by a user after it is published. set the following options for each application:
Set to "true" to require moderation for flagged content. By default this is set to "false". When the setting is set to false, this means the end user can't flag content from the user interface or using an API command. Blogs Moderation API and filters will still work. Moderators can still perform moderation tasks. Files and Forums API commands will return errors.ownerModerate
Note: If you upgraded IBM Connections from release 2.5 to release 3.0 or higher, the default for Blogs will be "true" for compatibility reasons.
Set to "true" to specify that forum users can moderate their own flagged content. By default this is set to "false" so that only users assigned the J2EE moderator role in the WAS console can moderate. For information on assigning users to the moderator role, see the topic Roles.IssueCategorization
Set to "true" to display a list of categories so that users can choose one when flagging content. By default this is set to "false."automaticQuarantine
Note: This feature is not available for Files.
Forums only. Set to "true" and specify an integer as a value for threshold. When a forum post is flagged the number of times specified for the threshold value, the post is automatically quarantined and removed from the forum. By default this is set to "false."flagCategory
To make a <flagCategory> element available for an application, first define it with a unique id and descriptions in the desired languages to the <flaggedCategories> section of the configuration file, then add it to the <IssueCategorization> section for the application.reviewer email
To add designated reviewers who will receive notification email when content is flagged, replace the placeholder email names for each category with the email addresses of designated reviewers who are assigned the moderator role.
In the following example, flagging is enabled for forums and each forum owner can moderate flagged content for the forums they own. Issue categorization is enabled so that users can select a category when flagging content. If ten users flag a forum post, it is automatically quarantined and removed from the forum.
<ownerModerate enabled="true" />
<ownerModerate enabled="true" />
<automaticQuarantine enabled="true" threshold="10" />
<reviewer email="email@example.com" />
<reviewer email="firstname.lastname@example.org" />
<reviewer email="email@example.com" />
<reviewer email="firstname.lastname@example.org" />
- To add a category for flagged content, add a new <flagCategory> element with a unique id and descriptions in the desired languages to the <flaggedCategories> section of the configuration file.
The fastest way to add a content category is to copy an existing <flagCategory> element, paste it into the file and edit the ID and descriptions in the required languages.
For example, to add a content category for "Offensive Language" add the following:
<description xml:lang="en">Offensive Language</description>
<description xml:lang="fr">French equivalent</description>
<description xml:lang="it">Italian equivalent</description>
Note that the new ID is “003”. This must be unique. As this example shows, you can also add language statements and provide translated strings for category names.
- To specify who should receive email notification of content awaiting moderation or flagged content that needs review, replace the placeholder email names in the following section with the email addresses of users assigned the moderator role for that service.
<moderator email="email@example.com" />
<moderator email="firstname.lastname@example.org" />
- Save your changes to the contentreview-config.xml file.
- Check the file back in, using the command:
During the check-in process validation is done to ensure no xml syntax errors are in the file.
- Restart the affected applications to see the changes.