Skip to content

Pending Review & Moderation

WB Member Wiki overviewPremiumGet WB Member Wiki →

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.

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.

Reviewers open the queue from the dashboard’s Pending Review button, or directly:

?wbmw_action=pending

The 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.

  • 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.

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' );

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

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.