Mentions Expanded - v1.1.0
Advanced Member, Group & Community Mentions for SMF 2.1.x
By BoredSkull (https://boredskull.net/)
OverviewTake 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- @everyone - 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.
- @here - 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, @Global Moderator 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 ProcessingMentions 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 & ScalabilityMass 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 @everyone mentions from slowing down post submission.
- Built for Larger Communities - Designed to accommodate forums with substantial membership.
Display & CustomisationAdministrators can optionally enable visual highlighting for expanded mentions within forum posts.
- @everyone Highlighting - Make community-wide mentions stand out.
- @here 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 & ConfigurationInstall through
Admin > Packages > Download Packages > Upload Package > Install Now.
Step 1 - Enable Core MentionsEnsure SMF's built-in mention functionality is enabled:
Admin > Configuration > Features and OptionsStep 2 - Configure Mentions ExpandedNavigate to:
Admin > Configuration > Modification Settings > Mentions ExpandedConfigure the available features, online activity window, permitted membergroups and optional mention highlighting.
Step 3 - Assign PermissionsNavigate to your membergroup's board permissions and configure:
- Use @everyone - Permission to notify all eligible board members.
- Use @here - 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.
CreditsMentions 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 BoredSkullhttps://boredskull.net
Awaiting Approval: https://custom.simplemachines.org/index.php?mod=4524
Mod has been updated to 1.1.0 due to a significant bug found on live testing.
Nice. Now I just need an active forum where I could actually put it to use :P
The only active forum I run is seniorsandfriends.org and I don't really have a reason to use it there (though @everyone might be nice for announcing things).
Quote from: Oldiesmann on Nov 20, 2026, 09:13 PMNice. Now I just need an active forum where I could actually put it to use :P
The only active forum I run is seniorsandfriends.org and I don't really have a reason to use it there (though @everyone might be nice for announcing things).
Very nice forum! I might need it being that I'm almost 65, eventually. LOL
Quote from: Old Mellow on Nov 20, 2026, 09:20 PMQuote from: Oldiesmann on Nov 20, 2026, 09:13 PMNice. Now I just need an active forum where I could actually put it to use :P
The only active forum I run is seniorsandfriends.org and I don't really have a reason to use it there (though everyone might be nice for announcing things).
Very nice forum! I might need it being that I'm almost 65, eventually. LOL
I can't take all the credit for it. I created it for someone else years ago (I had been helping out with a different forum she was a member of for a while, and she had me set that up when a different seniors forum she was a member of shut down so she and her online friends could continue chatting with one another. Unfortunately she passed away several years ago but I kept the forum going since I'd already been hosting it for years - I took control of the domain when she passed away thanks to the generosity of the registrar she was using).
Wait a minute! I'm on that site but didn't recognize it. LOL