README

Warning: This Extension is in beta status. DO NOT USE IT ON ANY PRODUCTIVE ENVIRONMENT!

ATTENTION: I stopped the active development of this extension. This is due to several circumstances. First of all it became increasingly harder to impossible to fix existing routing related bugs. A refactoring of this extension would take an unreasonable amount of time. Several features of the extension would even require a total overwrite of the Contao routing. From my personal perspective this extension is dead - at least until someone is able and willing to invest a lot of energy to give it another try. Maybe Contao 5 will introduce ways to revive the project.

About

A module to handle localizations for Contao 4.

By default Contao handles multiple languages by duplicating page trees for each language (in Contao's Site Structure). If you have many pages and languages it can become a lot of work to handle your content and to keep them in sync. Especially, when the content is similar across languages. This extension is for you!

System requirements

• Contao 4

Installation

1. Install package

$ composer require exploreimpact/contao-i18nl10n

# or for latest state of development:

$ composer require exploreimpact/contao-i18nl10n:dev-master

2. Update database

• Run a database update via the Installtool afterwards.

3. Set URL settings

• Open the Contao backend.
• Go to "Site structure".
• Edit your website's root page:
  • Under "DNS settings":
    • Enter the default language to the "Language" field.
    • Set the page as "language fallback".
  • Under "i18nl10n settings":
    • Add the additional languages you want to make available.

Note:

• The extension is not compatible with the parameter prepend_locale: true!

Documentation:

Contao 4: ... t.b.d. ...
Contao 3: https://github.com/exploreimpact/contao-i18nl10n/wiki
Note: Most configuration instructions still match for Contao 4 intallations.

For changes made in the past please look into CHANGELOG.md.

Support

Claudio De Facci
https://exploreimpact.de
claudio@exploreimpact.de