This Craft CMS 2.x plugin is no longer supported, but it is fully functional, and you may continue to use it as you see fit. The license also allows you to fork it and make changes as needed for legacy support reasons.
For Craft CMS 3.x functionality, consider Pierre Stoffe's Language Redirector plugin, which can also be installed via the Craft Plugin Store in the Craft CP.
Locale Redirector detects the language preferences set by the user, via cookie or browser settings, and redirects to the appropriate localized version of the page requested, if the locale has been enabled for the site.
- Cookie: If the user's language preference has been saved in a cookie named locale, and the requested url is for a different locale currently enabled for the site, the user will be redirected to the locale saved in the cookie, for the requested url. For example:
Requested URL: http://site.com/blog/article-title
Cookie Present: es
Configured Site Locales: en, fr, de, pt, es
Redirects To: http://site.com/es/blog/article-title
- Browser Language Settings: If the language preference has not yet been saved to a cookie, then the plugin will attempt to find a match between the browser's preferred languages and the site's enabled locales. If a match is found, the user will be redirected to the matched language setting. For example:
Requested URL: http://site.com/blog/article-title
Cookie Present: n/a
Browser Languages: es, en
Configured Site Locales: en, fr, de, pt, es
Redirects To: http://site.com/es/blog/article-title
To install Locale Redirector, follow these steps:
- Download & unzip the file and place the
localeredirectordirectory into yourcraft/pluginsdirectory - -OR- do a
git clone https://github.com/vigetlabs/localeredirector.gitdirectly into yourcraft/pluginsfolder. You can then update it withgit pull - Install plugin in the Craft Control Panel under Settings > Plugins
- The plugin folder should be named
localeredirectorfor Craft to see it. GitHub recently started appending-master(the branch name) to the name of the folder for zip file downloads.
Locale Redirector works on Craft 2.5.x and Craft 2.6.x.
This plugin assumes that language links are available to the user. You can build this list of links any way you want, using custom template code with advanced logic, but the simplest approach is to use a craft plugin called Language Link. It provides an easy way to switch between languages by automatically outputting the correct links to the same page in different locales.
You can then set a locale cookie when one of these links is clicked, via JavaScript. You can use document.cookie for this, or use the js-cookie utility, which couldn't be simpler. To set a locale cookie to "es" and have it exipre in 1 year:
Cookies.set('locale', 'es', { expires: 365 });
Visit code.viget.com to see more projects from Viget.