Skip to content

Intro

Jump to bottom
Patric Eberle edited this page Dec 25, 2014 · 8 revisions

Contao uses one page-tree per language to manage multi-language sites. When you have a larger site (50-100 pages per language) with many languages (5-6) in the same domain it becomes harder and harder to manage all this, especially when you use many modules. Also you end with too many duplicated layouts etc.

This extension makes you work less.

This extension assumes the following:

  1. You have only one published root page (one page-tree/domain);
  2. Your default language is defined in the root page;
  3. You will have corresponding translations of pages in possibly (but not mandatory) each of the other languages;
  4. You will have one page in the default language, but you may not have a corresponding translation in each of the available languages;
  5. You can not have a page-translation in one of the available languages and missing fallback page in the default language;
  6. In case you need to have pages in some of the available languages, but not in the default languages better make a separate page-tree per language and do not use this extension.
  7. Setting "Front end configuration"/ "Disable page alias usage" is unchecked;
  8. Setting "Front end configuration"/"Add the language to the URL" is unchecked. This extension handles urls like /en/pagename.html it self.

Features:

  1. Multilanguage site in only one page-tree;
  2. Unique urls per language (i.e. home.en.html,home.de.html or /en/home.html,/de/home.html etc.);
  3. Automatic localization on page creation in all available languages;
  4. Localizations for all pages in the default language to all site languages with one click;
  5. Pages' languages do not depend on installed backend language or admin-user language;
  6. Pages under the same root can have title, pageTitle, description and other properties in many languages;
  7. Content elements can have different languages in the same article or be language agnostic (Any language);
  8. Frontend module for switching between page and content languages(Languages menu).
  9. Switching language is possible even for users with language property already set.
  10. Main navigation and breadcrumb navigation automatically show translated pages' titles.
  11. Works with Isotope eCommerce.
  12. Multilanguage News.

To make your site multi-lingual, you first need to install i18nl10n and then configure it. After that you will have to localize your [pages](Adding languages to a page) and [content](Translating Content elements). To allow users to switch the language of the pages, you will need to create and configure the ["Languages menu"](Adding Languages menu in the frontend) frontend module.

Support this project by making a donation or sending a gift.

Clone this wiki locally