On Sept 1, 2016, the forums were upgraded to bbPressbbPress Free, open source software built on top of WordPress for easily creating forums on sites. https://bbpress.org. 2.x
This changed everything. Since bbPress 2 runs on WordPress, moderator powers are more closely managed as they give users powers to more aspects of the WordPress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ site.
Forum roles
There are two elevated roles within theĀ forums, Moderator and Keymaster.
ModeratorsĀ are tasked with keeping the forums tidy, they have the ability to archiveĀ and spam posts, as well asĀ manage the spam and pending queues. They are expected to escalate any issues to the KeymastersĀ if it is required.
Keymasters generally perform the same tasks as a Moderator. In addition to moderator powers, they can block users from posting, elevate new users, and delete posts. The Keymaster role is strictly regulated.
Both Moderators and Keymasters have access to the wp-admin Dashboard of the support forums, and will need it to manage the forums.
Users
User profiles are located at https://wordpress.org/support/users/USERNAME
Within that page are links to topics created, replies, favorites, subscriptions, and of course the edit window.
The majority of users are well behaved, however some people handle being upset better than others. If a user posts foul/colourful language once or twice, it’s worth editing their post and leaving a mod-note as to why.
If a user needs to be banned then a Keymaster will need to address this. Otherwise, Users should be Flagged. This will require all posts to be approved.
User Notes
Any time a user needs to be moderated, it’s best to leave a robust user note.Ā Notes are saved with the date and the moderator who made them. TheyĀ can be edited or deleted, but it’s best practice to leave them be unless they were placed in error.
You can do this in two places:
User Profile: Any moderator who visits a profile page will see a “User Notes” block at the bottom of the page:
In Posts: In posts, a moderator will see if a user has a note.
That can be expanded to show the same form as above:
Users cannot see their own notes.
Flagging Users
To flag a user, go to a post and click Flag Author:
Spamming Users
If a user is spamming, then they should be marked as a spammer and banned. Leave a user note if you feel it’s necessary, but you can just ask for someone in Slack to please ban the user.
Banning Users
Only Keymasters can ban users. They can do this in one of two ways.
Profile:Ā Edit their user profile (click on their profile and then click edit). At the bottom of the page, there is a section for “Forum Role.” Change that to blocked and save.
Admin DashboardĀ Go to the Users list and search for the user:
Check the box by their name and change theĀ forumĀ role toĀ Blocked
Click onĀ Change and the user will be changed.
Posts (Topics and Replies)
Most of the work done will be on the front end of the forums (that is the same view as all users see)
Helpful Views:
- Most popular topics
- Topics with no replies
- Non-support topics
- Resolved topics
- Unresolved topics
- All topics
Post Statuses
We have new statuses for posts:
- Spam – Spam
- Pending – Needs to be approved by a moderator
- Archived – Hidden from view but saved for posterity
The Post Sidebar
When you look at a topic, there will be options on the sidebar to help you moderate.
TheĀ +1 hidden link will refresh the page and show all ‘hidden’ posts like spam or archived. Moderators can also change the status to resolved if needed.
Further down is a section calledĀ Topic Admin:
This will let you have quick access to manage the topic. Yes, you can merge topics now.
Editing Posts and Topics
Moderators can edit post content. Generally this should be used for fixing formatting of code, removing links and foul language, and so on.
The edit screen looks like this:
When you edit, if it’s not obvious why, leave a note. If you edit the first post in a topic, you will be given an option to uncheck the box to “Keep a log of this edit:”
It’s recommended you not do this. Ninja Edits are bad. Don’t do it.
A post that has been edited will show a public log:
Keep it PG folks.
Deleting (Archiving)Ā Posts and Topics
Only Keymasters can delete. And in general we do not currently delete posts. The reason for this is so we can keep a history of behavior. In the case of escalating abuse, having a history of the user’s behavior is paramount. Instead, posts should be archived or spammed.
Archiving Posts
See Also: Archived Posts View
Any post that isn’t spam or approved should be archived. We keep these posts in order to recordĀ a history of behavior. In the case of escalating abuse, having a history of the user’s behavior is paramount.
To archive an entire topic, clickĀ ARCHIVE from the Topic Admin sidebar. To archiveĀ just one post,Ā hover over the post and clickĀ ARCHIVE from the menu.
If a post has to be un-archived, it returns to it’s previous status. Spam goes to spam, and so on.
Spammed Posts
See Also: Posts Tagged Spam
The spam queue lists all the posts that are spam. Akismet willĀ automatically delete posts marked as spam after 15 days, so there is no need to delete them. Yes, it means the list gets long. Just go through it and look for posts that should be unspammed. If there’s a post you can’t edit, that’s because it’s been trashed (see #1962). Just leave it alone.
If you see a post that is spam, press the ‘Spam’ button and walk away.
If you see a post that isn’t spam, you can press Unspam:
Obviously that one was spam, so leave it alone.
Pending PostsĀ Queue
The pending queue is for posts that were caught and need moderator approval. These are not posts caught as spam, but ones that trigger moderation in other ways, such as too many links, or the poster has been flagged due to prior behavior.
There are twoĀ ways to viewĀ pending posts:
- Via the front endĀ Pending Posts ViewĀ – this shows repliesĀ and topics
- Via the wp-admin
Pending Posts View
This is a front-end displayĀ thatĀ will show both Spam and Pending posts. To approve a post, click the Approve Button:
This view is best for quick overviews.
WP-Admin Pending Topics and Replies
The front-end queue is fine, but sometimes you need the more granular control of the wp-admin dashboard. The dashboard is bbPress on WordPress, so it looks like WordPress. The two views you will mostly use are these:
When you go to that view, you should set your posts to display excerpts:
Then when you look at the replies they’ll be much easier to parse quickly. Posts can be approved or sent to spam from pending.
In the above example, you’ll notice the first username is luxuryrealtygroupĀ which could be a company or a spammer. In the second reply, the post content includes “Eurovision” — a common phrase used by spammers. Since both are possibly spam, you’ll want to clickĀ view and see them in context. There you would see the second post is perfectly fine, while the first is a reply to a month-old topic.
If you click on EDIT, you can see the akismet history:
Clearly Ipstenu and Clorith should chat.
ModLook Queue
See:Ā Posts Tagged Modlook
When a user finds a post that should be deleted, or needs moderator attention, they apply the forum tag ‘modlook.’ This view should be regularly monitored and cleared out.
That list is normally empty if we’re doing our jobs right.
