Automattic

Ron Rennick

Donncha O Caoimh (a11n)

<p>This plugin allows users of a WordPress MU site or WordPress 3.0 network to map their blog/site to another domain.</p>
<p>It requires manual installation as one file must be copied to wp-content/. When upgrading the plugin, remember to update domain_mapping.php and sunrise.php. Full instructions are on the Installation page and are quite easy to follow. You should also read <a href="http://ottopress.com/2010/wordpress-3-0-multisite-domain-mapping-tutorial/" rel="nofollow ugc">this page</a> too.</p>
<p>Super administrators must configure the plugin in Super Admin->Domain Mapping. You must enter the IP or IP addresses (comma deliminated) of your server on this page. The addresses are purely for documentation purposes so the user knows what they are (so users can set up their DNS correctly). They do nothing special in the plugin, they’re only printed for the user to see.</p>
<p>You may also define a CNAME on this page. It will most likely be the domain name of your network. See below for some restrictions and warnings.</p>
<p>Your users should go to Tools->Domain Mapping where they can add or delete domains. One domain must be set as the primary domain for the blog. When mapping a domain, (like ‘example.com’) your users must create an A record in their DNS pointing at that IP address. They should use multiple A records if your server uses more than one IP address.<br />
If your user is mapping a hostname of a domain (sometimes called a “subdomain”) like www.example.com or blog.example.com it’s sufficient to create a CNAME record pointing at their blog url (NOT IP address).</p>
<p>The login page will almost always redirect back to the blog’s original domain for login to ensure the user is logged in on the original network as well as the domain mapped one. For security reasons remote login is disabled if you allow users to use their Dashboard on the mapped domain.</p>
<p>Super admins can now choose to either allow users to setup DNS ANAME records by supplying an IP (or list of IP addresses) or set a CNAME but not both (entering a CNAME for the end user voids the use of IP’s)</p>
<p>There is a lot of debate on the handling of DNS using CNAME and ANAME so both methods are available depending on your preference and setup.</p>
<p>Things to remember:</p>
<ul>
<li>CNAME records that point to other CNAME records should be avoided (RFC 1034 section 5.2.2) so only tell your end users to use your chosen domain name as their CNAME DNS entry if your domain name is an ANAME to an IP address (or addresses)</li>
<li>Only use the CNAME method if your main domain is an ANAME of an IP address. This is very important. How do you know? Check your dns or ask your hosting company.</li>
<li>Giving your users the option to just use your chosen domain name and not an IP (or list of IP’s) to set as their CNAME will make administration of your WordPressMU blog platform or WordPress 3.0 network easier, an example of this would be purchasing/deploying a new server or indeed adding more servers to use in a round robin scenario. Your end users have no need to worry about IP address changes.</li>
<li>Finally, telling your end users to use an ANAME IP or CNAME domain name is up to you and how your systems are deployed.</li>
<li>Further Reading: http://www.faqs.org/rfcs/rfc2219.html</li>
<li>For localization: place translation files (ie. wordpress-mu-domain-mapping-xx_XX.mo) in the directory wp-content/plugins/wordpress-mu-domain-mapping/languages. You will probably have to create that directory yourself.</li>
</ul>
<h3>Action Hooks</h3>
<p>You can now hook into certain parts of the domain_mapping mu-plugin to enable you to extend the features that are built in without the need to modify this plugin. To do this, just create a script within the mu-plugins dir that is called AFTER this plugin (eg, call it domain_mapping_extended.php).</p>
<ul>
<li><code>dm_echo_updated_msg</code></li>
</ul>
<p>This hook is for when you want to add extra messages for your end users when they update their settings, the current usage would be to remove the existing action and replace it with your own as shown within the example further down the page.</p>
<ul>
<li><code>dm_handle_actions_init</code></li>
</ul>
<p>Before we add our own handlers for our users wanting to update their mappings, we can use this action to maybe connect to your datacenter API ready for communication.  An example would be to load an API class and connect before we send and recieve XML queries. Once again, see the example down the page. Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_handle_actions_add</code></li>
</ul>
<p>When an user adds a domain name to their mappings, this action can be used to perform other tasks on your server.  An example would be to check the user has already set up the DNS records for the name to correctly point to your server.  Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_handle_actions_primary</code></li>
</ul>
<p>This may or may not be commonly used in most cases but is there just in case. Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_handle_actions_del</code></li>
</ul>
<p>When an user deletes one of their domain mappings, this action can be used to reverse what dm_handle_actions_add has done.  An example would be to remove the domain mapping from your server using your datacenter’s API.  Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_delete_blog_domain_mappings</code></li>
</ul>
<p>If the blog is ever deleted and you make use of handle_actions, then this action will enable you to tidy up.  An example would be when an user has set up multiple domain mappings and the blog is deleted, your function can remove any mess left behind.  Your function can make use of the $domains array (numbered array of domains).  NOTE, this will also be called if the user has no mappings, care should be taken in the case of an empty array.</p>
<h4>EXAMPLE USAGE</h4>
<pre><code><?php // Filename: mu-plugins/domain_mapping_extended.php


// NOTE,
//  This example will not 'just work' for anyone, it is to show basic
//  usage of dm_echo_updated_msg, dm_handle_actions_init and
//  dm_handle_actions_add


// We do not need translations but would really like a message when a
// users DNS entry is not ready

function dm_echo_extended_updated_msg() {
    switch( $_GET[ 'updated' ] ) {
        case "add":
            $msg = 'You have added a new domain name.';
            break;
        case "exists":
            $msg = 'That domain name already exists, please try again.';
            break;
        case "primary":
            $msg = 'New primary domain created - enjoy!';
            break;
        case "del":
            $msg = 'The domain name has been removed.';
            break;
        case "dnslookup":
            $msg = 'The domain is not pointing to ' .
            get_site_option( 'dm_cname' ) . ', please set up your DNS.';
        break;
    }
    echo "<div class='updated fade'><p>$msg</p></div>";
}
// REMOVE THE ORIGINAL MESSAGES
remove_action('dm_echo_updated_msg','dm_echo_default_updated_msg');
// REPLACE WITH OUR OWN
add_action('dm_echo_updated_msg','dm_echo_extended_updated_msg');


// Prepare to use our Datacenter API

function dm_extended_handle_actions_init($domain) {
    global $datacenter_api;
    // There is a good chance we will be accessing the datacentre API
    require_once(dirname(__FILE__) ."/classes/xmlAbstract.class.php");
    require_once(dirname(__FILE__) ."/classes/xmlParserClass.php");
    require_once(dirname(__FILE__) ."/classes/datacenterAPIClass.php");
    $datacenter_api = new datacenter_api('MY_API_KEY', 'API_TYPE');
}
$datacenter_api = null;
add_action('dm_handle_actions_init', 'dm_extended_handle_actions_init');


// Check the users DNS is ready to go (we are using the CNAME option)
// then add the mapping to the datacenter API

function dm_extended_handle_actions_add($domain) {
    global $datacenter_api;
    // Check the domain has the correct CNAME/ANAME record
    $dmip = gethostbyname(get_site_option( 'dm_cname' ));
    $urip = gethostbyname($domain);
    if ($dmip != $urip) {
        wp_redirect( '?page=domainmapping&updated=dnslookup' );
        exit;
    }
    $datacenter_api->add_mapping($domain);
}
add_action('dm_handle_actions_add', 'dm_extended_handle_actions_add');
?>
</code></pre>


WordPress MU Domain Mapping

Successfully installed and configured in my site. Thank you! :-)

Works well

This plugin saved me so much work. Works great.

Perfect

The official WordPress Codex states: "In WordPress 4.5+, domain mapping is a native feature." 

Unfortunately, this plugin is no longer maintained, even though it is still the best, safest and easiest way to ensure perfect redirection to to correct (sub) blog. 

The mentioned define('COOKIE_DOMAIN', $_SERVER['HTTP_HOST']); often results in wrong redirections to the main blog:
In WordPress Network Admin: http://www.mydomain.org/ will likely make typing mydomain.org redirect to the main blog: https://example.com/?signup=new

At the time of writing this review I am still very happily using WordPress MU Domain Mapping on WordPress MultiSite 5.7.1-alpha-50553, PHP 8.0.2. to ensure that my visitors end up on the correct blog (http, https, with and without www).

In wp-config.php: 
define('MULTISITE', true);
define('SUBDOMAIN_INSTALL', true);
define('PATH_CURRENT_SITE', '/');
define('SITE_ID_CURRENT_SITE', 1);
define('BLOG_ID_CURRENT_SITE', 1);

/* Prevent redirection to /?signup=new */
define('NOBLOGREDIRECT', 'https://www.main-domain.com');
define('SUNRISE', 'on');



The defined COOKIE_DOMAIN will be set by this plugin to the correct url of all your blogs.

Still the best solution!

Excellent, minimalistic plugin that still works 8 years after its last update.

Still works with WP 5.3 👍

Map any blog/site on a WordPressMU or WordPress 3.X network to an external domain.

Freemius

Gaucho Plugins

Brandon Ernst

Wombat Plugins

patrickposner

<p><strong>Domain Mapping System</strong> is the best way to manage multiple domains on your WordPress site and point them to any published resource, including Posts, Pages, Products, Categories, or other Custom Post Types and Taxonomies.</p>
<p>Whether you’re just looking for the simplicity of multiple domain mapping in a single WordPress site, or you’re creating a more complex multi-pronged WordPress project, <a href="https://domainmappingsystem.com?utm_source=wporg&utm_medium=readme&utm_campaign=dms" rel="nofollow ugc">Domain Mapping System</a> can save a great deal of time and hassle over using multisite or creating standalone WordPress installs.</p>
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/mznQjxemxcE?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span>
<h3>EXAMPLE USE-CASES</h3>
<ul>
<li>Targeting specific audiences with branded domains, such as by country or language. </li>
<li>Organizations that want a different section of their website for each of their physical locations. </li>
<li>Expanding site reach to new audiences/locations without changing your primary domain. </li>
<li>Saving time over Multisite, or supplementing a Multisite with Microsite capabilities </li>
</ul>
<p>🎬 <a href="https://domain-mapping-system-demo.xyz/" rel="nofollow ugc">TRY THE LIVE DEMO ></a></p>
<p>🌱 <a href="https://domainmappingsystem.com/?utm_source=wporg&utm_medium=readme&utm_campaign=dms#pricing" rel="nofollow ugc">PLANS & PRICING ></a></p>
<p>🚧 <a href="https://domainmappingsystem.com/roadmap/?utm_source=wporg&utm_medium=readme&utm_campaign=dms" rel="nofollow ugc">ROADMAP ></a></p>
<h3>🔢 MULTIPLE DOMAINS IN A SINGLE WORDPRESS SITE</h3>
<blockquote>
<p>Assign content to each domain from a single WordPress Admin Dashboard.</p>
</blockquote>
<h3>🚀 MAP UNLIMITED ALIAS DOMAINS COMPLETELY FREE</h3>
<blockquote>
<p>Manage and map as many alias domains as you want for complete control.</p>
</blockquote>
<h3>🗺️ MAP CONTENT TO ANY DOMAIN</h3>
<blockquote>
<p>Map alias domains to <strong>any Post, Page, Product, or Custom Post Type</strong>, including Blog Categories, Products Archive, custom taxonomies, and more.</p>
</blockquote>
<h3>🔍 OPTIMIZE YOUR SEO & MARKETING STRATEGY</h3>
<blockquote>
<p>Optimize your site for search engines with full Yoast SEO integration, including the option to add custom Titles, Descriptions, and Keywords, as well as Sitemap for each mapped domain.</p>
</blockquote>
<h3>🔀 SUBDOMAIN MAPPING</h3>
<blockquote>
<p>Map subdomains to your primary WordPress site, so you don’t have to create a second WordPress install or buy a second domain.</p>
</blockquote>
<h3>🌐 MULTISITE SUPPORTED</h3>
<blockquote>
<p>Activate Domain Mapping System on your WordPress MU multisite network for each of your network sites. Now, multisite is even more powerful with multiple domain management for every site on your network, so you can enable BYOD (Bring Your Own Domain) for your users.</p>
</blockquote>
<h3>🇺🇳 LANGUAGE PER DOMAIN</h3>
<blockquote>
<p>Activate the TranslatePress multilingual plugin and attach each language to a specific domain. Even the language switchers work perfectly out of the box. [PRO]</p>
</blockquote>
<h3>🧩 CREATE “MICROSITES” – GROUP CONTENT BY DOMAIN</h3>
<blockquote>
<p>Create microsites by grouping your published resources (pages, posts, products, custom post types) around a specific domain – a much less complex multisite alternative. [PRO]</p>
</blockquote>
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/6jrP8BVxlpQ?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span>
<h3>🌍 GLOBAL DOMAIN MAPPING</h3>
<blockquote>
<p>Easily map every unmapped page on your site in one click – so visitors only see mapped domains for all content on your site. [PRO]</p>
</blockquote>
<h3>🗂 SUBDIRECTORY MAPPING</h3>
<blockquote>
<p>Map subdirectory URLs of your main site. E.g. – your-site.com/landing-page/ can be set to display the content from the post your-site.com/example-page/landing-page/. [PRO]</p>
</blockquote>
<h3>📚 ARCHIVE, CATEGORY, AND CUSTOM TAXONOMY MAPPING</h3>
<blockquote>
<p>Want to map a specific Blog category and all its posts to a different domain automatically? Now you can! Map a domain to any archive, category, or custom taxonomy created by a plugin or theme. [PRO]</p>
</blockquote>
<h3>↪️ FORCE REDIRECT TO MAPPED PAGES</h3>
<blockquote>
<p>Want to hide the “unmapped” version of your page? There’s a checkbox that allows you to “Force redirect all visitors to the mapped version of a page.” [PRO]</p>
</blockquote>
<h3>🛒 WOOCOMMERCE INTEGRATION</h3>
<blockquote>
<p>Map your Shop page and all Products. You can also map a specific product Category and all the products in the category automatically. [PRO]</p>
</blockquote>
<h3>🛒 ALIAS & SUBDOMAIN AUTHENTICATION</h3>
<blockquote>
<p>Allow users to login to Alias Domains or Subdomains of your site, effectively acting as a standalone site for any protected login area, such as WooCommerce Account pages. [PRO]</p>
</blockquote>
<h3>⏩ WELL-DOCUMENTED SETUP PROCESS</h3>
<blockquote>
<p>Domain Mapping System requires a bit of knowledge about DNS and server side configuration, so we’ve helped out by <a href="https://docs.domainmappingsystem.com/requirements/server-configuration" rel="nofollow ugc">documenting the simple steps</a> you’ll need to take. Contact support with any questions.</p>
</blockquote>
<h3>🎨 BRANDING PER DOMAIN (FAVICON)</h3>
<blockquote>
<p>Customize the favicon that appears in your website visitors’ browser for each domain mapped to your site.</p>
</blockquote>
<h3>🔒 SECURE ALL YOUR DOMAINS</h3>
<blockquote>
<p>Use SSL across all your domains with one WordPress install (some server configuration required).</p>
</blockquote>
<h3>⚒️ DEVELOPER FRIENDLY</h3>
<blockquote>
<p>Take advantage of the <a href="https://docs.domainmappingsystem.com/features/rest-api" rel="nofollow ugc">REST API</a> to add/delete domains automatically.</p>
</blockquote>
<h3>DETAILED USE-CASE</h3>
<p><strong>Let’s say you own 2 domains:</strong></p>
<blockquote>
<p>Primary domain (WordPress site): <strong>my-awesome-site.com</strong><br />
  Secondary domain: <strong>my-cool-site.com</strong></p>
</blockquote>
<p><strong>With Domain Mapping System, you can map the secondary domain to any Post, Page, Product, or Custom Post Type on your primary site:</strong></p>
<blockquote>
<p><strong>my-cool-site.com</strong> will display content from<br />
  <strong>my-awesome-site.com/any-post-you-want/</strong></p>
</blockquote>
<p><strong>The plugin does not redirect visitors – the browser URL bar displays the secondary domain my-cool-site.com</strong>. This happens using some awesome code, so feel free to explore 😊</p>
<h3>IMPORTANT CONFIGURATION INSTRUCTIONS</h3>
<p><strong>In order for the plugin to work:</strong></p>
<ol>
<li>
<p>You must set DNS records (both domain A Records should point to the same server)</p>
</li>
<li>
<p>You must add your mapped domains as an Alias in cPanel or in your server configuration (the root folder for both domains should be your WP install)</p>
</li>
</ol>
<p>For detailed instructions, please see our <a href="https://docs.domainmappingsystem.com" rel="nofollow ugc">Documentation</a>.</p>
<h3>FREE FEATURES</h3>
<ul>
<li>Map unlimited domains</li>
<li>Map domains to any post, page, product, or custom post type generated by other plugins</li>
<li>Map subdomains </li>
<li>Multisite supported (requires custom sunrise.php, please see our <a href="https://docs.domainmappingsystem.com/features/multisite-integration" rel="nofollow ugc">documentation</a>.</li>
<li>Query string parameters (used for UTMs or search results) are supported out of the box.</li>
</ul>
<h3>PRO FEATURES</h3>
<ul>
<li>Create “Microsites” – set a different homepage and inner pages for each domain</li>
<li>Global Domain Mapping – automatically map all published content on your site</li>
<li>Subdirectory mapping</li>
<li>Force redirect visitors mapped domains</li>
<li>Favicon per domain</li>
<li>WooCommerce Integration for Shop, Checkout, Cart pages</li>
<li>Custom  code per domain</li>
<li>Global Parent Page Mapping</li>
<li>Global Archive Mapping</li>
<li>Global/Selective URL Rewriting</li>
<li>Yoast SEO Integration</li>
<li>1on1 support</li>
</ul>
<h3>WHAT CAN I DO WITH EACH FEATURE?</h3>
<p><strong><a href="https://docs.domainmappingsystem.com/features/domain-mapping" rel="nofollow ugc">Unlimited Domain Mapping</a></strong>: Expand your online presence without limitations, enabling you to manage multiple domains effortlessly from a single WordPress Dashboard.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/global-archive-category-mapping" rel="nofollow ugc">Flexible Mapping Options</a></strong>: Seamlessly map domains to various types of content, including posts, pages, products, custom post types, and more, enhancing your site’s organizational structure and user experience.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/mapping-with-subdomains" rel="nofollow ugc">Subdomain Mapping</a></strong>: Easily extend your site’s reach by mapping subdomains, enabling you to efficiently manage diverse content.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/multisite-integration" rel="nofollow ugc">Multisite Compatibility</a></strong>: Harness the power of WordPress Multisite while effortlessly integrating with the Domain Mapping System, streamlining management of multiple domains across multiple network sites.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/creating-microsites-multisite-alternative" rel="nofollow ugc">Microsite Creation</a></strong>: Tailor each domain with unique homepages and inner pages, empowering you to create distinct online experiences catered to specific audiences or purposes.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/global-domain-mapping" rel="nofollow ugc">Automatic Global Domain Mapping</a></strong>: Simplify domain management by automatically mapping all published content, ensuring consistency and coherence across your entire site.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/subdirectory-mapping" rel="nofollow ugc">Subdirectory Mapping</a></strong>: Organize your site structure effectively by mapping domains to specific subdirectories, facilitating intuitive navigation and content discovery.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/redirect-site-visitors-to-mapped-domains" rel="nofollow ugc">Visitor Redirection</a></strong>: Enhance user experience and maintain brand consistency by seamlessly redirecting visitors to the proper mapped domain based on the domain being viewed.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/favicon-per-domain" rel="nofollow ugc">Customized Favicon Support</a></strong>: Reinforce your brand identity across multiple domains with custom favicons, enhancing recognition and user engagement.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/global-product-mapping-for-woocommerce" rel="nofollow ugc">WooCommerce Integration</a></strong>: Seamlessly integrate with WooCommerce, optimizing the shopping experience by mapping essential pages such as Shop, Checkout, and Cart across domains.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/query-string-parameters" rel="nofollow ugc">Query String Support</a></strong>: Maximize marketing effectiveness by preserving UTM parameters on mapped domains, enabling accurate tracking and analysis of user interactions.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/global-parent-page-mapping" rel="nofollow ugc">Global Parent Page Mapping</a></strong>: Ensure consistency in site structure and navigation by globally mapping parent pages across domains, simplifying content organization.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/features/url-rewriting" rel="nofollow ugc">URL Rewriting Flexibility</a></strong>: Tailor URL structures to meet specific requirements or preferences, enhancing SEO optimization and user-friendly navigation.</p>
<p><strong><a href="https://docs.domainmappingsystem.com/integrations-and-compatibility/wordpress-plugins/yoast-seo" rel="nofollow ugc">Yoast SEO Integration</a></strong>: Augment your site’s search engine visibility and performance with seamless integration with Yoast SEO, enabling comprehensive optimization across mapped domains.</p>
<p>🎬 <a href="https://domain-mapping-system-demo.xyz/" rel="nofollow ugc">TRY THE LIVE DEMO ></a></p>
<p>🌱 <a href="https://domainmappingsystem.com/?utm_source=wporg&utm_medium=readme&utm_campaign=dms#pricing" rel="nofollow ugc">PLANS & PRICING ></a></p>
<p>🚧 <a href="https://domainmappingsystem.com/roadmap/?utm_source=wporg&utm_medium=readme&utm_campaign=dms" rel="nofollow ugc">ROADMAP ></a> – Feel free to submit feature requests!</p>


Domain Mapping System | Create Microsites with Multiple Alias Domains (multisite optional)

We’ve spent years developing this plugin, and we're super happy it’s available on wordpress.org. We’re going to continue working hard on it and have a solid team ready to help with any questions.

Thanks for trying out Domain Mapping System!

Full transparency - I’m the creator of this plugin and it is great 😇

Practical to deliver landing pages from a centralized location, instead of creating multiple WordPress installs.

Practical to deliver landing pages from a centralized location

We've worked extremely hard to prepare the plugin to be too easy to use with helpful features. 
You won't regret trying Domain Mapping System.

Full transparency - I'm lead dev and this plugin is awesome


We’ve put a lot of effort into making the plugin user-friendly with great features. Give Domain Mapping System a try – you won’t be disappointed!


Full transparency - I'm a developer behind this plugin and it's awesome


I have started contributing to this plugin since few months and I must say it's a good and user friendly plugin.


Full transparency – I’m a developer behind this plugin and it’s Good


DOes exactly what I required without fuss or excessive set-up ... there's more there than I am using now but it is good to know that I can expand my offering in the future. This isa tricky area that they have tamed ;-)


Just what I needed

Domain Mapping System is the most powerful way to manage alias domains and map them to any published resource - creating Microsites with ease!

WordPress MU Domain Mapping vs Domain Mapping System | Create Microsites with Multiple Alias Domains (multisite optional)