Moderator Role Setup

Complete guide for setting up moderators and configuring frontend moderation access in BuddyPress Moderation Pro.

---

Overview

BuddyPress Moderation Pro includes a dedicated BP Moderator Pro role that allows trusted community members to help manage reported content without requiring full administrator access. Moderators can review reports, take actions on content, and manage moderation queues from the frontend.

---

The BP Moderator Pro Role

What Moderators Can Do

Capability	Admin	Moderator
View reported content	Yes	Yes
Approve/Reject reports	Yes	Yes
Hide flagged content	Yes	Yes
Access frontend moderation queue	Yes	Yes
Suspend/Unsuspend members	Yes	Limited
Mark users as spammers	Yes	No
Delete content permanently	Yes	No
Configure plugin settings	Yes	No
Manage report categories	Yes	No
Access WordPress admin	Yes	Optional

Moderator Restrictions

Moderators have carefully limited permissions to prevent misuse:

• Cannot permanently delete content (only hide)
• Cannot mark users as spammers
• Cannot change plugin settings
• Cannot access sensitive user data
• Actions are logged for admin review

---

Assigning the Moderator Role

Method 1: WordPress Users Screen

1. Navigate to Users → All Users in WordPress admin
2. Click on the user you want to make a moderator
3. In the Role dropdown, select BP Moderator Pro
4. Click Update User

Method 2: BuddyPress Member Profile

1. Visit the member’s profile on the frontend
2. If you have admin privileges, click Manage Member
3. Select Assign Moderator Role
4. Confirm the action

Method 3: Bulk Assignment

1. Navigate to Users → All Users
2. Check the boxes next to users you want to assign
3. Select Change role to BP Moderator Pro from the Bulk Actions dropdown
4. Click Apply

---

Frontend Moderation Queue

Accessing the Queue

Moderators can access the moderation queue from their BuddyPress profile:

1. Log in as a moderator
2. Go to your Profile
3. Click on the Moderation tab in the navigation
4. The moderation queue displays all pending reports

Frontend Moderation Queue Frontend moderation queue accessible to moderators

Queue Features

The frontend moderation queue provides:

• Pending Reports - Content awaiting review
• Filter by Type - Activity, Comments, Groups, Messages, etc.
• Sort Options - By date, report count, content type
• Quick Actions - Approve, Hide, or Escalate directly from list
• Report Details - Click to view full report information

Reviewing a Report

Frontend Report Detail Detailed view of a report showing content and reporter information

When reviewing a report, moderators see:

1. Reported Content - The actual content that was flagged
2. Reporter Information - Who submitted the report (anonymized if configured)
3. Report Reason - Category selected by reporter
4. Report Count - How many times this content was reported
5. Report History - Previous reports on this content
6. Available Actions - Based on moderator permissions

Taking Action

From the report detail view, moderators can:

Action	Description
Dismiss Report	Mark as reviewed, no action needed
Hide Content	Remove content from public view
Warn Author	Send notification to content author
Escalate to Admin	Flag for administrator review
Add Note	Add internal comment for other moderators

---

Multi-Moderator Teams

Best Practices for Teams

1. Define Clear Guidelines

   • Create a moderation policy document
   • Define what content violates community standards
   • Establish escalation procedures

2. Assign Specializations

   • Some moderators focus on activity content
   • Others handle group reports
   • Specialists for sensitive topics

3. Regular Communication

   • Use internal notes on reports
   • Hold periodic moderator meetings
   • Review difficult decisions together

Avoiding Conflicts

When multiple moderators are active:

• Reports show “Being Reviewed By” indicator
• Lock mechanism prevents simultaneous actions
• Audit log tracks who took what action
• Admins can reassign locked reports

---

Moderator Notifications

Email Notifications

Moderators receive emails for:

• New reports in the queue (configurable)
• Reports escalated to them
• Admin decisions on escalated reports
• Weekly moderation summary (optional)

BuddyPress Notifications

In-site notifications appear for:

• New pending reports
• Reports assigned to them
• Responses to escalations

Configuring Notifications

Admins can configure moderator notifications at: WB Plugins → Moderation Pro → General → Moderator Notifications

Options include:

• Instant vs. digest notifications
• Which report types trigger notifications
• Threshold for notification (e.g., only when queue > 5)

---

Moderator Activity Log

All moderator actions are logged for accountability:

Logged Information	Details
Moderator ID	Who performed the action
Action Type	Approve, Hide, Dismiss, Escalate
Content ID	What content was affected
Timestamp	When the action occurred
Notes	Any comments added
IP Address	For security audit

Admins can review the log at: WB Plugins → Moderation Pro → Activity Log

---

Settings for Moderators

General Settings

Navigate to WB Plugins → Moderation Pro → General

Setting	Description
Enable Frontend Queue	Allow moderators to use frontend interface
Moderator Dashboard	Show moderation stats on profile
Hide Admin Bar	Remove admin bar for moderators
Limit Content Types	Restrict which content types moderators can review

Permission Settings

Fine-tune moderator capabilities:

Permission	Default	Description
Can suspend members	Off	Allow temporary suspensions
Suspension max days	7	Maximum suspension duration
Can send warnings	On	Send warning notifications
Can view reporter identity	Off	See who submitted reports
Can delete own decisions	Off	Undo their previous actions

---

Promoting and Demoting Moderators

Promoting to Moderator

When promoting a user:

1. Review their community standing
2. Check their activity history
3. Assign the role (see methods above)
4. Send orientation materials
5. Monitor initial moderation decisions

Demoting/Removing Moderators

If a moderator needs to be removed:

1. Navigate to Users → All Users
2. Edit the user’s profile
3. Change role back to Subscriber or appropriate role
4. Optionally notify the user
5. Review any pending actions they had assigned

---

Troubleshooting

Moderator can’t see Moderation tab

1. Verify user has BP Moderator Pro role
2. Check if Frontend Queue is enabled in settings
3. Clear any caching plugins
4. Verify BuddyPress profile tabs are not customized

Moderator actions not working

1. Check JavaScript console for errors
2. Verify AJAX nonce is valid (may need re-login)
3. Check if content type moderation is enabled
4. Review permission settings

Notifications not sending

1. Verify moderator notification settings are enabled
2. Check WordPress email is working
3. Verify moderator email address is correct
4. Check spam folder

---

Hooks for Developers

// Before moderator takes action
do_action( 'bmpro_before_moderator_action', $moderator_id, $action, $content_id );

// After moderator action completed
do_action( 'bmpro_after_moderator_action', $moderator_id, $action, $content_id, $result );

// Filter moderator capabilities
$caps = apply_filters( 'bmpro_moderator_capabilities', $caps, $user_id );

// Filter content types moderator can review
$types = apply_filters( 'bmpro_moderator_content_types', $types, $user_id );

// Customize moderator notification
$notify = apply_filters( 'bmpro_moderator_notification', $notify, $report_id, $moderator_id );

---

Related Documentation

• Admin Content Management - Full admin moderation guide
• Auto-Moderation Settings - Automated moderation rules
• Hooks & Filters - Developer customization

---

Last Updated: 2026-01-28