Documentation: Domain per Language plugin
Configuration
All settings live in the plugin itself: System > Manage > Plugins, search for Domain per Language.
Domains
The heart of the plugin is one row per language:
- Language - a published content language of your site. Every language may appear once.
- Domain - the host name only, for example
www.example.com. A scheme, path, port or trailing dot is removed when you save, and an international domain name is stored in its punycode form. Every domain may appear once. - robots.txt (PRO) - the robots.txt this domain serves. See the separate article.
Saving is refused, with a message naming the row, when a domain is invalid or when a language or a domain is used twice.
The domain of a language is where that language is served without its language code: www.example.com/about instead of www.example.com/en/about.
Languages without a domain
You do not have to give every language its own domain. A language without a domain stays available with its language code on the domain of the default site language, so www.example.com/de/ueber-uns. That makes it easy to grow: give a language its own domain the day it deserves one.
PRO settings
- Language suggestion - shows visitors whose browser prefers another language a bar with a link to the same page on the domain of that language. Off by default.
- Stay logged in across domains - a visitor who logs in on one language domain is logged in on the others as well. Off by default.
- Domain health check - the Check domains button that tests every saved domain. It checks what is saved, so save your changes first.
In the free edition these three appear as a PRO badge, together with a short description of what they do.
Warnings on the settings screen
The plugin checks your site when you open its settings and warns, without blocking anything, when:
- the System - Language Filter plugin is disabled - Domain per Language then does nothing at all;
- Search Engine Friendly URLs are switched off - the plugin only works with them on;
- (PRO) a physical
robots.txtfile sits in the root of your site, which stops the robots.txt per domain from ever being used.