Skip to content

Activity and Notifications

Forum topics and replies can flow into two separate PeepSo systems: the activity stream and the notification bell. They are controlled independently.

A PeepSo activity for a new topic is created only when all of these are true:

  1. The forum is not private and the topic is not private.
  2. The forum does not have “Do not add activity for topics in this forum” ticked.
  3. The site setting Display “topic created” activity is on.
  4. The member has not opted out of topic activity in their Preferences.

Replies follow the same chain with the reply equivalents of each setting.

The activity entry shows a sentence such as “A new topic [title] added by [author] in forum [forum]” (or the reply equivalent), linking each name to the relevant forum, topic and PeepSo profile. Before display, the content is cleaned:

  • Gutenberg block comment markup (<!-- wp:... -->) is stripped.
  • GIPHY shortcodes are removed when wpForo GIPHY is active.
  • wpForo attachment links are normalised (and hidden when the viewer lacks attachment-view permission).
  • On multi-board sites, the correct board context is switched in to render the activity and restored afterwards, so the stream does not leak board context between items.

Each member can stop their own forum activity from posting to the stream. On their PeepSo profile, under Preferences, a WpForo Activity Settings group offers:

  • Enable this option to prevent the creation of topic activities.
  • Enable this option to prevent the creation of reply activities.

These are opt-outs. ON means “do not post that activity”; OFF means “allow the activity”. Each switch appears only if the matching site-level activity setting is enabled.

Notifications are independent of the activity stream. Even with activity display turned off, notifications still fire if their site setting is on.

The addon sends three notification types:

  • wpforo_topic_new_post - a reply to your topic (to the topic author).
  • wpforo_sub_topic_new_post - a reply to a subscribed topic (to subscribers).
  • wpforo_sub_new_topic - a new topic in a subscribed forum (to subscribers).

Members can toggle these in their PeepSo notification-alert preferences under a Forum group.

Notification links resolve to the correct forum topic or reply even when no activity post exists, because the addon stamps the forum URL onto the notification when it is sent. Reply notifications use a board-aware subscriber query, so they reach subscribers on secondary boards, not only the default board.

If wpForo Cross Posting is active, the addon protects against its side effects:

  • One source article cross-posted to several boards produces one activity, not one per board.
  • Creating an activity will not itself trigger another cross-post (which would otherwise loop and create thousands of duplicate topics). The addon clears the cross-post request data around its own activity insert and guards against recursion.

Developers can suppress cross-post activities entirely with the peepsowpforo_activity_for_crosspost filter (return false).