Overview
Take SMF's built-in mention system to the next level with Mentions Expanded, a powerful modification that introduces community-wide, online member and membergroup mentions directly into forum discussions.
While SMF 2.1 already supports mentioning individual members, Mentions Expanded extends this functionality by allowing authorised members to notify entire groups, everyone with access to a board, or members currently online.
Whether you're sharing an important community announcement, contacting your moderation team or starting a discussion with active members, Mentions Expanded makes reaching the right audience easier.
100% Hook Based - No core or theme file edits required!
Built around SMF's existing mention system, the modification integrates with native notifications, permissions and member preferences.
Mention Types
- - Community-Wide Mentions
Notify all activated members who have permission to view the board where the mention is posted.
Ideal for important announcements, community updates or discussions requiring wider attention.
Only authorised members can use this feature, helping prevent unnecessary mass notifications. - - Online Member Mentions
Notify members considered online when the post is submitted.
The online activity window is configurable through the administration panel, allowing administrators to determine how recently a member must have been active to qualify.
Useful for time-sensitive discussions, live events or contacting currently active members. - @groupname - Membergroup Mentions
Mention an entire membergroup using its name.
For example, can notify eligible members of the Global Moderator group.
Administrators control which membergroups are available for mentions, preventing unrestricted access to sensitive or administrative groups.
Notification Features
- Native SMF Alerts - Uses SMF 2.1's existing "mentioned you" notification system.
- Member Preferences - Respects each member's mention alert and email notification settings.
- Permission Aware - Only members with access to the relevant board can receive notifications.
- Account Restrictions - Excludes banned and unactivated accounts.
- Ignore List Support - Members ignoring the original poster will not receive mention notifications.
- Duplicate Prevention - Members receive only one notification per post, even when included in multiple mention types.
- Smart Edit Handling - Editing a post only notifies newly added mention targets.
- Approval Awareness - Unapproved posts do not trigger mention notifications.
Intelligent Mention Processing
Mentions Expanded is designed to recognise valid mentions while avoiding unnecessary notifications.
- Quote Detection - Mentions inside quoted content are ignored.
- Code Protection - Mentions within code blocks do not trigger alerts.
- NoBBC Support - Mentions inside nobbc sections are excluded.
- Combined Mentions - Individual, group and community mentions are consolidated to prevent duplicate alerts.
- New Targets Only - Existing recipients are not notified again when a post is edited.
This helps keep notifications relevant while preserving the familiar behaviour of SMF's native mention system.
Performance & Scalability
Mass mentions can potentially notify hundreds or thousands of members, so performance is an important consideration.
Rather than processing every notification during post submission, Mentions Expanded uses SMF background tasks to distribute notifications efficiently.
- Background Processing - Notifications are handled asynchronously after posting.
- Batch Notifications - Large recipient lists are processed in manageable batches.
- Reduced Posting Delays - Helps prevent large mentions from slowing down post submission.
- Built for Larger Communities - Designed to accommodate forums with substantial membership.
Display & Customisation
Administrators can optionally enable visual highlighting for expanded mentions within forum posts.
- Highlighting - Make community-wide mentions stand out.
- Highlighting - Visually identify mentions directed at active members.
- @groupname Highlighting - Distinguish membergroup mentions from ordinary text.
- Optional Styling - Highlighting can be enabled or disabled through the modification settings.
Installation & Configuration
Install through Admin > Packages > Download Packages > Upload Package > Install Now.
Step 1 - Enable Core Mentions
Ensure SMF's built-in mention functionality is enabled:
Admin > Configuration > Features and Options
Step 2 - Configure Mentions Expanded
Navigate to:
Admin > Configuration > Modification Settings > Mentions Expanded
Configure the available features, online activity window, permitted membergroups and optional mention highlighting.
Step 3 - Assign Permissions
Navigate to your membergroup's board permissions and configure:
- Use - Permission to notify all eligible board members.
- Use - Permission to notify currently online members.
- Use @groupname - Permission to mention approved membergroups.
Important: By default, these permissions are restricted to administrators. Other groups must be granted access manually.
This ensures mass notifications remain under administrative control.
Technical Notes
- 100% Hook Based - No SMF core files or theme templates are modified.
- SMF 2.1.x Compatibility - Developed specifically for the SMF 2.1 series.
- Native Integration - Extends SMF's existing mention and notification functionality.
- Permission Controlled - Separate permissions for all three expanded mention types.
- Background Tasks - Processes large notification batches without holding up normal posting.
- Privacy Aware - Respects board visibility, ignore lists and member notification preferences.
- Duplicate Protection - Prevents multiple notifications to the same recipient for a single post.
Credits
Mentions Expanded builds upon the existing mention functionality included with SMF 2.1, extending it with additional mention types, administrative controls and notification processing.
Developed by BoredSkull
https://boredskull.net
Awaiting Approval: https://custom.simplemachines.org/index.php?mod=4524