Activity Comment Moderation - User Guide

What is Comment Moderation?

Comment Moderation allows community members to report inappropriate comments on activity updates. Just like activity posts, this feature provides a Flag/Unflag button on each comment, enabling members to notify administrators about comments that violate community guidelines.

Activity Stream with Comments Activity stream showing Flag button - comments also have similar flag options

Why Do You Need This?

For Site Administrators:

• Targeted moderation: Address problematic comments without affecting the entire activity thread
• Conversation quality: Maintain healthy discussions by removing toxic comments
• Thread protection: Keep good discussions clean by filtering out spam or abusive replies
• Separate tracking: Manage comment reports independently from activity reports

For Community Members:

• Protect discussions: Report comments that derail or pollute conversations
• Quick response: Flag inappropriate replies without reporting the entire post
• Contextual reporting: Address specific problematic comments in otherwise good threads
• Safer engagement: Feel confident participating when you can flag abusive responses

How It Works

For Regular Members

Flagging a Comment

1. Locate the Comment

   • Browse activity updates and their comments
   • Find the specific comment you want to report
   • Look for the “Flag” or “Submit Report” option next to the comment

2. Report the Comment

   • Click the “Flag” or “Submit Report” button
   • A popup appears asking for the report reason:
     • Spam or Scam
     • Inappropriate Content
     • Harassment or Bullying
     • Hate Speech
     • Off-topic or Trolling
     • Other (with description)
   • Select the reason and click “Submit Report”

3. Confirmation

   • Success message appears
   • Button changes to “Unflag” or “Retract Report”
   • Comment may be hidden based on admin settings

Unflagging a Comment

To retract your report:

1. Find the comment you flagged
2. Click “Unflag” or “Retract Report”
3. Your report is removed from the moderation queue

For Site Administrators

Enabling Comment Moderation

1. Navigate to WordPress Admin → Moderation Pro → Settings
2. Go to “General Settings” tab
3. Under “Select Components”, check “Activity Comment”
4. Click “Save Changes”

Configuring Comment Settings

Go to Moderation Pro → Activity Comment tab:

Button Text Customization:

• Submit Report: Text for the flag button (default: “Flag”)
• Retract Report: Text for unflag button (default: “Unflag”)

Hide Mode Options:

• Hide from reporter only: Only the reporter sees the comment hidden
• Hide from all site members: All members (except admins) cannot see the flagged comment
• Don’t hide: Comment remains visible to everyone until admin reviews

Automatic Moderation:

• Enable/Disable: Toggle automatic comment hiding
• Moderation Limit: Number of reports before auto-hide (e.g., 2 reports for comments since they’re typically shorter than activities)

Author Consequences: When someone’s comment is flagged repeatedly:

• Disable commenting: Prevent user from posting new comments
• Disable all activity: Stop all activity creation (more severe)
• Both restrictions: Apply complete activity restrictions

Reviewing Flagged Comments

1. Go to WordPress Admin → Moderation Pro → Activity Comments

2. View the moderation table showing:

   • Comment Content: Text of the flagged comment
   • Comment Author: Who wrote the comment
   • Activity Context: The activity update the comment was posted on
   • Activity Author: Original post creator
   • Reporter(s): Members who flagged this comment
   • Report Count: Total flags received
   • Report Reason: Why it was reported
   • Date: When the comment and reports were made
   • Status: Current moderation state

3. Actions Available:

   • View Full Context: See the complete activity thread
   • Edit Comment: Modify the comment content
   • Mark as Spam: Hide and mark as spam
   • Mark as Clean: Approve and remove flags
   • Delete: Permanently remove the comment

Managing Flagged Comments

Mark as Spam:

• Hides comment from all members
• Applies restrictions to comment author (if configured)
• Original activity post remains unaffected
• Can be restored if marked as spam by mistake

Mark as Clean:

• Removes all flags from the comment
• Makes comment visible again
• Removes author restrictions related to this flag
• Signals to reporters that content was reviewed

Delete Comment:

• Permanently removes the comment
• Original activity and other comments remain intact
• Cannot be undone
• Use for severe violations only

Notification Settings

Admin Notifications

Configure in Moderation Pro → General Settings → Email and Notification:

For Comment Flags:

• Email Alerts: Receive email when comments are flagged
• BP Notifications: Get notification bell alerts
• Select Recipients: Choose which admins/moderators receive alerts

Notification Content:

• Comment text and context
• Reporter information
• Reason for report
• Parent activity link
• Direct link to moderation panel

Author Notifications

Comment authors receive:

• Alert that their comment was flagged
• Information about any restrictions applied
• Ability to edit or delete their comment
• Link to community guidelines

Best Practices

For Community Members:

1. Flag specific issues: Only report the problematic comment, not the entire activity
2. Provide context: Use the reason categories to help admins understand the issue
3. Don’t pile on: If a comment is already flagged, additional reports should only be made if you genuinely find it problematic
4. Consider the context: Ensure you understand the full conversation before flagging

For Site Administrators:

1. Respond quickly: Comments in active discussions need faster review than older content
2. Review full context: Read the entire activity thread before making decisions
3. Be proportionate: Not every flagged comment needs deletion - editing may suffice
4. Track patterns: Users who repeatedly post flagged comments may need warnings or suspensions
5. Set clear thresholds: Comments may need lower flag counts than activities (suggest 2-3 vs 3-5)
6. Monitor false flags: Watch for members who flag comments they simply disagree with

Common Scenarios

Scenario 1: Spam Comment

Situation: Someone posts “Buy cheap products at [link]” on multiple activities.

Action:

1. Members flag the spam comments
2. After threshold is reached, comments auto-hide
3. Admin reviews and marks all as spam
4. User’s commenting ability is disabled
5. Admin can delete all spam comments in bulk

Scenario 2: Heated Discussion

Situation: Two members are having a debate that gets heated, and comments are flagged.

Action:

1. Admin reviews the full conversation thread
2. Determines comments are passionate but not abusive
3. Marks as “Clean” to remove flags
4. May post a moderator comment asking for civil discussion
5. Monitors the thread for further issues

Scenario 3: Personal Attack

Situation: A comment contains a personal attack or insults toward another member.

Action:

1. Comment is flagged immediately
2. Admin receives notification and reviews
3. Deletes the offensive comment
4. Disables commenter’s ability to comment temporarily
5. Sends warning message to the offender
6. May notify the victim that action was taken

Scenario 4: Constructive Criticism Flagged

Situation: A comment provides negative but constructive feedback and gets flagged.

Action:

1. Admin reviews the comment
2. Determines it’s legitimate criticism, not abuse
3. Marks as “Clean”
4. Educates reporters about the difference between disagreement and violations
5. May adjust auto-hide threshold to prevent false positives

Troubleshooting

Q: Flag button doesn’t appear on comments

• Ensure you’re logged in
• Check if Activity Comment moderation is enabled in settings
• Verify your user role has reporting permissions
• Some themes may hide the button - check with theme support

Q: Can I flag my own comment?

• No, the flag button doesn’t appear on your own comments
• You can edit or delete your own comments instead

Q: Comment disappeared after I flagged it

• This is normal if “Hide from reporter only” or “Hide from all” is enabled
• Admin will review and may restore if it’s not a violation
• Your flag has been recorded

Q: I’m seeing too many frivolous comment flags

• Increase the auto-moderation limit
• Review who’s making false reports and consider restricting their reporting ability
• Disable auto-hide and manually review all flags
• Educate community about proper flag usage

Q: How do I know if my comment was flagged?

• You’ll receive a BuddyPress notification (if enabled)
• You may receive an email notification
• The comment may be hidden from view
• Check your profile’s moderation reports section

Q: Can I appeal a flagged comment decision?

• Contact the site administrator directly
• Provide context or explanation
• Admins can review and restore comments if appropriate

Differences Between Activity and Comment Moderation

Feature	Activity Moderation	Comment Moderation
Scope	Entire activity post	Individual comment only
Impact	Affects main content	Affects reply/discussion
Visibility	More prominent	Within activity thread
Typical Threshold	3-5 flags	2-3 flags (smaller unit)
Author Impact	Can disable all activity	Usually just commenting
Context	Standalone content	Part of larger conversation

Integration with Activity Moderation

• Comments on flagged activities remain visible unless also flagged
• Flagging an activity doesn’t automatically flag its comments
• Each comment is moderated independently
• Admins can see both activity and comment flags in separate tabs
• Bulk actions can be applied to comments from flagged activities

Feature Availability

• Required: BuddyPress 3.0+
• Works With: All BuddyPress activity-enabled themes
• Template Support: Legacy and Nouveau template packs
• Theme Compatibility: BuddyX, Reign, BuddyBoss, Youzify, and more
• Mobile: Fully responsive interface

Related Features

• Activity Moderation - Flag entire activity posts
• Member Moderation - Report users directly
• Auto-Moderation Settings - Configure automatic actions
• Admin Content Management - Bulk comment moderation

---

Need Help?

• Documentation: https://docs.wbcomdesigns.com
• Support: support@wbcomdesigns.com
• Community Forum: Join for moderation best practices