News:

Check out The One I Lost - OUT NOW ONLY ON YOUTUBE

Main Menu

Rich Link Previews

BoredSkull Mods · Deaks · Nov 20, 2026, 09:00 AM · Updated Nov 20, 2026, 09:00 AM
Rich Link Previews v1.0.2
Turn Ordinary Links Into Beautiful, Informative Preview Cards!

By BoredSkull for SMF 2.1.x
ISC Licence



Overview

Why settle for plain URLs when your forum could display attractive, informative link previews?

Rich Link Previews brings modern link-sharing functionality to SMF, automatically transforming links shared by members into visually appealing preview cards featuring website titles, descriptions and thumbnails.

Whether members are sharing news articles, interesting websites, blog posts or useful resources, Rich Link Previews makes external content easier to recognise, explore and enjoy.

No special BBCode. No extra steps. Just paste a link and post!

When a message is submitted or edited, Rich Link Previews automatically identifies supported links and prepares preview cards beneath the post.

The result is a cleaner, more informative browsing experience without changing the way members normally use your forum.



Key Features

  • Automatic Link Detection
    Recognises ordinary URLs and links created using [url] or [iurl] BBCode. Members don't need to learn anything new.
  • Rich Website Information
    Retrieves Open Graph, Twitter Card and standard HTML metadata to display a website's title, description and thumbnail image.
  • Attractive Preview Cards
    Displays website information in a clean, responsive card beneath the post, making shared links easier to identify and explore.
  • Reliable Fallback Cards
    If a website blocks metadata requests or doesn't provide usable information, a basic card can still display its domain and link.
  • Works With Existing Posts
    Already have years of forum discussions? Use the administration maintenance tool to queue link previews for older posts in manageable batches of 100.
  • Background Processing
    External website information can be retrieved using SMF's background task system, allowing posts to save immediately without waiting for external websites to respond. Background fetching can also be disabled.
  • Stored Metadata
    Preview information is saved rather than retrieved every time somebody views a discussion. This avoids repeated requests to external websites when topics are opened.
  • Smart Link Exclusions
    Avoids generating unnecessary previews from links inside quotes, code blocks, image tags, spoilers and similar BBCode elements. Direct links to images and downloadable files are also excluded.
  • YouTube Compatibility
    YouTube links are deliberately excluded because SMF already supports video embedding. This also avoids unnecessary duplication when using the YouTube Video Card modification.
  • Domain Exclusion List
    Administrators can prevent previews from being generated for selected websites, including their subdomains.
  • Internal Forum Previews
    Links to topics and boards within your own SMF forum can receive dedicated preview cards using information from the forum database.

    Internal previews respect board permissions, ensuring members only see information from boards they're authorised to access.
  • Responsive Design
    Preview cards adapt to different screen sizes. On mobile devices, thumbnail images move above the text for improved readability.

    Translucent styling helps the cards blend naturally with both light and dark forum themes.



Security First

Fetching information from external websites requires careful security handling.

Rich Link Previews includes multiple safeguards designed to protect your forum when retrieving website metadata.

  • Only HTTP and HTTPS connections using standard ports are permitted.
  • Redirect destinations are checked before connections are allowed.
  • Private, loopback, link-local, CGNAT and reserved IP address ranges are blocked for both IPv4 and IPv6.
  • Connections are pinned to validated IP addresses to help prevent DNS rebinding attacks.
  • Only HTML responses are accepted for metadata extraction.
  • Downloads are limited by configurable size restrictions and can stop once the page's head section has been retrieved.
  • Website metadata is stored as plain text and safely escaped when displayed.

These protections help reduce the risks associated with retrieving information from untrusted external websites.



Administrator Configuration

Rich Link Previews includes a dedicated administration page:

Admin > Configuration > Modifications > Rich Link Previews

Administrators can configure:

  • Enable or disable Rich Link Previews.
  • Enable or disable previews for internal forum links.
  • Choose between 1 and 20 previews per post.
  • Enable or disable thumbnail images.
  • Configure external request timeouts.
  • Set maximum metadata download sizes.
  • Adjust the metadata refresh interval.
  • Exclude specific domains and their subdomains.
  • Control background metadata fetching.
  • Queue previews for existing posts using maintenance tools.

This gives administrators control over how link previews operate and how external requests are handled.



What's New in v1.0.2?

Version 1.0.2 is a maintenance update focusing on compatibility, security and reliability.

  • Improved PHP Compatibility - Better handling of environments without the optional mbstring extension.
  • Safer Internal Previews - Improved escaping of internal card fields.
  • Concurrent Edit Protection - Prevents outdated preview information being applied after overlapping post edits.
  • Cleaner Uninstallation - Pending background fetch jobs are removed during uninstallation without deleting stored preview metadata.
  • Safe Upgrades - Existing configuration settings and previously generated previews are preserved.

Recommended update for existing Rich Link Previews installations.



Installation & Requirements

Compatibility: SMF 2.1.x

Requirements:
  • PHP 7.0 or newer.
  • PHP cURL extension for external website previews.
  • PHP DOM and intl extensions are optional but recommended.

Install using SMF's Package Manager:

Admin > Packages > Download Packages > Upload Package > Install Now

Once installed, configure the modification through its administration settings.



Why Choose Rich Link Previews?

Because links are meant to be explored, not deciphered!

Rich Link Previews makes shared content more informative, helps members discover interesting resources and gives your forum a more polished, modern appearance.

With automatic detection, stored metadata, background processing, flexible administration controls and security-conscious fetching, it enhances everyday link sharing without adding complexity for members.

Paste. Post. Preview. It's that simple!



Developed by BoredSkull
Licence: ISC

Making every shared link a little more interesting.

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

Open original forum topic

Topic screenshots

Topic screenshot: Screenshot (12).pngTopic screenshot: Screenshot.png

Available downloads

RichLinkPreviews_1.0.2.zip
23.3 KB · ZIP
Download