Title: Onartline Multisite Domain Mapping
Author: onartline
Published: <strong>31 Luulyo, 2026</strong>
Last modified: 20 Agoosto, 2026

---

Raadi kaabayaal

![](https://ps.w.org/onartline-multisite-domain-mapping/assets/banner-772x250.png?
rev=3630157)

![](https://ps.w.org/onartline-multisite-domain-mapping/assets/icon-256x256.png?
rev=3630157)

# Onartline Multisite Domain Mapping

 Qore [onartline](https://profiles.wordpress.org/onartline/)

[Soo Rog](https://downloads.wordpress.org/plugin/onartline-multisite-domain-mapping.1.0.1.zip)

 * [Faahfaahin](https://so.wordpress.org/plugins/onartline-multisite-domain-mapping/#description)
 * [Dibu-eegisyo](https://so.wordpress.org/plugins/onartline-multisite-domain-mapping/#reviews)
 *  [Rakibaad](https://so.wordpress.org/plugins/onartline-multisite-domain-mapping/#installation)
 * [Horumarinta](https://so.wordpress.org/plugins/onartline-multisite-domain-mapping/#developers)

 [Taageero](https://wordpress.org/support/plugin/onartline-multisite-domain-mapping/)

## Sharraxaad

Onartline Multisite Domain Mapping allows you to map any domain to a site in your
WordPress Multisite network. It is lightweight, easy to configure, and designed 
for both beginners and experienced administrators.

**Features:**
 – Map multiple domains to any site in your network – Set a primary
domain with automatic redirect – Force HTTPS per domain or globally – 301-redirect
support for non-primary domains – DNS information display for site administrators–
Site-level domain management (optional, controlled by Super Admin)

**Requirements:**
 – PHP 8.3 or higher – WordPress 7.0 or higher – WordPress Multisite
installation

## Sawir-shaashado

[⌊Add Domain – form for creating new domain mappings⌉⌊Add Domain – form for creating
new domain mappings⌉[

Add Domain – form for creating new domain mappings

[⌊Domain Mapping Overview – manage all mapped domains⌉⌊Domain Mapping Overview –
manage all mapped domains⌉[

Domain Mapping Overview – manage all mapped domains

[⌊Domain Mapping Settings – HTTPS, redirects and DNS information⌉⌊Domain Mapping
Settings – HTTPS, redirects and DNS information⌉[

Domain Mapping Settings – HTTPS, redirects and DNS information

## Rakibaad

**Important – Please Read Before Installing**

This plugin is recommended for **new WordPress Multisite network installations**.

Installing Onartline Multisite Domain Mapping on an **already existing, active Multisite
network is not recommended** and is done entirely at your own risk. It may interfere
with existing domain configurations, redirects, or other plugins that handle similar
functionality.

If you already run a Multisite network and want to use this plugin, it is strongly
recommended to set up a **fresh, new Multisite installation** first, and then **
migrate or import your existing content and data** into that new installation – 
rather than adding this plugin to your current, active network.

#### 1. Upload the Plugin

Upload the `onartline-multisite-domain-mapping` folder to `/wp-content/plugins/`
or install it directly via the WordPress Network Admin under **Plugins  Add New**.

#### 2. Activate the Plugin

Activate the plugin via **Network Admin  Plugins  Network Activate**.

#### 3. Set Up sunrise.php

Onartline Multisite Domain Mapping requires `sunrise.php` to be loaded before WordPress
initializes.

**Automatic installation:** If `wp-content/` is writable, the plugin copies `sunrise.
php` automatically on activation. You will see a success notice in the Network Admin.

**Manual installation:** If the automatic copy fails, copy `sunrise.php` manually:

 1. Copy `sunrise.php` from the plugin folder to `/wp-content/sunrise.php`
 2. Add the following line to your `wp-config.php` – directly before `require_once 
    ABSPATH . 'wp-settings.php';`:
 3. define( ‘SUNRISE’, true );

#### 4. Configure wp-config.php

Make sure the following line is present in your `wp-config.php`:

    ```
    define( 'SUNRISE', true );
    ```

#### 5. ⚠️ Plesk Users – Disable “Preferred Domain”

If your server runs Plesk, you **must** disable the “Preferred Domain” setting for
each domain you want to map. Otherwise Plesk will intercept the redirect before 
WordPress can handle it, causing redirect loops or broken mappings.

 1. Log in to Plesk
 2. Go to **Websites & Domains  your domain  Hosting Settings**
 3. Set **Preferred Domain** to **None**
 4. Save the settings

#### 6. Add Your First Domain Mapping

 1. Go to **Network Admin  Domain Mapping  Add Domain**
 2. Select the target site
 3. Enter the domain (without `http://` or `https://`)
 4. Optionally set it as Primary Domain and enable HTTPS
 5. Save

#### 7. Configure DNS

Point your domain to your server by setting the following DNS records:

 * **A Record** – Name: `@` – Value: Your server’s IPv4 address
 * **AAAA Record** – Name: `@` – Value: Your server’s IPv6 address (optional, if
   available)
 * **CNAME Record** – Name: `www` – Value: Your primary domain or server CNAME

The required values are displayed in **Network Admin  Domain Mapping  Settings**.

#### 8. Uninstallation

When you deactivate and delete Onartline Multisite Domain Mapping via **Network 
Admin  Plugins**, the plugin automatically removes:

 * The plugin files
 * The `sunrise.php` file from `/wp-content/`
 * The database tables (only if “Delete data on uninstall” was enabled in the plugin
   settings)

**Important – Manual step required**

The plugin **cannot automatically remove** the following line from your `wp-config.
php`:

    ```
    define( 'SUNRISE', true );
    ```

This line was added manually during installation and must also be **removed manually**
after uninstalling the plugin. If this line remains in `wp-config.php` after `sunrise.
php` has been deleted, WordPress will try to load a file that no longer exists, 
resulting in warnings such as:

    ```
    Warning: include_once(.../wp-content/sunrise.php): Failed to open stream: No such file or directory
    ```

and potentially `headers already sent` errors on the login page or elsewhere.

**To fix this:** Open your `wp-config.php` and remove (or comment out) the line `
define( 'SUNRISE', true );`, then save the file.

## SBI

### Can I install this plugin on an existing, active Multisite network?

This is not recommended and would be done entirely at your own risk. Onartline Multisite
Domain Mapping is designed for new Multisite installations. If you already run an
active Multisite network, it is strongly recommended to set up a fresh installation
first and migrate your existing content into it, rather than adding this plugin 
to your current network. Please see the note at the beginning of the **Installation**
section for details and our recommended approach.

### The domain redirects in a loop – what should I do?

Check if Plesk “Preferred Domain” is set. Set it to “None”. Also verify that `define('
SUNRISE', true );` is present in `wp-config.php`.

If you are using the plugin’s 301-redirect feature, check the hosting settings for
the specific domain (e.g. in Plesk, cPanel, or other hosting panels) and disable
any existing redirect rules there if necessary.

If 301 redirects are already configured at the hosting level for that domain and
you want to keep them, disable the 301-redirect option in the plugin settings instead–
otherwise a redirect loop will occur.

### sunrise.php was not copied automatically – what now?

Copy `sunrise.php` manually from the plugin folder to `/wp-content/sunrise.php` 
and add `define( 'SUNRISE', true );` to your `wp-config.php`.

### The plugin is not working on my Website – why?

Onartline Multisite Domain Mapping requires a WordPress Multisite installation and
PHP 8.3+. Single-site installations are not supported.

### Can site administrators manage their own domains?

Yes – the Super Admin can enable this under **Network Admin  Domain Mapping  Settings
Site-Admin Domain Mapping**.

### Does the plugin support automatic updates?

Yes – once published on the WordPress plugin repository, automatic updates are fully
supported.

### I uninstalled the plugin, but now I see errors about sunrise.php or “headers already sent” – what happened?

This happens if the line `define( 'SUNRISE', true );` was not removed from `wp-config.
php` after uninstalling the plugin. Since `sunrise.php` no longer exists after uninstallation,
WordPress fails when trying to load it. Simply remove that line from `wp-config.
php` to resolve the issue.

## Dibu-eegisyo

Ma jiraan wax dibu-eegis ah oo ku saabsan kaabahan.

## Ka-qaybgalayaasha & Horumariyayaasha

“Onartline Multisite Domain Mapping” waa softiweer il furan. Dadka soo socda ayaa
wax ku biiriyay kaabahan.

Ka-qaybgalayaasha

 *   [ onartline ](https://profiles.wordpress.org/onartline/)

[Ku tarjun “Onartline Multisite Domain Mapping” luqaddaada.](https://translate.wordpress.org/projects/wp-plugins/onartline-multisite-domain-mapping)

### Ma xiisaynaysaa horumarinta?

[Baadh koodka](https://plugins.trac.wordpress.org/browser/onartline-multisite-domain-mapping/),
fiiri [bakhaarka SVN](https://plugins.svn.wordpress.org/onartline-multisite-domain-mapping/),
ama iska qor [diiwaanka horumarinta](https://plugins.trac.wordpress.org/log/onartline-multisite-domain-mapping/)
adigoo adeegsanaya [RSS](https://plugins.trac.wordpress.org/log/onartline-multisite-domain-mapping/?limit=100&mode=stop_on_copy&format=rss).

## Isbeddellada

#### 1.0.1

 * Fix: Corrected cache invalidation after saving a new domain in the site settings,
   so newly added domains resolve correctly right away.
 * Fix: Resolved a parse error caused by duplicate methods defined outside the omdm_Login_Handler
   class.
 * Fix: Domain mapping now correctly excludes login, AJAX, and REST requests.
 * Fix: Corrected default values in set_default_options().
 * New: Added IPv6 support to the DNS information field on the settings page.
 * New: Introduced consistent format validation for IPv4, IPv6, and CNAME entries.

#### 1.0.0

 * Initial release

## Meta

 *  Version **1.0.1**
 *  Last updated **19 saac kahor**
 *  Active installations **In ka yar 10**
 *  WordPress version ** 7.0 ama ka sareeya **
 *  Tested up to **7.1**
 *  PHP version ** 8.3 ama ka sareeya **
 *  Language
 * [English (US)](https://wordpress.org/plugins/onartline-multisite-domain-mapping/)
 * Tags
 * [custom domain](https://so.wordpress.org/plugins/tags/custom-domain/)[domain mapping](https://so.wordpress.org/plugins/tags/domain-mapping/)
   [multisite](https://so.wordpress.org/plugins/tags/multisite/)[network](https://so.wordpress.org/plugins/tags/network/)
 *  [Aragti Sare](https://so.wordpress.org/plugins/onartline-multisite-domain-mapping/advanced/)

## Qiimeynta

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/onartline-multisite-domain-mapping/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/onartline-multisite-domain-mapping/reviews/)

## Ka-qaybgalayaasha

 *   [ onartline ](https://profiles.wordpress.org/onartline/)

## Taageero

Ma heysaa waxaad dhahdo? Caawimaad ma u baahan tahay?

 [Eeg madasha taageerada](https://wordpress.org/support/plugin/onartline-multisite-domain-mapping/)

## Ku deeq

Ma jeclaan lahayd inaad taageerto horumarinta kaabahan?

 [ Ugu deeq kaabahan ](https://paypal.me/onartline)