News:

**NEW** Check Out Ashes Beneath The Halo - OUT NOW ONLY ON YOUTUBE **NEW**

Main Menu

Social Media Links

Started by Deaks, Nov 18, 2026, 12:02 PM

Previous topic - Next topic

0 Members and 1 Guest are viewing this topic.

Deaks

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
  • 0 reactions

    Members who reacted


Deaks

Mod has been updated to 1.0.2 as a small bug was found in testing.
  • 0 reactions

    Members who reacted


lurkalot

Loving this mod, I'm trying it out on one of my sites now. Installs and works very nicely.

If I had one very slight negative: The media platforms listed on the left, and the input fields on the right, and because I have dodgy eyesight I did fill in the wrong field. Maybe some sort of separator for each line, or to save space a faint alternating colour for each line might help.
  • 0 reactions

    Members who reacted


Deaks

ill add to roadmap for a minor update :D
  • 0 reactions

    Members who reacted


lurkalot

Thanks Deaks.  I realise my previous suggestions might spoil the look somewhat, so what about just moving the two columns closer together, that would also make it easier.  ;)
  • 0 reactions

    Members who reacted


Deaks

ive added accesbility options to roadmap so could be hover effect or something rather get the first out then can add features as tehy come up, its something i never thought of so def will be added in an update
  • 0 reactions

    Members who reacted


Deaks

@lurkalot I have added these into the next version
  • 0 reactions

    Members who reacted


lurkalot

Quote from: Deaks on Nov 21, 2026, 12:49 PM@lurkalot I have added these into the next version

Cool, thank you.  I look forward to trying it.  ;)
  • 👍 1

    Members who reacted


shawnb61

#8
Works perfectly as near as I can tell.  Permissions worked cleanly.  Admin options all appeared to work.  All my links seemed to work just fine.

Simple & clean.

Two minor nits:
1) Admin submenu is not actually *under* Modification Settings.  It became part of the 'Miscellaneous' one.  Probably fine where it is.  Made it a little harder to find - I was expecting a submenu.  The location doesn't match the description above.  (Admin > Configuration > Modification Settings > Social Media Links)
2) Not sure I like the row of dots above the icons.  My personal preference would be no row of dots.  Keep it clean.

Neither affect anything functional.  Minor visual things.

  • 0 reactions

    Members who reacted