BuddyPress & BuddyBoss Integration

BuddyPress Hashtags hooks into BuddyPress and BuddyBoss Platform at the activity stream level, adding hashtag links, a filtered feed, and follow-hashtag navigation — without any manual configuration beyond the initial install.

How It Works

When a member posts an activity update, hashtag words (anything starting with #) are converted to clickable links. Clicking a hashtag link opens a filtered view of the activity stream showing only posts that contain that tag.

The conversion happens on these BuddyPress content surfaces:

Surface	What Gets Tagged
Activity updates	Inline post content
Activity comments	Comment bodies
Group activity updates	Updates posted inside a group
Blog post activity	Activity generated when a post is published
Blog comment activity	Activity generated when a comment is approved
Edited activities	Activities updated with the “Edit Activity” plugin

Activity Stream Search Override

When someone clicks a hashtag link, the URL includes an activity_search query parameter (for example, /activity/?activity_search=%23webdesign). The plugin intercepts BuddyPress’s AJAX query string filter to translate that into a search_terms parameter that BuddyPress understands, and also sets display_comments=stream so activity comments are included in the results.

This works with both the BuddyPress Nouveau template (bp_nouveau_get_activity_directory_nav_items) and the older default theme (bp_dtheme_ajax_querystring).

BuddyBoss Platform: Activity Filter

BuddyBoss Platform ships its own activity filtering system that is separate from BuddyPress’s query string approach. When BuddyBoss is active, the plugin registers an additional filter to handle this:

• It overrides the SQL WHERE condition used by BuddyBoss’s activity search so that searching for a hashtag correctly matches activity content.
• It adds “Followed Hashtags” as an option inside BuddyBoss’s built-in activity filter dropdown (the one that normally shows options like “All Updates”, “My Posts”, etc.).
• This filter option appears in both the main activity directory and within group activity timelines.

The BuddyBoss-specific hooks only load when buddypress()->buddyboss is set, so they have no effect on standard BuddyPress installs.

Followed Hashtags: BuddyPress Nouveau Tab

When the Hashtag Following feature is enabled (see General Settings), the plugin adds two navigation items under BuddyPress Nouveau:

1. Activity directory tab — A “Followed Hashtags” tab appears alongside the standard activity stream tabs (All Members, Following, etc.). Only logged-in users see this tab. Clicking it shows a filtered feed of every activity post containing any hashtag the current user follows.

2. Member profile activity sub-tab — On a member’s profile, a “Followed Hashtags” tab appears under their Activity nav. If the member has not followed any hashtags yet, a friendly message links them to their settings page instead of showing an empty activity loop.

3. Member settings sub-tab — A “Follow Hashtags” entry is added under a member’s Settings nav (Profile > Settings > Hashtags), where they can add or remove followed hashtags.

4. WordPress admin bar — A “Hashtag” link is added under the BuddyPress section of the admin bar toolbar, pointing directly to the member’s hashtag settings page.

BuddyBoss Platform: Followed Hashtags Filter

On BuddyBoss, the “Followed Hashtags” option appears in the activity filter dropdown rather than as a separate tab. The plugin registers the hashtag key with the label “Followed Hashtags” in both the main activity directory filter and the group timeline filter.

When a member selects “Followed Hashtags” from that dropdown, the activity scope filter runs a database query that returns only activities whose content contains at least one hashtag in the member’s follow list.

Template Compatibility

The plugin works with all three BuddyPress template stacks:

• Nouveau — Full support including the activity directory tab
• Legacy (Classic) — Full support via the bp_dtheme_ajax_querystring filter
• BuddyBoss Platform — Full support via dedicated BuddyBoss hooks

No theme files are overridden. All output is injected through BuddyPress action and filter hooks.

Enabling and Disabling Features

All BuddyPress-related features are on by default. You can disable the Hashtag Following feature (which removes all follow-related navigation) from:

WB Plugins > BuddyPress Hashtag > General Settings > Enable Hashtag Following

Turning this off removes the activity directory tab, the member profile sub-tab, the settings sub-tab, the admin bar link, and the BuddyBoss filter dropdown option.

Troubleshooting

Hashtag links are not filtering the activity stream. Verify the Nouveau template is active, or that you are using BuddyPress Legacy or BuddyBoss. Custom themes that bypass BuddyPress’s query string filters may need a small code adjustment — see Hooks & Filters Reference.

On BuddyBoss, clicking a hashtag shows all activities instead of filtered results. This is expected behavior without the BuddyBoss-specific search override. If the override is not running, check that buddypress()->buddyboss is defined (it should be if BuddyBoss Platform is active and BuddyPress compatibility is enabled).

“Followed Hashtags” tab does not appear. Check that “Enable Hashtag Following” is turned on in General Settings. Also confirm BuddyPress Nouveau is the active template, since the tab only registers on the bp_nouveau_get_activity_directory_nav_items filter. BuddyBoss users see the dropdown option instead of a tab.