Comments moderation

Enable Comments Moderation

  • Login to the site as a Portal Admin

  • Navigate to Dashboard > Site Administration > Comments Moderation

  • Click on Enable Comment Moderation button

  • After enabling comment moderation, navigate to Dashboard > Site Administration > Content. The Comments tab will be visible

  • Click on the Comments tab. It will contain both approved and unapproved comments

How to add a comment for an API ?

  • Login to the site as a Portal Consumer

  • Navigate to Home > APIs and Products > API Discovery

  • Click on the API for which the user wants to comment

  • Click on Ratings and Comments in the API Page

  • Click on Add Rating/Comments

  • A modal box opens with a form where the user can comment and rate the API

  • The user is not allowed to save if either the comment or rating are not added

  • The comments do not get published until the portal administrator approves the comments.

  • Once approved the comments appear in the Ratings and comments section in the API.

  • Also an average rating of all the ratings on the API is displayed.

    As a Portal Admin:

  • The user will be able to view a list of all comments on the portal

  • The comments added by the portal Admin does not need approval and are added directly in the API in Comments and Ratings and also in Approved Comments list

  • Navigate to Home > API Administration > Content

  • Click on the comments tab

  • Two tabs appear

    • Approved comments

    • Unapproved comments

  • Approved comments are the comments already approved on the portal

  • The portal administrator can reject the comments. This will delete the comments

  • Unapproved comments are the comments NOT approved by the portal administrator.

  • Once approved, the comments appear in the Approved Comments list and also in the portal.

  • The portal administrator can reject the comments. This will delete the comments.

    As a Partner Admin

    If Partner Sign Up Configuration is enabled and there are enabled partners on the site and a user is added as a Partner Admin.

  • The comments added by the partner Admin does not need approval for APIs which were imported by him/her. The comments are added directly in the API in Comments and Ratings and also in Approved Comments list.

  • However, if the Partner adds a comment for the APIs not imported by him/her, it would need approval from a Portal Admin or other Partner Admins depending on who added the API.

  • The user will be able to view a list of all comments for the APIs which were imported by the Partner Admin for the Partner.

  • Navigate to Home > API Administration > APIs

  • Click on Comments tab

    A Partner Admin can approve/reject comments like a Portal Admin. Refer to the section - As a Portal Admin.

How to add a comment for a Product ?

  • Login to the site as a Portal Consumer

  • Navigate to Home > APIs and Products > Products

  • Click on the Product for which the user wants to comment

  • Click on Ratings and Comments in the Product Page

  • Click on Add Rating/Comments

  • A modal box opens with a form where the user can comment and rate the API

  • The user is not allowed to save if either the comment or rating are not added

  • The comments do not get published until the portal administrator approves the comments.

  • Once approved the comments appear in the Ratings and comments section in the Product.

  • Also an average rating of all the ratings on the Product is displayed.

Unapproved Comments

  • Login to the site as a Portal Consumer

  • Navigate to Dashboard > APIs and Products > API Discovery. Select any API, then click on the "Ratings and Comments" tab

  • Click on the "Add Ratings/Comments" link and enter your comment in the popup. After saving, a message will be displayed saying "Your comment is awaiting approval from the administrator"

  • This comment will be added to the unapproved comments section. Portal Admin can approve or reject comments

Approve/Reject Comments

  • Click the "Approve" button to approve comments. A popup will appear when you click the approve button

  • On clicking the approve button, a confirmation message will appear and comment will get added in approved comments list

  • Click on "Reject" to reject comments. A popup will appear for confirmation when you click the reject button

  • On clicking the reject button, the comment will be rejected, and a rejection message will be displayed

  • Approved comments will be listed on the approved comments page. Portal admins will be able to reject comments directly from the approved comments page

  • For portal admins, comments will automatically be approved. However, for other roles, comments will be added to the unapproved comments list, awaiting approval or rejection by a portal admin