Social Media Links - 1.0.2
Connect your community, one profile at a time.
by BoredSkull (https://boredskull.net/)
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 NetworksSocial 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 WebsitesAdministrator Control: Each supported network can be individually enabled or disabled, allowing administrators to decide which platforms are available to their members.
Easy Profile ManagementMembers 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 SecuritySocial 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 IconsThe 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 ControlsSocial 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 PermissionsWant 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 > SettingsEnable:
Enable permissions for post count based groupsThen 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 ConfigurationAll 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.
InstallationInstalling 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 CompatibilityMost 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.
UninstallationSocial 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 (https://boredskull.net/)
Released under the ISC Licence
Awaiting Approval: https://custom.simplemachines.org/index.php?mod=4521
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.
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. ;)
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
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.
An option to choose a separator type or not sounds good as for placement. This is something im always looking at where is best.