Overview
Bring your forum to life with Activity Stream, a powerful modification that introduces a centralised activity timeline for your entire SMF community.
Instead of browsing individual boards to discover what's happening, members can explore recent discussions, replies, likes and community activity from one convenient location.
Activity Stream also allows members to follow each other, discover popular discussions and create personalised activity streams tailored to their interests.
Whether your forum has a handful of active members or a large community, Activity Stream makes it easier to discover conversations, follow interesting people and stay connected.
✓ 100% Hook Based - No core or theme file edits required!
✓ Uses Existing SMF Data - No Additional Activity Tracking Required!
A Dynamic Community Timeline
Activity Stream brings together important forum activity into a single, easy-to-browse timeline.
Supported Activity Types
- New Topics - Discover newly created discussions across the forum.
- Topic Replies - See when members contribute to existing conversations, including a short content preview.
- Post Previews - Displays excerpts from discussions with quoted content removed for cleaner reading.
- Member Likes - See which discussions members are enjoying, with likes intelligently grouped together.
- New Members - Welcome new arrivals as they join the community.
- Third-Party Activity - Supports additional activity types supplied by compatible SMF modifications through integration hooks.
Rather than displaying every like as a separate entry, Activity Stream can group related activity into a single notification.
For example:
"Anna, Ben and 3 others liked..."
Timeline Presentation
- Chronological Activity - Browse recent community activity in an organised timeline.
- Day Grouping - Activity is grouped by date for easier navigation.
- Member Avatars - Quickly identify members participating in discussions.
- Activity Icons - Visual indicators distinguish different activity types.
- Load More - Browse older activity without navigating through traditional numbered pages.
Five Powerful Activity Stream Options
Members can explore several ready-made streams or create their own personalised experience.
- All Activity
Discover everything happening across the forum that you have permission to view.
Includes new topics, replies, likes, new members and supported activity from other modifications. - Following
Keep up with activity from members you follow.
Ideal for communities where members want to stay connected with friends, favourite contributors or other interesting members. - Popular
Find the discussions attracting the most attention.
Highlights topics receiving the most replies and likes during a configurable recent period. - My Activity
Browse your own contributions, including posts and likes, in one convenient location. - Custom Streams
Create personalised activity streams using your preferred filters.
Members can select:- Which activity types to include
- Activity from everyone, followed members or themselves
- Specific discussion boards
- A preferred time period
Each saved stream receives its own tab, and members can choose any available stream as their default view.
Member Following System
Activity Stream introduces a dedicated following system, giving members a simple way to stay connected with people whose contributions interest them.
- Follow Members - Follow another member directly from their Activity profile page.
- Instant Follow Actions - Follow and unfollow members without reloading the page.
- Follower Counts - Display how many members follow a particular user.
- Following Counts - Show how many members someone follows.
- People I Follow - Dedicated page for managing followed members.
- Find Members - Add people to your following list by searching for their names.
- Follow Back - View your followers and follow them back.
- Following Activity - Quickly browse contributions from followed members through a dedicated activity stream.
This adds a social element to your forum while retaining SMF's familiar discussion-based structure.
Personalised Activity Streams
One of Activity Stream's most useful features is the ability to create and save custom streams.
Rather than browsing every forum discussion, members can build a stream focused entirely on the activity they want to see.
For example:
- Favourite Boards - Follow activity from selected discussion areas.
- Friends & Members - Display contributions only from members you follow.
- Discussion Updates - Focus on new topics and replies without other activity types.
- Recent Activity - Restrict results to a selected period.
Custom streams appear as additional tabs, making switching between different views quick and convenient.
Administrators can also limit how many custom streams each member may save or disable the feature entirely.
Privacy & Permission Integration
Activity Stream works with SMF's existing board permissions and member privacy settings.
Members only see activity they are authorised to access.
- Board Permissions - Activity from restricted boards is only visible to members who have access.
- Unapproved Content - Unapproved posts are excluded from the timeline.
- Ignore List Integration - Activity from ignored members and boards is hidden.
- Administrative Exclusions - Administrators can exclude selected boards from all activity streams.
- Recycle Bin Protection - The forum's recycle bin is always excluded.
- Permission-Based Features - Administrators decide who can view streams, follow members and create custom streams.
New Permissions
- View the Activity Stream - Controls access to the activity timeline. Enabled for guests by default.
- Follow Members and Build Activity Streams - Controls access to following and custom stream functionality.
Built on Existing SMF Data
Activity Stream uses information SMF already stores, including topics, replies, likes and member registrations.
No additional tracking of member activity is required.
The modification organises existing information into an accessible timeline rather than introducing a separate system for recording forum actions.
This allows Activity Stream to work with existing discussions and community history while taking advantage of SMF's native functionality.
Extensible for Other Modifications
Activity Stream isn't limited to standard forum activity.
Modification developers can extend the timeline using dedicated integration hooks, allowing compatible modifications to contribute their own activity types.
For example, another modification could supply profile wall comments, club activity or other community interactions.
Available Integration Hooks
Code Select
integrate_activity_stream_types (&$types)
integrate_activity_stream_fetch (&$items, $config, $before, $limit)Example Activity Type
Code Select
$types['wall'] = 'Wall posts';Example Activity Item
Code Select
array(
'type' => 'wall',
'time' => 1700000000,
'key' => 'w123',
'actor' => 5,
'html' => 'Safe HTML line',
'snippet' => 'Safe HTML',
'url' => '...'
);Extensions should return items older than the supplied pagination cursor, newest first, with no more than the requested limit.
This provides a foundation for integrating additional community features into a unified activity timeline.
Administration & Configuration
Administrators can customise Activity Stream through a dedicated settings page.
Configuration:
Admin > Configuration > Activity Stream
Available Settings
- Activity Types - Choose which types of forum activity appear in streams.
- Items Per Page - Configure the number of activity entries loaded at once.
- Popular Activity Period - Set the time period used to identify popular discussions.
- Custom Stream Limits - Control how many personalised streams members may save.
- Excluded Boards - Prevent activity from selected boards appearing in streams.
- Menu Integration - Enable or disable the Activity Stream navigation button.
Combined with SMF's existing group permissions, these settings give administrators control over how the feature operates within their community.
Installation & Requirements
Install the modification through:
Admin > Packages > Download Packages > Upload Package > Install Now
Once installed, configure Activity Stream under:
Admin > Configuration > Activity Stream
Requirements:
- SMF 2.1.x
- PHP 7.0 or newer
Version History
Version 1.1.0 - Security, Pagination & Stability Improvements
This release introduces several important fixes and improvements to stream handling, administrative settings and saved custom streams.
- Improved Security - Custom stream names are now correctly escaped when displayed in editing forms, including when a form is redisplayed following a validation error. Previously saved names are handled without double escaping.
- Reliable Pagination - The "Load More" system now uses the exact last activity item, combining its timestamp with a unique identifier to avoid skipping or repeating activity created during the same second.
- Backward Compatibility - Older activity pagination links continue to function.
- Excluded Board Settings - Excluded boards are now consistently stored as a plain list of board IDs, with compatibility for previously saved setting formats.
- Custom Stream Limits - Setting the maximum number of custom streams to zero now hides members' existing saved streams as well as preventing their use.
- Non-Destructive Stream Restrictions - Saved custom streams are retained when disabled or when limits are reduced. They become available again if the limits are increased.
Recommended update for existing Activity Stream installations.
Version 1.0.0 - Initial Release
The original release introduced:
- Forum-wide activity timeline with daily grouping.
- New topics, replies, likes and member registration activity.
- All Activity, Following, Popular and My Activity streams.
- Custom stream creation and management.
- Member following system with follower statistics.
- Board permissions, ignore lists and privacy integration.
- Extension hooks for additional activity types.
- Administrative settings and permission controls.
Technical Notes
- 100% Hook Based - No modifications to SMF core files or theme templates.
- SMF 2.1.x Compatibility - Designed for the SMF 2.1 series.
- Existing Activity Data - Uses information already stored by SMF without additional activity tracking.
- Permission Aware - Respects board access, unapproved content and ignore lists.
- Extensible Architecture - Dedicated hooks allow compatible modifications to add new activity types.
- Reliable Pagination - Uses timestamp and unique item identification to avoid missing activity entries.
- Customisable Experience - Supports member following, saved streams and personalised filtering.
Credits
Developed by BoredSkull
License: ISC
Discover what's happening, follow the conversations and stay connected with your community.
Developed by BoredSkull
License: ISC
Discover what's happening, follow the conversations and stay connected with your community.