Activity Stream Integration
When a member creates a bbPress forum, topic, or reply, the addon publishes a matching post to the PeepSo activity stream. The activity is attributed to the member and carries the addon’s PeepSo module id (226016).
Three activity types
Section titled “Three activity types”| Action | bbPress hook consumed | PeepSo activity created |
|---|---|---|
| New forum | bbp_new_forum_post_extras |
New forum activity |
| New topic | bbp_new_topic_post_extras |
New topic activity |
| New reply | bbp_new_reply_post_extras |
New reply activity |
Each type has an admin switch to display or hide it and a message template. See Configuration.
Two levels of control
Section titled “Two levels of control”An activity is only created when both are true:
- The site-wide display switch for that activity type is on
(
wbpbi_new_forum_activity_setting_display,wbpbi_new_topic_activity_setting_display,wbpbi_new_reply_activity_setting_display). - The member has that activity type enabled in their own PeepSo preferences (see Member preferences).
Message templates and tokens
Section titled “Message templates and tokens”Activity text is generated from a template you set per type. The template is a plain string containing tokens that the addon replaces with live forum data. Tokens that do not appear in your template are skipped, so you only pay for the data you use.
Default templates (set on activation):
- New forum:
{forum_name} created by {forum_creator}.plus a short description line. - New topic:
Topic {topic_name} added by {topic_author} in {topic_forum_name}.plus a short description line. - New reply:
A new reply added by {reply_author} in {reply_forum}.plus a short reply excerpt line.
The full token lists are in Configuration. Topic and reply excerpts are truncated to 500 characters; the forum description excerpt is truncated to 150 characters.
Group activity
Section titled “Group activity”If Group forums are enabled and the forum is linked to a
PeepSo group, the new topic and new reply activity is also attached to that
group’s stream (peepso_group_id post meta plus the peepso_groups_new_post
action), provided the author can access the group.
Notes from the code
Section titled “Notes from the code”- Topic and reply activity guard against duplicate creation using an activity id post meta. The new-forum duplicate guard is present but commented out, so a new forum can post a duplicate activity if its hook fires more than once (see Troubleshooting).
- Topic and forum titles are HTML-entity decoded before display so encoded characters render correctly (fixed in 2.3.0).