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