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.x | 2.1.x | 2.2.x | 2.3.x | 2.4.x | 2.5.x | 2.6.x | 2.7.0 | 2.7.1 | 2.7.2 | 2.7.3 | 2.7.4 | 2.7.5 | 2.7.6 | 2.7.7 | 2.7.8 | 2.7.9 | 2.7.10 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
No | No | 1.3.2 | 2.4 | 2.6.6 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.7.3 | 2.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
- Make sure you have Languages extension installed.
- Make sure you have at least one FLang detection driver installed (= install that extension). For example, use FLang detection gTLDs.
- Upload the
frontend_localisation
folder found in this archive to your Symphonyextensions
folder. - Enable it by selecting
Frontend Localisation
underSystem -> 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 languagesMain 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.