Mentions Expanded

BoredSkull Mods · Deaks · Nov 19, 2026, 12:42 PM · Updated Nov 21, 2026, 10:13 AM
Mentions Expanded - v1.1.0
Advanced Member, Group & Community Mentions for SMF 2.1.x
By BoredSkull



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

  • @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 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 @everyone 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.

  • @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 & 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 @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.



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

Open original forum topic

Topic screenshots

Topic screenshot: Screenshot (4).png

Available downloads

MentionsExpanded_1.1.0.zip
14.6 KB · ZIP
Download