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
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.
Code Select
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)
- Discord
- Telegram
Video, Streaming and Music
- YouTube
- TikTok
- Twitch
- Spotify
- SoundCloud
Professional, Developer and Gaming Platforms
- 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
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:
Code Select
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
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