Description
Important: This plugin has a new maintainer. So the plugin will now be active developed again, and it’s now part of goINPUT.
Multiple Domain allows you having more than one domain in a single WordPress installation. This plugin doesn’t support
more than one theme or advanced customizations for each domain. It’s only intended to enable constant navigation under
many domains. For a more complex setup, there is
WordPress Multisite (MU).
When there is more than one domain set in your host, all links and resources will point to the default domain. This is
the default WordPress behavior. With Multiple Domain installed and properly configured, it’ll update all link on the
fly. This way, the user navigation will be end-to-end under the same domain.
You can also set an optional base URL. If you want only a set of URL’s available under a given domain, you can use this
restriction.
Additionally, a language can be set for each domain. The language will be used to add <link>
tags with hreflang
attribute to document head. This is for SEO purposes.
Installation
Follow the steps below to install the plugin:
- Upload the plugin files to the
/wp-content/plugins/multiple-domain
directory, or install the plugin through the
WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Use the Settings -> General screen to configure your additional domains.
FAQ
-
How can I help the plugin development?
-
Feel free to open a pull request to address any of the
issues reported by the plugin users. In case you have questions
on how to fix or the best approach, start a discussion on the appropriate thread.If you want to add a new feature, please open an issue
explaining the feature and how it would help the users before start writing your code.Donations
If you find this plugin helpful, you can support the work involved buying me a coffee, beer or a Playstation 4 game.
You can send donations over PayPal to paypal@goinput.de. -
Does this plugin set extra domains within my host?
-
No. You have to set additional domains, DNS, and everything else to use this plugin.
-
Can I have a different theme/content/plugins for each domain?
-
Nope. If you want a complex set up like this, you may be interested in WordPress Multisite. It’s delivered with every
WordPress installation since 3.0, you can find more info here: https://codex.wordpress.org/Create_A_Network. -
There is a way to add domain based logic to my themes?
-
Absolutely. You can use the
MULTIPLE_DOMAIN_DOMAIN
andMULTIPLE_DOMAIN_ORIGINAL_DOMAIN
constants to get the current
and original domains. Just notice that since the value of the first one is checked against plugin settings, it may not
reflect the actual domain inHTTP_HOST
element from$_SERVER
or user’s browser. They also may include the host port
when it’s different than 80 (default HTTP port) or 443 (default HTTPS port).Notice: in prior versions these constants were wrongly prefixed with
MULTPLE_
, missing the „I“. The old constants
are now deprecated. They still available for backcompat but will be removed in future releases. -
Can I create a custom access restriction logic for each domain?
-
Yes. You can use the
multiple_domain_redirect
action to do that. Please check
https://github.com/straube/multiple-domain/issues/2 for an example on how to do that. -
Can I get the language associated with the current domain?
-
Yes. You can use the
MULTIPLE_DOMAIN_DOMAIN_LANG
constant to get the language associated with the current domain. Keep
in mind the value in this constant doesn’t necessarily reflect the actual user language or locale. This is just the
language set in the plugin config. Also notice the language may benull
.Notice: in prior versions these constants were wrongly prefixed with
MULTPLE_
, missing the „I“. The old constants
are now deprecated. They still available for backcompat but will be removed in future releases. -
Can I show the current domain in the content of posts or pages?
-
Yes. There is a shortcode available for that. Just add
[multiple_domain]
to the post/page and it’ll be replaced by
the current domain when viewing the content. You can write things like „Welcome to [multiple_domain]!“, which would be
rendered as „Welcome to mydomain.com!“. -
What domains should I add to the plugin setup?
-
Any domain you’re site is served from must be added to the plugin configuration. Even
www
variations and the original
domain where your WordPress was installed in must be added. You’ll probably see some unexpected output when accessing
the site from a non-mapped domain. -
Yes. You may notice that even if you don’t set a language for any domain, you still get a default
hreflang
tag in
your page head. To disable this behavior, follow the instructions from
https://github.com/straube/multiple-domain/issues/51. -
I locked myself out, and what am I doing now?
-
Under certain circumstances, in the case of a wrong configuration, you may not be able to log in to the admin area
and your page will be redirected. In this case, there are two ways to solve this.- Delete the plugin directory
wp-content/plugins/multiple-domain
. You should be able to do that from the hosting
panel, from an FTP client, or via SSH. The downside of this technique is that it won’t be possible to install the
plugin again since the configuration will still be in the database. - Remove the plugin configuration from the database using the following SQL query
DELETE FROM {YOUR-PREFIX}_options
; (Remember to replace the prefix from your own table name). This can be
WHERE option_name LIKE 'multiple-domain-%'
done from the hosting panel when PHPMyAdmin is available or using a MySQL client.
- Delete the plugin directory
Reviews
Contributors & Developers
“Multiple Domain” is open source software. The following people have contributed to this plugin.
Contributors“Multiple Domain” has been translated into 2 locales. Thank you to the translators for their contributions.
Translate “Multiple Domain” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.7
- Changed the author to the new one.
- Tested suport for WP 5.7
1.0.6
- Fix URI generated for canonical tag.
1.0.5
- Fixed issue with system routes when a base path is defined.
1.0.4
- Fixed assertions in admin views.
1.0.3
- Fixed XSS vulnerability in canonical/alternate tags.
1.0.2
- Added low memory option. (Refer to https://github.com/straube/multiple-domain/issues/45 on how to enable it)
- Constants starting with
MULTPLE_
are now deprecated. They have a matchingMULTIPLE_
prefixed constant. - Fixed constants starting with
MULTPLE_
, changed toMULTIPLE
.
1.0.1
- Fixed issue with regex used in domain replacement.
1.0.0
- Locked out instructions to readme file.
- API to programmatically change the domains list.
- Don’t add canonical link if settings are
false
.
0.11.2
- FAQ about removal of
hreflang
tags. - Fixed bug in domain replacement when it contains a slash (the regex delimiter).
- Fixed issue in the domain replacement regex.
0.11.1
- Fixed URI validation when there is a domain’s base restriction.
0.11.0
- Add CHANGELOG.md file.
- Added option to enable canonical tags.
- Added
%%multiple_domain%%
advanced variable for Yoast. - Moved WordPress admin features to a separate class.
- Renamed hreflang related methods.
- Inline documentation review.
- Minor refactoring.
- Fixed issue with domain replacement.
0.10.3
- Added public method to retrieve a given (or current) domain base path:
getDomainBase($domain = null)
. - Minor code refactoring.
0.10.2
- Fix minor notice message when loading the non-mapped original domain.
- Added FAQ about plugin settings and domains.
0.10.1
- Fix bug introduced in 0.10.0 with setups where the original domain is not present in the plugin settings.
0.10.0
- Fix #31: Don’t add SSL when accessing via a Tor domain name
- Moved HTML to view files.
0.9.0
- Fixed bug in backward compatibility logic.
- Added a class to
<body>
tag containing the domain name (e.g.multipled-domain-name-tld
) to allow front-end customizations.
0.8.7
- Loading Multiple Domain before other plugins to fix issue with paths.
- Fix #38: Missing locales on language list (this issue was reopened and now it’s fixed)
- Refactored
initAttributes
method.
0.8.6
- Fix #39: Rolling back changes introduced in 0.8.4 and 0.8.5 regarding to avoid URL changes in the WP admin.
0.8.5
- Fixed an issue introduced in 0.8.4 that breaks the admin URLs.
- Fix #38: Missing locales on language list
- Add
[multiple_domain]
shortcode to show the current language.
0.8.4
- Fix: #36 Wrong host in URLs returned by the JSON API
- Using singleton pattern for main plugin class.
- Avoiding URL changes in the admin panel.
0.8.3
- Fix: #34 hreflang tag error
0.8.2
- Fix: #32 Image URLs not being re-written properly via Tor.
0.8.1
- Fix: #23 Undefined index when using wp-cli.
0.8.0
- Moved
MultipleDomain
class to its own file. - Fix: #14 Remove
filter_input
from plugin. - Attempt to fix #22.
- Added
MULTIPLE_DOMAIN_DOMAIN_LANG
constant for theme/plugin customization. - Fix: #21 No ‘Access-Control-Allow-Origin’ header is present on the requested resource
0.7.1
- Make the plugin compatible with PHP 5.4 again.
0.7
- Code review/refactoring.
- Added activation hook to fix empty settings bug.
0.6
- Fix: #11 Redirect to original domain if SSL/https.
0.5
- Added http/https for alternate link.
0.4
- Fixed resolving host name to boolean.
- Added Reflang links to head for SEO purpose. E.g.
0.3
- Fixed bug when removing the port from current domain.
- Added
MULTIPLE_DOMAIN_ORIGINAL_DOMAIN
constant to hold the original WP home domain. - Allowing developers to create custom URL restriction logic through
multiple_domain_redirect
action. - Improved settings interface.
0.2
- Improved port verification.
- Added
MULTIPLE_DOMAIN_DOMAIN
constant for theme/plugin customization. - And, last but not least, code refactoring.
0.1
This is the first release. It supports setting domains and an optional base URL for each one.