Skip to main content

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.txt file sits in the root of your site, which stops the robots.txt per domain from ever being used.