martimiz/silverstripe-languageprefix

Extends silverstripe-translatable to allow for (custom) language prefixes on multilingual sites.

Installs: 7 031

Dependents: 0

Suggesters: 0

Stars: 20

Watchers: 3

Forks: 12

Open Issues: 1

Type:silverstripe-module

v3.0.0 2016-05-19 10:05 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)