Spree multi-lingual is a plugin to make multi locale store with Spree possible
Ruby CoffeeScript Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
app add description to shipping method fix #48 Oct 19, 2013
spec fix : set_user_language not overriden in spree_auth_devise_controller Oct 19, 2013
.gitignore add presentation translation to option type Apr 21, 2012
.rspec initial proof of concept for multi-lingual Spree backend Feb 14, 2012
Gemfile fix spec Aug 26, 2013
LICENSE initial proof of concept for multi-lingual Spree backend Feb 14, 2012
Rakefile now support spree 2.0.X Aug 26, 2013


SpreeMultiLingual Build Status

SpreeMultiLingual is originally a proof of concept for what could become a multi-lingual Spree plugin.

Since then integration tests and features have been added.


  • Spree 1.3.X
  • Rails 3.2.X


Add gem to your Gemfile:

gem 'spree_multi_lingual', :git => 'git://github.com/jipiboily/spree_multi_lingual.git'
gem 'globalize3', :git => 'git://github.com/svenfuchs/globalize3.git'

Globalize3 edge version fixed important bug with dynamic finder : https://github.com/svenfuchs/globalize3/commit/b771fb87d3dda4a78cfe294da1fab7df266e72c9

Run Bundler

bundle install


In app/assets/javascripts/admin/all.js

//= require admin/spree_multi_lingual
//= require admin/spree_multi_lingual_class

This is required for the language dropdown!

Add an initializer file and set SpreeMultiLingual.languages to an array containing the languages you support.

# config/initializers/spree_multi_lingual.rb
SpreeMultiLingual.languages = ["fr", "en", "es"] # Add your own locales here

For the moment, enable locale fallbacks for i18n (makes lookups for any locale fall back to the i18n.default_locale when a translation can not be found)

# config/application.rb
config.i18n.fallbacks = true

Run spree_multi_lingual install:

rails g spree_multi_lingual:install

If you want to use browser language detection using rack-contrib Locale :

# config.ru
require 'rack'
require 'rack/contrib'

use Rack::Locale

require ::File.expand_path('../config/environment',  __FILE__)
run MyRailsApp::Application


On views where there is translated fields, there should be a dropdown to switch currently edited locale.

Products: http://dl.dropbox.com/u/6210261/spree_multi_lingual.swf

Taxons: ** /!\ Using the taxonomy tree you can only edit another locale taxons name, to do so click on the links next to "Edit Taxonomy" to show the taxonomy for a given locale. If you want to create taxons using the taxonomy tree, please only use the default locale for the moment.**

To edit taxons permalink please do as following: Taxon TaxonEdit

What is translated?

For now :

  • products : name, permalink, description, meta description and meta keywords.
  • taxonomies : name.
  • taxons : name, permalink and description.


there is no fallback of default language for now unless you speficy i18n.fallbacks as previously stated.


It uses Globalize3, easy_globalize3_accessors and routing-filter. Thanks to Tomash that told me about those two awesome gems: easy_globalize3_accessors and routing-filter.

SpreeMultiLingual depends on a fork of routing-filter because it supports :exclude option in routes, used for /admin. I hope it this feature can me merged into the original repo.

The flags are from the flags icon set from famfamfam (http://www.famfamfam.com/).


  1. Make taxons multi languages editable from the taxonomy tree
  2. Dynamically show taxon prefix permalink depending on dropdown language selected : Taxons#edit
  3. Add things to translate:
    • Option values
    • Properties
    • Alt text on images
  4. Dropdown or something to change locale
  5. Rake task for store that already have users


Special thanks to sbounmy for the amount of contributions he did. Thanks to Radar for merging spree_localize.


Be sure to bundle your dependencies and then create a dummy test app for the specs to run against.

$ bundle
$ bundle exec rake test_app
$ bundle exec rspec spec

Copyright (c) 2012 Jean-Philippe Boily, released under the New BSD License