Moderation Console moderation-console
In AEM Communities, bulk moderation of community content is possible from both the Author and Publish environments by administrators and community moderators (trusted community members assigned as moderators).
Administrators and community moderators may also perform in-context moderation in the Publish environment.
A feature of all community sites is an Administration
menu item available to users who sign in with administrative privileges. The Administration
link provides access to the Moderation console.
From the Moderation console, administrators and community moderators have access to all user-generated content (UGC) for which they have permission to moderate. If permitted to moderate multiple sites, it is possible to view posts across all sites or filter by selected communities sites.
For more detailed information visit Managing Users and User Groups.
The Moderation console supports:
- Performing moderation tasks in bulk.
- Searching UGC.
- Viewing UGC details.
- Viewing UGC author details.
Only when signed in as an administrator, or a member with [moderator permissions](https://experienceleague.adobe.com/docs/experience-manager-65/communities/administer/in-context.html?lang=en#identifyingtrustedmembers)
, may moderation tasks be performed.
Publish Environment Access publish-environment-access
Access to the Moderation console from a published community site is through an Administration link which appears when a community moderator is signed in.
By selecting the Administration link, the Moderation console appears:
Author Environment Access author-environment-access
In the author environment, to reach the Moderation console
- From global navigation, select Communities > Moderation.
Only when signed in as an administrator, or as a member with moderator permissions, moderation tasks can be performed. The only community content displayed is that which the signed in member is permitted to moderate.
Moderation Console UI moderation-console-ui
Setting aside the left navigation rail (which appears on author, but not on Publish), the moderation UI has following main areas:
Top Navigation Bar top-navigation-bar
The top navigation bar is constant for all consoles. For more information, see Basic Handling.
Toolbar toolbar
The toolbar, located beneath the top navigation bar, provides the following toggle switch on the left side:
- Filter rail
opens a rail which allows a choice of properties on which to filter the content.
The toolbar, located beneath the top navigation bar, provides the following toggle switch on the left side:
Filter rail
opens a rail on selecting Search, which allows a choice of properties on which to filter the content.
Content Area content-area
The content area contains information for posted UGC:
- UGC posted
- Member name
- Member avatar
- Location of the post
- When it was posted
- Number of replies to the post
- Sentiment associated with the post
- If approved, a checkmark is displayed
- If there is an attachment, a paperclip is displayed
Filter Rail ootbfilters
The side-panel icon opens the filter rail. The filter rail, which appears to the left of the content area, provides different filters, each having an immediate effect on the referenced UGC that appears in the content area.
The filters within each category are OR’d together, and the filters in different categories are AND’d together.
For example, if you check both Question and Answer, you see content that is either a Question or an Answer.
However, if you check Question and Pending, you only see content that is a Question and is Pending.
When the filter rail is open, the Search icon toggles the side-panel closed. However to close the filter rail and only view the user-generated content, click the Search icon, and select the Content Only option.
Content Path content-path
Content Path limits the reference UGC displayed to the posts placed in specified content repository.
Text search text-search
Text search limits the referenced UGC displayed to posts to which contain the text entered.
Site site
Site limits the referenced UGC displayed to posts to selected community sites. If no sites are checked, then all references to UGC are displayed.
Content Type content-type
Content Type limits the referenced UGC displayed to posts of the selected resource type. One or more of the following types may be selected. All types are shown if none selected.
- Comment
- Forum Topic
- Forum Reply
- QnA Question
- QnA Answer
- Blog Article
- Blog Comment
- Calendar Event
- Calendar Comment
- File Library Folder
- File Library Document
- Idea
- Ideation Comment
Additional Content Types additional-content-types
To add additional resources on which to filter:
-
Log in to your author instance as administrator.
-
Open Web Console.
-
Locate
AEM Communities Moderation Dashboard Filters
. -
Select the configuration so you can open in edit mode.
-
Enter the ResourceType of a component on which to filter:
-
For example, to filter on included Voting components, enter:
Voting=social/tally/components/hbs/voting
-
-
Select Save.
-
Refresh the Communities - Moderation console.
The result is a new selectable filter for Voting
under the Content Type
filter group.
When that filter is selected, the content of the dashboard shows UGC that matches any of the ResourceTypes entered.
Status status
Status limits the referenced UGC displayed to posts of the selected status, which may be one or more of Pending, Approved, Denied, or Closed, and Draft or Scheduled for Blog Articles, and Answered or Not Answered for QnA Questions. If none is selected, then all are shown.
Flagging flagging
Flagging limits the referenced UGC displayed to posts which are flagged or hidden.
Once a piece of content is flagged, it remains flagged until you unflag that single piece of content by selecting the Flag button once again. There are no flagging levels, such as important or follow up.
Members members
Members limits the referenced UGC displayed to UGC posted by the member name entered.
Posted in the last posted-in-the-last
Posted In The Last limits the referenced UGC displayed to posts made in the last hour, day, week, month, or year.
Sentiment sentiment
Sentiment limits the referenced UGC displayed to posts with a sentiment value that is either positive, negative, or neutral.
Custom Filters custom-filters
Apart from the out of the box filters in Filter Rail, additional custom filters on metadata can be added to moderation UI. Developers can use the sample code in GitHub to extend the existing moderation UI filters.
The sample project on GitHub implements Tag filter, to filter the UGC list based on whether the specific tags are applied on user-generated content. You can follow the sample code and build analogous filters for other similar UGC metadata fields.
To install the sample for the Tags filter:
- Open the Package Manager on AEM Author (
https://[aem-author]:4502/crx/packmgr/index.jsp
) instance and AEM Publish (https://[aem-publish]:4503/crx/packmgr/index.jsp
) instance. - Build the package
com.adobe.social.sample.moderation.filter.ui.apps-1.0-SNAPSHOT.zip
from GitHub code, and install and enable the same. - Open the bundles console on AEM Author (
https://[aem-author]:4502/system/console/bundles
) instance and AEM Publish (https://[aem-publish]:4503/system/console/bundles
) instance. - Build the package (
[com](https://sample-moderation-filter.com/).adobe.social.sample.moderation.filter.core-1.0-SNAPSHOT.jar
) from GitHub, and install and enable the same. - Go to /apps/social/moderation/facets node on AEM Author (
https://[aem-author]:4502/crx/de/index.jsp#/apps/social/moderation/facets
) and AEM Publish (https://[aem-publish]:4502/crx/de/index.jsp#/apps/social/moderation/facets
) instance. - Add a technical user communities-utility-reader with
jcr:read
permissions.
To expose the custom filters on existing Community sites:
-
Edit
Clientlibs
of existing moderation page/content/we-retail/us/en/community/moderation/shell3/jcr:content/head/clientlibs.
- Add new category
cq.social.hbs.moderation.v2.
- Add new category
-
Go to
/content/we-retail/us/en/community/moderation/shell3/jcr:content/rails/searchWell/items/filters.
- Set to new component
sling:resourceType = social/moderation/v2/filters.
- Set to new component
-
Go to
/content/we-retail/us/en/community/moderation/shell3/jcr:content/views/content/items/modcontainer
.- Set to new component
sling:resourceType = social/moderation/v2/modcontainer
.
- Set to new component
Moderation Actions moderation-actions
Moderation actions can be performed on one or more selections made in the content area or when viewing content detail.
To bulk-moderate the posts, in the content area click the Select ( ) icon on a post, which appears on hovering over it with the mouse (desktop) or pressing and holding a finger on the post (mobile). By doing this, you enter the multi-select mode and can now select the subsequent posts to be bulk moderated by simply clicking them. Use the buttons displayed on the toolbar so you can perform moderation actions on the selected posts. All the actions prompt for confirmation.
To moderate a single post in the content area, hover over it with the mouse (desktop) or press and hold a finger on the post (mobile) such that buttons appear on the post. When operating on a single content detail, only a delete action prompts for confirmation.
Moderating multiple posts moderating-multiple-posts
Enter the bulk selection mode by clicking the Select
icon on a post:
To exit the bulk selection mode, select the cancel (x) icon on the toolbar:
The moderation actions that can be performed on multiple posts are:
- Deny
- Delete
- Close/Reopen the posts
The icons allowing these actions only appear on the toolbar when multiple posts are selected.
Moderating a single post moderating-a-single-post
In single selection mode, it is possible to:
- View user details by selecting the user’s name.
- View the post in-context by selecting the link to the post.
- Reply
- Allow
- Deny
- Delete
- Close
- View Moderation History
- View Details
Present on the card view above the moderation action icons is the text of the post and below is data indicating:
- If it has replies, and if so, preceded by the number of replies
- If it has been flagged
- If it has been approved
- When the UGC was posted
Reply reply
When working with a single post, a Reply icon appears if the UGC type supports replies and is configured to allow replies.
Allow allow
When working with a single post, the Allow icon appears when the post has been either flagged or denied. If flagged, selecting Allow clears all flags.
Deny deny
The Deny moderation action is only available for content that is moderated, and does not appear on unmoderated content except in multi-selection mode.
Content that is not moderated is always approved.
Content that is moderated initially enters a Pending state, and can be modified later for approval or denial.
Content that leaves the pending state can never return to a pending state. Content that is marked as approved or denied can be changed to a different state at any time.
Delete delete
In single selection or bulk mode, you can select items and delete them. The delete action results in a confirmation dialog. Once deleted, those items immediately disappear from the content area. Once UGC is deleted, it is permanently removed from the repository and cannot later be retrieved.
Close close
When working with a single post, a Close icon appears if the UGC type supports the ability to prevent further posts for that resource.
Moderation History moderation-history
When working with a single post, a Moderation History icon appears when hovering over it. Selecting the icon displays a pane containing a history of actions taken regarding the UGC post.
To return to the content area display of multiple UGC posts, select the X in the top-right corner of the view detail pane.
For example:
View Detail view-detail
When working with a single post, more details can be viewed by opening up the UGC in detail mode.
To do so, hover over the post to display the View Detail
icon and select it to display a panel containing more details of the post.
To return to the content area display of multiple UGC posts, select the X in the top-right corner of the view detail pane.
For example: