martimiz / silverstripe-languageprefix
Extends silverstripe-translatable to allow for (custom) language prefixes on multilingual sites.
Installs: 7 932
Dependents: 0
Suggesters: 0
Security: 0
Stars: 19
Watchers: 3
Forks: 13
Open Issues: 1
Type:silverstripe-module
Requires
- silverstripe/cms: ~3.1
- silverstripe/framework: ~3.1
- silverstripe/translatable: ~2.2
This package is not auto-updated.
Last update: 2021-08-02 12:02:31 UTC
README
- Supports SilverStripe 3.1.x +
- For SilverStripe 3.0.x use version 1.0
Introduction
The Language Prefix module allows you to create links with a language prefix for multilingual websites using SilverStripe Translatable. Example:
www.mydomain.com/en/
www.mydomain.com/nl/
You can easily define your own prefix format. By default the locale (en_US, nl_NL, ...) is used. Optionally you can leave out the prefix for the default language
Changes in this version
This is a rewrite of version 2.0. The Prefix is no longer a separate url param, but is extracted from the URLSegment instead. This allows for greater flexibility - you can now optionally use urls without prefix for the default language.
- $Prefix segment is stripped from the url rule (routes.yml)
- PrefixModelAsController::handleRequest() now handles extracting the prefix from the url, and shifts the url and other params if need be
- Optionally set
disable_prefix_for_default_lang
to remove the prefix from the default language
Note: this version should be backwards compatible with version 2.0. Please create an issue if you find any problems
Usage
Setup and usage documentation: docs/en/index.md
Requirements
- SilverStripe Framework 3.1+ and CMS 3.1+
- SilverStripe Translatable module
Maintainers
- Martine Bloem (martimiz at gmail dot com)