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.

publishweretail

By selecting the Administration link, the Moderation console appears:

moderation-console-publish

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.

NOTE
UGC from the Publish environment is only visible on Author if the chosen SRP implements a common store. For example, by default the storage is JSRP, which is not a common store for Author and Publish. See Community Content Storage.

moderationconsoleauthor

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:

toggleswitch

Filter rail
opens a rail on selecting Search, which allows a choice of properties on which to filter the content.

filterrail

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
NOTE
The content area features an infinite scroll, which means that it lets you continue scrolling until you have reached the end of the content. The toolbar remains in a fixed, visible position above the content area even while scrolling.

Filter Rail ootbfilters

open-filterrail

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.

NOTE
Community moderators can bookmark the pre-defined filters on moderation console UI. As these filters are appended toward the end of the URL (as query string parameters), moderators can get back to the bookmarked filters later and also share these links.

searchicon

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.

content-path

Text search limits the referenced UGC displayed to posts to which contain the text entered.

text-search

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.

site-panel

NOTE
When the bulk moderation console is accessed by an administrator, all references to UGC are shown, including sites not created with the site creation wizard, such as the Geometrixx samples.
When the bulk moderation console is accessed on Publish by a trusted community member, only references to UGC created for community sites the member is authorized to moderate are shown. Also, it may be filtered with the Site filter.

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

content-types

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

    additional-contenttype

  • 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.

NOTE
If only the Not Answered status is selected, then the moderator sees all the content (for all content types) except the answered questions. It is so because the property responsible for the Answered Question does not exist if there are not-answered questions and other content such as forum topic, blog article, or comments.

statuses

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.

flagging

Members members

Members limits the referenced UGC displayed to UGC posted by the member name entered.

members

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.

posted-last

Sentiment sentiment

Sentiment limits the referenced UGC displayed to posts with a sentiment value that is either positive, negative, or neutral.

sentiment

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.

custom-tag-filter

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:

  1. 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.
  2. Build the package com.adobe.social.sample.moderation.filter.ui.apps-1.0-SNAPSHOT.zip from GitHub code, and install and enable the same.
  3. 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.
  4. 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.
  5. 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.
  6. Add a technical user communities-utility-reader with jcr:read permissions.

To expose the custom filters on existing Community sites:

  1. 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.
  2. 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.
  3. 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.

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 ( selecticon ) 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:

select-icon

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.

bulkmoderate

Moderating a single post moderating-a-single-post

In single selection mode, it is possible to:

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

singleselectmode

Reply 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

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

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

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

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

moderation

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:

moderation-history

View Detail view-detail

view

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:

view1

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791