Forum Moderation

Moderate forum entries, such as discussions, reviews, and comments.

Table of Contents

  1. What is moderation and how does it work?
  2. What types of activities can be moderated?
  3. Who can moderate?
  4. How do I turn on moderation in the platform?
  5. What functions are available for moderating a forum?
  6. How do I moderate a forum?
  7. How do I enable markdown for forum entries?
  8. How does the use of markdown affect forum moderation?

What is moderation and how does it work?

Certain resources on the platform, such as apps, APIs, and groups, have their own Board. All platform users who have visibility of the resource can see the Board.

The Board includes items such as discussions, reviews, and team invitations.

The platform has settings that allow the Site Admin to control whether discussions, reviews, and comments are automatically published when written, or must be moderated. If moderation is specified, when a user adds one of those items it is in an Unpublished state until reviewed. At that point, it is visible only to the author and to users with the right to approve the Board item.

The Moderator can publish, reject, or delete the item.

Once it is published, the Moderator can unpublish an item or can delete it.

With reviews, the author can modify the review. In this scenario, the original review remains published while the revised review is going through the approval process. Once the revised review is approved, the original review is deleted. The new review has a marks count of 0.

For information about who can moderate and how it is done, see Who can moderate? and How do I turn on moderation in the platform?

Back to top

What types of activities can I moderate?

You can moderate the following activities in the platform, if they are set up to be moderated:

For information about how moderation is done, see Who can moderate? and How do I turn on moderation in the platform?

Back to top

Who can moderate?

Users with the following roles can moderate forums:

Back to top

How do I turn on moderation in the platform?

By default, discussions, reviews, and comments are auto-published. Moderation is not required.

Moderation can be turned on by the Site Admin via the Settings pages. Each type of resource that allows moderation has a Publishing field that is set to one of two values:

To turn on moderation for a specific type of resource in the platform:
  1. Log in as the Business Admin, Site Admin, or API Admin, and click the Administration quick filter (wrench icon).
  2. Click Forum.
  3. Choose the applicable settings page, find the Publishing field, and choose Auto-Published or Approval Required as explained above. This field is available on the following pages:
    • Comments
    • Discussions
    • Reviews
  4. For more information on the settings for these resources, refer to the applicable topic in Configuration.
  5. Choose to save or open the export file.

Back to top

What functions are available for moderating a forum?

When you log in to the platform and have rights to moderate a forum, you can click the Administration quick filter (wrench icon) > Forum to access the Forum.

Use the fields at the top of the page to narrow down the items you want to moderate. When you make a choice, the list refreshes automatically.

Depending on the current state of the forum entry, and the type of forum entry, you might have different actions available. Available choices are shown below.

For this type of resource... In this state... You can perform these actions...
Discussion Published Unpublish, Delete
Discussion Unpublished Approve, Reject, Delete
Review Published Unpublish, Delete
Review Unpublished Approve, Reject, Delete
Contract Request

Published or Unpublished

(Click Show Comments to view published or unpublished comments)

Delete comments
Group Membership Request Published Resend
Ticket (Published or Unpublished) Open Resolve, Close
  Resolved Close, Re-open
  Closed Re-open

Back to top

How do I moderate a forum?

If you have rights to moderate a forum you will see the Administration icon (wrench icon) in the top menu bar.

To moderate a forum:
  1. Log in as the Business Admin, Site Admin, or API Admin, and click the Administration quick filter (wrench icon).
  2. Click Forum.
  3. If needed, choose from the controls at the top of the page to narrow down the forum entries displayed. See What functions are available for moderating a forum?
  4. Review the content as needed, and click available buttons to approve or reject the forum entries.

Back to top

How do I enable markdown for forum entries?

The platform supports the use of markdown to add rich text formatting, inline images, and downloadable files in user-generated board entries.

If enabled, markdown is supported for discussions, tickets, alerts, reviews, and comments.

Markdown is enabled for each type of resource separately—so, for example, it might be enabled for discussions but not for comments.

The Site Admin controls this feature in the site settings. For more information, see How do I enable markdown for board items? (Site Admin only).

For more information on using markdown, see Using Markdown.

Back to top

How does the use of markdown affect forum moderation?

If you're moderating a forum, and some or all of the forum entries use markdown, you'll see the markdown formatting and possibly inline images, links, and/or URLs. You'll also see the Source and View tabs.

By default, forum entries that include markdown are displayed in View mode, so that you can see how the discussion, ticket, alert, review, or comment will appear to users once it's published. You can click to the Source tab to see the forum entry in plain text, including the markdown and the link/file coding.

If one or more files were uploaded as part of the markdown, you also have the option to download each file.

You can't change the markdown, and the actions you can take with each forum entry are the same regardless of whether the forum entry uses markdown or not.

For more information on the use of markdown, inline images, links, and URLs in forum entries, see Using Markdown.

Back to top