Pending Review & Moderation
Moderation lets you check what some members write before readers see it. Choose which roles need approval under WB Plugins > Member Wiki > Permissions > Moderated Roles (Require Approval). Choose who reviews under Who Can Approve Pending Pages (administrators by default).
Moderation never takes a page offline. A published page keeps showing its current text while an edit to it waits for review.
What Goes to Review
Section titled “What Goes to Review”When a member in a moderated role saves:
| They are… | What happens |
|---|---|
| Creating a new page | The page is saved as Pending. Nobody else can see it until a reviewer approves it. |
| Editing a published page | The page does not change. Their edit is saved separately as an edit waiting for review, and readers keep seeing the current text. |
| Editing their own draft or pending page | The page stays pending, as before. |
After saving an edit to a published page, the member returns to the page and sees: “Your edit to this page is waiting for review. Readers see the current text until it is approved.” with a See your edit button. If they open the editor again, it continues from their waiting edit; saving replaces it. Each member has at most one waiting edit per page.
The Pending Review Queue
Section titled “The Pending Review Queue”Reviewers open the queue from the dashboard’s Pending Review button, or directly:
?wbmw_action=pendingThe heading shows how many items wait, e.g. “Pending Review (4)”. Items are listed oldest first in two groups:
- Edits to published pages: page title, who edited it, when, and their edit summary. Actions:
- Changes: shows the edit compared with the page as readers see it now
- Approve: the edit becomes the page’s text
- Reject: the edit is discarded; the page stays as it is
- New pages: page title, author, when, and edit summary. Actions:
- Review: opens the page in the editor
- Approve: publishes the page
- Reject: returns the page to its author as a draft
Reviewers also see a banner on a published page when edits to it are waiting: “1 edit to this page is waiting for review.” with a Review button.
Reject always asks for confirmation first.
What Approving an Edit Does
Section titled “What Approving an Edit Does”- The page’s title, text, categories, tags, parent page, stub flag and hatnote become the edited version.
- The change is saved as a normal revision credited to the member who wrote it, with their edit summary, so History shows who changed what.
- The member is added to the page’s contributors, watchers are notified, and (with BuddyPress groups) the group activity names the member.
If someone else changed the page after the edit was made, the Changes screen warns: “The page was changed by someone else after this edit was made.” Approving replaces the current text with the edited version, so check the comparison first.
Emails
Section titled “Emails”To the reviewer. When a new page or an edit enters review, an email goes to the address in WB Plugins > Member Wiki > General > Pending Review Email (blank = the site admin email). It names the page, the member and their edit summary, and links to the front-end Pending Review queue.
The template is templates/email-pending-notification.php. Override it in your theme at your-theme/wb-member-wiki/email-pending-notification.php. The $is_edit variable tells you whether it is an edit to a published page.
add_filter( 'wbmw_pending_notify_email', function( $email ) { return 'moderators@yoursite.com';} );To the member. When a reviewer approves or rejects their page or edit, the member gets a short email saying what happened, with a link to the page (approved) or the editor (rejected). Turn it off with:
add_filter( 'wbmw_notify_review_outcome', '__return_false' );Developer Hooks
Section titled “Developer Hooks”wbmw_page_approved / wbmw_page_rejected
Section titled “wbmw_page_approved / wbmw_page_rejected”Fired after a pending new page is approved (published) or rejected (returned to draft).
add_action( 'wbmw_page_rejected', function( $page_id, $user_id ) { error_log( sprintf( 'Wiki page %d rejected by user %d', $page_id, $user_id ) );}, 10, 2 );| Parameter | Type | Description |
|---|---|---|
$page_id |
int | Wiki page ID |
$user_id |
int | Reviewer’s user ID |
wbmw_edit_approved / wbmw_edit_rejected
Section titled “wbmw_edit_approved / wbmw_edit_rejected”Fired after a member’s edit to a published page is approved (applied) or rejected (discarded).
add_action( 'wbmw_edit_approved', function( $page_id, $member_id, $reviewer_id ) { // Example: give the member points for an accepted edit.}, 10, 3 );| Parameter | Type | Description |
|---|---|---|
$page_id |
int | Wiki page ID |
$member_id |
int | Member who made the edit |
$reviewer_id |
int | Reviewer’s user ID |
Approving an edit also fires wbmw_page_updated with the member’s ID, the same as a direct edit.
Waiting edits are stored as internal posts of type wbmw_pending_edit (never public, not in REST), with post_parent set to the wiki page and post_author set to the member.

