2.7.3releasedFrontend Localisation

Offers an integrated solution to localise the Frontend of your site and more...

Clone URLhttps://github.com/DeuxHuitHuit/frontend_localisation.git

Add as a submodulegit submodule add https://github.com/DeuxHuitHuit/frontend_localisation.git extensions/frontend_localisation --recursive

Compatibility

2.x.x2.1.x2.2.x2.3.x2.4.x2.5.x2.6.x2.7.0
NoNo1.3.22.42.6.62.7.32.7.32.7.3

Readme

Frontend Localisation

1 Synopsis

Offers the language tools to localise the Frontend of your site.

2 Features

For site builders:

  • Frontend Languages management.
  • one Datasource with Frontend Languages information

For PHP developers:

  • easy access to Frontend Language information
  • UI assets to build the language tabs

3 Installation

  1. Make sure you have Languages extension installed.
  2. Make sure you have at least one FLang detection driver installed (= install that extension). For example, use FLang detection gTLDs.
  3. Upload the frontend_localisation folder found in this archive to your Symphony extensions folder.
  4. Enable it by selecting Frontend Localisation under System -> Extensions, choose Enable from the with-selected menu, then click Apply.

4 Upgrading

Keep your fingers crossed and push za button!

5 Usage

5.1 @ Site builders

Attach FL: Languages datasource to your pages.

On Preferences page you can:

  • Site languages: choose site languages
  • Main language: choose the main language of the site

Important! When you change the language, re-install the detection driver FLang detection gTLDs.

5.2 @ PHP developers

This extension provides a static FLang class for easy access to Frontend language information.<br/> If you want to create a third-party FLang detection driver, make sure that your driver adds the fl-language & fl-region params to the URL query string with appropriate values. You can also set a main region value, but you need to edit the config.php file manually. Doing so will force you to use a driver that specify a region.

Version history

Symphony 2.5.0 to 2.x.x

  • Removed double invalid container

Symphony 2.5.0 to 2.x.x

  • Silence wrong fatal errors

Symphony 2.5.0 to 2.x.x

  • Bug fixes around regions

Symphony 2.5.0 to 2.x.x

  • Minimum version is now 2.5.0
  • Removed unused 'ref_lang' config value
  • Added 'main_reg' config value, in order to control de default region as well. This value is still not yet available in the UI, but can be set manually.

Symphony 2.3.4 to 2.x.x

  • Fixed language selection in the backend: Try author language before default backend language

Symphony 2.3.4 to 2.x.x

  • Fixed Data Source execute method signature

Symphony 2.3.4 to 2.x.x

  • Updated compatibility info

Symphony 2.3.4 to 2.6.x

  • Reverted c631bbb and made sure that page alerts won't crash

Symphony 2.3.4 to 2.6.x

  • Removed un-necessary delegate.

Symphony 2.3.4 to 2.6.x

  • Fixed a bug when no region is set.

Symphony 2.3.4 to 2.6.x

  • Added support for the new AdminPagePreBuild: this allows translation in content pages
  • Marked as 2.6.x compatible

Symphony 2.3.4 to 2.5.x

  • FLang::setLangCode: fail early if language is empty
  • Extension::update: fix notice warning

Symphony 2.3.4 to 2.5

  • Mark the extension as compatible with 2.4 and 2.5

Requires Symphony 2.3.4

  • Fixes for Languages 1.2 compatibility.

Requires Symphony 2.3

  • Multilingual Tabs initialize with Main Language instead of Author language.

Requires Symphony 2.3

  • FLang now initializes with Author language in Administration and Frontend Language in Frontend.

Requires Symphony 2.3

  • Fixed bad error reporting when saving preferences.

Requires Symphony 2.3

  • Fixed FLang naming.

Requires Symphony 2.3

  • Removed Translations feature. It is bloated. Recommended: Use a dedicatied Section with Multilingual Fields.
  • It now depends on "Languages" extension. Please install it.
  • Updated language selection on Preferences page.

Requires Symphony 2.3

  • Added a new delegate to modify settings at initialization.
  • Fixed error when creating new translation if no languages are set.
  • On Translations index a proper message appears if no languages are set.

Requires Symphony 2.3

  • Added a new delegate to Translations DS for customized execution.
  • Pumped up TManager::addFolder() with an option to replace existing folder.
  • Minor tweaks and code styling.

Requires Symphony 2.3

  • Fixed bug on content pages with Multilingual Tabs.
  • Proper space usage on Translations index page.
  • Deactivated Translation name setting with localised page values.

Requires Symphony 2.3

  • Javascript scales better now. The new symphonyMultilingualTabs jQuery plugin can be used to instantiate tabs on-the-fly.

Requires Symphony 2.3

  • Added language information to param pool.

Requires Symphony 2.3

  • Fixed a (stupid) critical bug in TManager class.
  • Improves support for multilingual extensions.
  • Multilingual field Javascript rewrite.

Requires Symphony 2.3

  • FLang and TManager classes are now static to align with Symphony 2.3 style.
  • Implemented error feedback for Preferences page settings.
  • Fixed minor bugs regarding Reference language & Translations logic.

Requires Symphony 2.3

  • Symphony 2.3 update
  • Integrates Frontend Languages management. Dropped support for FLang drivers. Requires a third-party FLang detection driver to be installed.
  • Reworked FLang and TManager APIs.
  • Boosted fl_utilities.xsl with a parameter for dynamic translations pool.
  • Added FLSavePreferences delegate firing on Preferences page which provides the old language codes and new languages codes introduced.

Requires Symphony 2.2

  • Proper missing languages handle on Translations index. Fixes #1.
  • Settings will be saved to file only if meta info changed. Fixes some file errors.

Requires Symphony 2.2

  • Removed XML validation of Translations.

Requires Symphony 2.2

  • Fixed some bugs regarding Page's Translation management on saving a Page.
  • Fixed a bug where the handle of a Translation item wasn't changing.
  • Fixed a bug where the relation between Translation and Pages wasn't removed on Translation deletion.

Requires Symphony 2.2

  • Fixed some Translation synchronisation bugs.

Requires Symphony 2.2

  • Fixed some bugs regarding storage_format switching.
  • Titles for Symphony Page translations are now handled automatically.
  • Comprehensive README.

Requires Symphony 2.2

Initial stable release.