Documentation: Domain per Language plugin
Configuration
All the settings sit in the plugin itself. Go to System > Manage > Plugins and search for Domain per Language.
Domains
The heart of the plugin is a list. You add one row for every language:
- Language - one of the published content languages of your site. Every language may be used once.
- Domain - only the host name, for example
www.example.com. So nohttps://, no folder and no port number. If you type one anyway, the plugin removes it when you save. A domain with accents or other special letters is saved in punycode, the plain-letter form that browsers use behind the scenes. Every domain may be used once. - robots.txt - the robots.txt this domain shows. There is a separate article about it.
If a domain is not a real host name, or if you use the same language or the same domain twice, the plugin refuses to save. The message tells you which row is wrong.
The domain you pick for a language is the place where that language is shown without its language code. So www.example.com/about instead of www.example.com/en/about.
Languages without a domain
You do not need a domain for every language. A language without one keeps its language code and stays on the domain of your default language, so www.example.com/de/ueber-uns.
That makes it easy to grow. Give a language its own domain on the day it earns one.
Extra settings
- Language suggestion - shows a small bar to visitors whose browser asks for another language, with a link to the same page on that language's domain. Off by default.
- Stay logged in across domains - someone who logs in on one language domain is logged in on the other ones too. Off by default.
- Domain health check - the Check domains button that tests every domain you saved. It looks at what is saved, so save your changes first and then press the button.
Warnings on the settings screen
When you open the settings, the plugin checks a few things about your site. It warns you, but it never blocks you, when:
- the System - Language Filter plugin is off. Domain per Language then does nothing at all.
- Search Engine Friendly URLs are off. The plugin only works when they are on.
- there is a real
robots.txtfile in the main folder of your site. As long as that file is there, your robots.txt per domain is never used.