WPMu Domain Mapping Plugin on CPanel
Well, I have written a bunch about domain mapping on WPMu over the last year or so. Up and until tonight I have been using Richard Bui’s tutorial here along with David Dean’s Multi-Site Manager Plugin. The combination of the two have worked great for me thus far, and I liked that with this combination each mapped domain could act like its own, stand-alone WPMu install—with each domain having the possibility of unlimited dynamic subdomains—a feature I’m not so sure is available with this plugin. That said, you did have to be brave enough to muck around in the database.
Well, that was then, this is now. Donncha just released a plugin that brings domain mapping for WPMu to the masses in the form of a simple, easy-to-use plugin. Is Donncha on a roll or what? Last month it was the Sitwewide Tags Plugin (though it’s much more than the name suggests) which kicks major ass. This week it is the Domain Mapping Plugin, which is for many the Holy Grail for WPMu admins.
So, I just got around to testing it out on a WPMu install that uses [[CPanel]], and it is actually pretty painless, though not entirely automated. Keep in mind this will only work with installations that have sub-domains setup, no love for sub-directories just yet.
Here is how I got it to work with CPanel:
After you install the plugin you will find the Domain Mapping subtab under the Manage tab. Once you're there you will see the following:
The logic here is simple, each WPMu blog will have access to this subtab once the plugin is installed. If someone has a blog on your system and they have a domain they want to map, they would need to do two things:
1) From where ever they purchased their domain, they would need to point their domain to the nameservers of the WPMu install. For example, if your WPMu install was hosted on Bluehost, they would need to point them to NS1.BLUEHOST.COM AND NS2.BLUEHOST.COM.
2) After that, they will need to go to the Manage–>Domain Mapping tab and specify the IP address of the WPMu site and have them put in their domain. (You can decide how you want to share the IP address with them.)
That’s it on their end, pretty simple. But on the admin end there is one more step if you are using CPanel.
You need to create an addon domain for the mapped domain and point it to the directory with the WPMu installation. For me it looked like this:
You can see that the domain is added normally, but the document root is changed to point to the actual directory with the WPMu installation. After that, it works like a charm. Now, this was simple and awesome, and for folks who aren’t using CPanel it will probably work automatically once someone points their domain to the correct IP address. But with CPanel there is one extra step, and while a relatively easy one, it does rule out strict automation of the mapped domains. But, the upside is that at the end of the day even I can map domains with out hacking Apache settings or putting our WPMu install in imminent danger. Disco!
So, can UMW Blogs map domains now? Well, I gues we can now, can’t we


on Aug 21st, 2008 at 4:45 am
Great tutorial. The new plugin looks interesting. I’m using David’s Multi-Site Manager for http://daytonastate.org , and it works fine, but I can’t upload files or access the Site Admin from it. I just use FTP and use Site Admin from the main site, but it would be nice to have that out of the way. I’ll try Donncha’s plugin if he gets cookie (remote login) sharing. That would be awesome.
on Aug 22nd, 2008 at 10:16 am
The IP address textbox only shows to the site admin. Once it’s filled in, it’s displayed to “normal users” who must add CNAMEs or A records to their DNS pointing at that IP address.
There’s no need for your users to change domain servers, but of course this will only work if you only have one IP address.
on Aug 22nd, 2008 at 3:56 pm
Donncha,
Good to know about the IP address, thanks for that. And I have played with the CNAME for a Godaddy domain I have hosted, and had no luck, I’m going to have to keep playing with that. I guess this solution demands that people would have to change domain servers, which I think your right in trying to avoid. I’ll keep playing with this, but it still soothes me to know I can do it in this kludgy fashion through CPanel.
Thanks for the awesome plugin.
on Jul 15th, 2009 at 3:16 pm
Has anybody had any luck getting the mapped domains to KEEP the www?
For example:
http://www.myprimarydomain.com has WPMU installed and running with Donncha’s domain mapping plugin. I can create
subdomain1.myprimarydomain.com
with no problems. BUT when I point http://www.subdomain1.com to my primary domain and set up the plugin, it works fine. Except that the website removes the wwws (shows up as subdomain1.com instead of http://www.subdomain1.com)
How can I keep the wwws as part of the mapped domain name?
on Jul 24th, 2009 at 3:45 pm
Hey Mike,
I think WPMu Tutorials describes what you are looking for here:
http://wpmututorials.com/hacks/forcing-mu-to-use-www/