Featured Posts
New in 4.0.0. Featured posts are the site owner’s editorial picks: member posts you want on the front page, in a sidebar, or at the top of a landing page.
This is site-wide featuring, and it is not the same thing as Pro’s per-group featured posts, which are scoped to a single BuddyPress group.
Who Can Feature a Post
Section titled “Who Can Feature a Post”Anyone with the edit_others_posts capability - editors and administrators.
That is deliberate. If an author’s own capability were enough, every member could promote themselves to the front page and “featured” would mean nothing within a week.
To change it:
add_filter( 'bpmb_feature_capability', function () { return 'manage_options'; // Administrators only.} );The same capability governs the review queue, so there is one notion of “editor” across the plugin.
Featuring a Post
Section titled “Featuring a Post”There is no separate screen. An editor deciding what to feature is already looking at the list of posts, so the controls are there.
- Go to Posts in WordPress admin.
- Hover the row you want and click Feature. To remove it, click Unfeature.
- The Featured column shows a star for each featured post. Click the column heading to sort by it.
Select several rows and use the Bulk actions dropdown for Feature or Unfeature.
Only Published Posts Can Be Featured
Section titled “Only Published Posts Can Be Featured”A draft cannot be featured, and the Feature action is not offered on one. Featuring a draft would write the flag, put the post nowhere, and then silently promote it to the front page the moment somebody published it - a surprise nobody wants from a checkbox they ticked last month.
Unpublishing a featured post un-features it. If a featured post is moved to draft, pending or trash, its featured flag is cleared automatically. Otherwise the post would disappear from the front page while the admin list still said it was featured, and nobody could work out why.
Re-publishing it does not re-feature it. Feature it again if you still want it.
Displaying Featured Posts
Section titled “Displaying Featured Posts”Add the shortcode to any page, post or widget:
[bp-member-blog-featured][bp-member-blog-featured per_page="6" columns="3" title="Editor's Picks"]There is also a Featured Posts block in the editor with the same options.
Attributes
Section titled “Attributes”| Attribute | Default | Description |
|---|---|---|
per_page |
3 |
How many posts to show (maximum 24) |
columns |
3 |
Grid columns (1 to 4) |
category |
(empty) | Only featured posts in this category |
tag |
(empty) | Only featured posts with this tag |
title |
(empty) | Optional heading above the grid |
class |
(empty) | Extra CSS class on the wrapper |
Nothing featured means nothing rendered
Section titled “Nothing featured means nothing rendered”If no posts are featured, the shortcode and block output nothing at all - not an empty box, not a “no featured posts” message. A featured strip usually sits on a homepage, and a message aimed at the site owner has no business being printed in front of every visitor. The admin notice belongs in the admin.
Ordering
Section titled “Ordering”Featured posts are shown by WordPress menu order first (lowest number first), then newest first.
For Developers
Section titled “For Developers”| Hook | Fires when |
|---|---|
bpmb_post_featured |
A post is featured. Receives the post ID and the sort order. |
bpmb_post_unfeatured |
A post is un-featured, including automatically when it leaves published status. |
bpmb_feature_capability |
Filters the capability required to feature posts. |