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.2.X
- Rails 3.2.X
Add gem to your Gemfile:
gem 'spree_multi_lingual', :git => "firstname.lastname@example.org: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
//= 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.
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.**
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.
- Make taxons multi languages editable from the taxonomy tree
- Dynamically show taxon full permalink depending on dropdown language selected : Taxons#edit
- Add things to translate:
- Option values
- Alt text on images
- Dropdown or something to change locale
- 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