BuddyPress · Free · Version 3.0.0
Shortcodes for BuddyPress registers [activity-listing],
[members-listing] and [groups-listing].
Each one takes the same arguments the underlying BuddyPress loop takes, so you can filter, sort and
paginate the directory right in the shortcode. The same three come as Elementor widgets in this free plugin.
Requires BuddyPress with the Nouveau template pack · Free on unlimited sites
Running a licensed build? Compare Shortcodes for BuddyPress Pro
The reference
These are not fixed embeds. The attributes you pass go into the same query BuddyPress runs on its own directory pages, so one shortcode can be a full directory on one page and a tight filtered slice on another.
01
The BuddyPress activity stream
[activity-listing per_page="10" scope="friends" load_more="1"]
Attributes include
Set load_more="1" and the stream fetches the next batch over AJAX instead of paging. Activity comments stay collapsed on purpose: the plugin pins display_comments to false so a known BuddyPress comment-loop error cannot fire inside a page.
02
The member directory
[members-listing include_member_role="editor,author" per_page="9"]
Attributes include
include_member_role and exclude_member_role resolve WordPress roles into user IDs before the query runs, so a page can list only your editors, or everyone except them, without you hand-writing an ID list.
03
The groups directory
[groups-listing type="popular" grid="yes" loop_layout="three" per_page="9"]
Attributes include
status narrows the directory to public, private or hidden groups. Set orderby or order and the shortcode drops its default alphabetical type, because inside BuddyPress type quietly overrules both.
The full attribute list for all three, with defaults and worked examples, ships inside the plugin under Shortcodes in the WordPress admin, so it is always the list your installed version actually accepts.
Included free
The plugin is named Shortcodes and Elementor Widgets for BuddyPress because both ship in the free download. When Elementor is active, the plugin adds a BuddyPress Widgets category with an activity, a members and a groups widget in it. Drag one in and set it up in the panel instead of typing a shortcode.
Fit and control
BuddyPress, enforced by WordPress
The plugin declares BuddyPress as a required plugin in its header, so WordPress blocks activation without it rather than letting you find out on the front end.
The Nouveau template pack
Rendering runs through BuddyPress Nouveau. If a theme swaps that pack out, the shortcodes show a notice explaining what is missing instead of printing broken markup.
WordPress 6.5 and PHP 8.0
Both are declared in the plugin header. Version 3.0.0 is tested against WordPress 7.0.
A component that is switched on
Turn off the activity or groups component in BuddyPress and its shortcode prints the standard BuddyPress notice. It does not fatal the page.
Override any template in your theme
The template loader checks your theme before the plugin folder, so a copied file wins without touching plugin code.
BuddyBoss variants are already there
Members and groups each ship a bb- template alongside the bp- one, and the activity shortcode detects BuddyBoss to correct its group scope.
Filter the query before it runs
Each shortcode exposes its own query filter, plus a {tag}_attributes filter over the parsed attributes and before / after render actions.
Copy a template here to take it over
yourtheme/nouveau/members/bp-shortcodes-members.php
Hooks you will reach for first
Pricing
All three shortcodes, all their attributes and all three Elementor widgets are in the free download, on as many sites as you like. Pro is a separate plugin for teams that want the extras below; it replaces the free one rather than sitting on top of it, and the two cannot run together.
Free
Version 3.0.0 · Requires BuddyPress with the Nouveau template pack
The same three shortcodes and widgets, plus an object cache layer over the shortcode queries,
WP-CLI commands under wp bp-shortcodes, the legacy template pack alongside
Nouveau, and licensed updates. Tiers differ by site count and support only, never by feature.
Pro is licensed per year and renews for updates and support. Full details on the Pro page, and our refund policy applies to both.
Before you install
Answered against the shipped 3.0.0 code by the team that maintains it. Anything else, use the contact page.
Yes. The plugin declares BuddyPress as a required plugin, so WordPress will not let you activate it on its own. It also renders through the BuddyPress Nouveau template pack, and it shows a clear notice rather than broken markup if Nouveau is not available.
Three: [activity-listing] for the activity stream, [members-listing] for the member directory and [groups-listing] for the groups directory. Some older documentation for this plugin mentions a notifications shortcode; version 3.0.0 does not register one.
Yes. The free plugin adds a BuddyPress Widgets category to Elementor with activity, members and groups widgets in it. The widget controls map onto the same attributes the shortcodes accept, so both routes produce the same output.
The members and groups directories each ship a BuddyBoss template variant next to the standard one, and the activity shortcode detects BuddyBoss and corrects its group scope. You do not configure anything for this.
Yes. The template loader checks your theme before the plugin folder, so copying a file such as nouveau/members/bp-shortcodes-members.php into your theme takes it over. There are also filters over the parsed attributes and over each query before it runs.
No. They are two builds of the same plugin, not a base and an add-on. If Pro is active, the free plugin deactivates itself and tells you why.
The same three shortcodes and Elementor widgets, plus an object cache layer over the shortcode queries, WP-CLI commands under wp bp-shortcodes, the legacy template pack alongside Nouveau, and licensed updates with support.
Install the plugin, paste one of the three shortcodes into any post or page, and the directory renders with your theme's BuddyPress styling. Nothing to configure first, and no settings screen to learn.
Version 3.0.0 · Requires BuddyPress, WordPress 6.5 and PHP 8.0
WBComDesigns is amazing. The WP plugins and themes are of top notch quality with lots of features and updated very frequently. Supports are very responsive and helpful. I use Reign with TutorLMS, and the experience is surprisingly smooth.…