News:

This is just a chill growing forum to talk about anything legal!

Main Menu

Social Media Links

BoredSkull Mods · Deaks · Nov 18, 2026, 12:02 PM · Updated <strong>Today</strong> at 04:46 AM
Social Media Links - 1.0.2

Connect your community, one profile at a time.

by BoredSkull

SMF 2.1.x Compatible | Hook-Based Integration | No Core Edits



Give Your Community More Ways to Connect!

Social Media Links allows forum members to share their favourite social media profiles, displaying them as a clean, organised row of icons directly below their signature on every forum post.

No cluttered signatures, no complicated setup and no unnecessary modifications to SMF's core files.

Simply install, configure and let your members connect!

21 Supported Profile Types | Flexible Permissions | Easy Profile Management



How Does It Work?

Once a member adds their social media profiles, the corresponding icons automatically appear below their signature.

Forum Post
────────────────────────
Member's Signature
────────────────────────
Social Media Icons

Each icon links directly to the member's profile, allowing other community members to discover and follow them.

No manual BBCode or signature editing is required!



Supported Social Networks

Social Media Links supports 20 Supported Platforms + Personal Websites, covering popular social networks, creative communities, developer platforms and more.

Social Networks and Communities
  • Bluesky
  • Mastodon (any instance)
  • Pixelfed (any instance)
  • Threads
  • X (formerly Twitter)
  • Facebook
  • Instagram
  • Reddit
  • Discord
  • Telegram

Video, Streaming and Music
  • YouTube
  • TikTok
  • Twitch
  • Spotify
  • SoundCloud

Professional, Developer and Gaming Platforms
  • LinkedIn
  • GitHub
  • GitLab
  • Steam

Creators and Personal Websites
  • Patreon
  • Personal Website

Administrator Control: Each supported network can be individually enabled or disabled, allowing administrators to decide which platforms are available to their members.



Easy Profile Management

Members can add, update or remove their social media links directly from their forum profile.

Profile > Modify Profile > Social Media Links

The modification makes adding links straightforward by supporting multiple input formats.

Members can enter:
  • A username, such as name.bsky.social
  • A complete social media profile URL
  • A Mastodon address using @user@instance

Supported inputs are automatically processed into the appropriate profile links.

Simple for members. Easy to manage for administrators.



Link Validation and Security

Social Media Links includes link validation to help prevent misleading or disguised social media URLs.

For supported network profiles, links are checked against their respective network domains.

Features include:
  • Validation of supported social network URLs
  • Support for usernames and complete profile links
  • Compatibility with federated Mastodon and Pixelfed instances
  • Checks against unrelated domains masquerading as social network links
  • Permission-based control over link management and visibility



Font Awesome Icons

The modification uses Font Awesome Free to display recognisable social media icons without requiring individual image files.

By default, Font Awesome is loaded through the cdnjs CDN.

Administrators have three options:

  • Default CDN: Use the supplied cdnjs-hosted stylesheet.
  • Self-Hosted: Specify the URL of a locally hosted Font Awesome stylesheet.
  • Existing Theme Support: Leave the stylesheet setting blank if the forum theme already includes a suitable version of Font Awesome.

Important: Font Awesome 6.5 or newer is required for the Bluesky icon.

Font Awesome Free Licensing:
  • Icons: CC BY 4.0
  • Code: MIT



Advanced Permission Controls

Social Media Links integrates directly with SMF's existing permission system.

Administrators can decide who is allowed to add social media links, manage other members' links and view social media icons.

Permission Settings:

Admin > Permissions > General Permissions > Profile

Available permissions:
  • Add social media links below signature - Own profile / Any profile
  • See social media icons on posts

Default Permissions After Installation
  • Regular Members: Can add and edit their own social media links.
  • Global Moderators: Can manage social media links on any member's profile.
  • Everyone, including Guests: Can view social media icons on posts.

Post Count Based Permissions

Want to make social media links a benefit for established members?

You can configure permissions based on post count groups, allowing only members who meet a certain posting threshold to display their links.

For example, you could allow members with 50 or more posts to add social media links.

To enable this functionality, navigate to:

Admin > Permissions > Settings

Enable:

Enable permissions for post count based groups

Then configure the desired permissions for your post count groups.

Important: If a member loses permission to display their social media links, their icons are hidden automatically.

Their saved links are not deleted, meaning they can be displayed again if the member regains permission.



Administrator Configuration

All modification settings are conveniently located within the SMF administration panel.

Admin > Configuration > Modification Settings > Social Media Links

From here, administrators can:
  • Enable or disable individual social networks
  • Configure the Font Awesome stylesheet source
  • Choose between CDN, self-hosted or existing theme icon support

Permissions are managed separately through SMF's standard permission system.



Installation

Installing Social Media Links is straightforward and uses SMF's built-in Package Manager.

  • Step 1: Download the Social Media Links installation package.
  • Step 2: Navigate to Admin > Packages > Download Packages.
  • Step 3: Upload the package.
  • Step 4: Click Install Now.
  • Step 5: Review the available settings and permissions.

Once installed, members can begin adding their social media profiles immediately, provided they have the appropriate permissions.



No Core File Edits!

Hook-Based Integration for SMF 2.1.x

Unlike modifications that directly alter SMF's source files, Social Media Links uses SMF integration hooks.

The icons are displayed using SMF's built-in below signature output area in Display.template.php.

Benefits include:
  • No SMF core file modifications
  • No standard theme modifications required
  • Integration through SMF's existing hook system
  • Improved compatibility with SMF updates
  • Reduced potential for conflicts with other modifications
  • Simpler installation and uninstallation

Install the package, not a collection of manual code changes!



Custom Theme Compatibility

Most themes retaining SMF's standard signature output functionality should work without modification.

However, some heavily customised themes may have removed the built-in below-signature area.

If your theme does not include this area, the social media icons may not appear.

Custom Themes Only:

If the below-signature output area is missing, add the following code to your custom theme's Display.template.php, immediately after the signature output:

if (!empty($message['custom_fields']['below_signature']))
{
    echo '<div class="custom_fields_below_signature"><ul class="nolist">';
    foreach ($message['custom_fields']['below_signature'] as $custom)
        echo '<li class="custom ', $custom['col_name'], '">', $custom['value'], '</li>';
    echo '</ul></div>';
}

Note: This additional step is only necessary if your custom theme has removed the relevant SMF output area.

Standard SMF themes do not require this modification.



Uninstallation

Social Media Links can be uninstalled through SMF's Package Manager.

During uninstallation, you will have the option to select:

"Remove all data associated with this modification"

If selected, this removes:
  • Stored member social media links
  • Modification-specific permissions
  • Modification settings

Important: Selecting this option permanently deletes the stored social media information.

If you plan to reinstall the modification and wish to retain your members' links, leave this option unchecked.



Bring Your Community Together

Whether your members are content creators, gamers, developers, musicians or simply enjoy connecting across different platforms, Social Media Links makes it easier for everyone to share their online presence.

Lightweight. Customisable. Easy to Use.

20 Supported Platforms + Personal Websites | Flexible Permissions | Easy Profile Management

Connect your community, one profile at a time.

Developed by BoredSkull

Released under the ISC Licence

Awaiting Approval: https://custom.simplemachines.org/index.php?mod=4521

Open original forum topic

Topic screenshots

Topic screenshot: sml_1.pngTopic screenshot: sml_2.pngTopic screenshot: SM Links.png

Available downloads

SocialMediaLinks_1.0.2.zip
16.4 KB · ZIP
Download