bbPress Integration
BuddyPress Hashtags can process hashtags inside bbPress forum topics and replies. The feature is opt-in at the settings level: the option appears in General Settings only when bbPress is active, and it is enabled by default.
What Gets Tagged
Section titled “What Gets Tagged”When a member creates or edits a forum topic or reply, any #word is converted to a clickable hashtag link. The link points to the bbPress search results page for that tag, using the configured bbPress search slug.
Supported content:
| bbPress Content | Hook Used |
|---|---|
| New topic body | bbp_new_topic_pre_content |
| Edited topic body | bbp_edit_topic_pre_content |
| New reply body | bbp_new_reply_pre_content |
| Edited reply body | bbp_edit_reply_pre_content |
| Displayed topic content | bbp_get_topic_content |
| Displayed reply content | bbp_get_reply_content |
The display-time filters (bbp_get_topic_content, bbp_get_reply_content) fix search result URLs by rewriting /?bbp_search= to the cleaner search/ path that bbPress uses.
Hashtag Links in bbPress
Section titled “Hashtag Links in bbPress”Hashtag links inside forums point to bbPress search, not to the BuddyPress activity stream. When a member clicks #support inside a forum post, they land on the bbPress search results page filtered to that term.
The link URL uses the forum root slug and search slug from your bbPress settings. If you have a forum root (set in Settings > Forums > Forum Root Slug), it is prepended automatically.
Content Saved to Database
Section titled “Content Saved to Database”Each hashtag found in a new topic or reply is recorded in the plugin’s hashtag database table with type bbpress. This allows the bbPress hashtags widget to display trending forum tags separately from BuddyPress activity tags.
Enabling and Disabling
Section titled “Enabling and Disabling”WB Plugins > BuddyPress Hashtag > General Settings > Enable bbPress Hashtags
This toggle only appears when bbPress is active. When turned off, none of the bbPress content filters run and hashtags in forums remain as plain text.
When you disable bbPress hashtags, the previously saved hashtag data is cleared from the database (the plugin calls delete_option('bpht_bbpress_hashtags') on save).
bbPress Widget
Section titled “bbPress Widget”A dedicated “bbPress Hashtags” widget is registered when bbPress is active. It displays trending hashtags from forum content only (type bbpress). Add it from Appearance > Widgets. See Widgets & Shortcodes for configuration options.
Version Requirements
Section titled “Version Requirements”- bbPress 2.6 or higher
- Works with the default bbPress templates and most custom bbPress themes
Troubleshooting
Section titled “Troubleshooting”Hashtags in forums are not becoming links. Go to General Settings and verify “Enable bbPress Hashtags” is checked. If the option does not appear, bbPress may not be active or recognized.
Hashtag links open the wrong page. The plugin uses the bbPress root slug and search slug from your bbPress settings. If you have changed those slugs after hashtags were already saved, the links will reflect the new slugs on fresh content but old content may need to be re-saved or you can use a permalink flush (Settings > Permalinks > Save Changes).
A hashtag that exists in forum posts does not appear in the bbPress widget.
The widget reads from the bbpress type in the hashtag database table. If you recently enabled the feature, only newly created content is tagged. Content posted before the plugin was active is not retroactively scanned.