huoxin/relative-url

Converts internal Url to relative Url for multi-domain support

1.0.0 2025-12-19 15:03 UTC

Requires

• flarum/core: ^1.2.0

Requires (Dev)

• flarum/testing: ^1.0.0

MIT

• huoxin

• url
• links
• relative
• multi-domain
• flarum

README

English | 简体中文

A Flarum extension that converts internal URLs to relative paths for multi-domain support.

The Problem

When your Flarum forum setup multi-domain by editing config.php:

'url' => 'https://' . \Illuminate\Support\Arr::get($_SERVER, 'HTTP_HOST', 'forum1.org'),

If an user post links with absolute URLs:

Check out https://forum1.org/d/123

Another user on forum2.org clicks this link, they're redirected to forum1.org, losing their session and cookies.

The Solution

This extension automatically converts internal URLs to relative paths:

• https://forum1.org/d/123 → /d/123
• https://forum2.org/u/username → /u/username

Users stay on their current domain when clicking internal links.

Features

• ✅ Converts regular links in post content
• ✅ Converts mention URLs (workaround for flarum/framework#4226 )

Installation

Install with composer:

composer require huoxin/relative-url:"*"

Configuration

1. Go to Admin → Extensions → Relative Url
2. Add your internal domains (one per line):

forum1.org
forum2.org
forum.example.com

Updating

composer update huoxin/relative-url:"*"
php flarum migrate
php flarum cache:clear

Links

• Packagist
• GitHub
• Discuss