README.md in spree_mobility-1.0.0 vs README.md in spree_mobility-1.1.0

- old
+ new

@@ -2,27 +2,12 @@ This is a Spree model translation gem based on `spree_globalize` for [Spree Commerce][1] version 4.3+. It uses `mobility` instead of `globalize`, since `globalize` is not actively developed anymore. It is a drop-in replacement for `spree_globalize` and will use your existing translations. -## Improvements +Currently, this gem is tested with Spree 4.3.1. -This gem offers several improvements over `spree_globalize`: - -* Proper translation fallbacks support (if a translation for the current locale is missing, it will fallback to other locales, strictly based on configured fallbacks): - * for finders (slug/permalink) - * when searching by product name (frontend & admin search) -* Proper validations on translation models (e.g. slug presence validation), also meaning uniqueness validations will now work correctly per-locale -* Better support for future versions of Rails as `mobility` is more actively maintained - -Admin: - -* Rich-text editor for product description translations in admin (if enabled) -* Searching by product SKU in admin -* Admin product search will no longer return duplicate results -* Works correctly if using custom Spree.admin_path config - ## Installation Add the following to your `Gemfile`: ```ruby @@ -36,28 +21,39 @@ You can use the generator to install migrations and append spree_mobility assets to your app spree manifest file. rails g spree_mobility:install -This will insert these lines into your spree manifest files: - -``` -vendor/assets/javascripts/spree/backend/all.js -//= require spree/backend/spree_mobility -``` - It is also recommended to configure Mobility fallback locales, especially if your admin locale is not the same as your Store's default_locale. For example if you have en and de locale: -``` +```ruby # config/initializers/mobility.rb Mobility.configure do plugins do fallbacks({ :en => [:de], :de => [:en] }) end end ``` --- + +## Improvements over spree_globalize + +This gem offers several improvements over `spree_globalize`: + +* Proper translation fallbacks support (if a translation for the current locale is missing, it will fallback to other locales, strictly based on configured fallbacks): + * for finders (slug/permalink) + * when searching by product name (frontend & admin search) +* Proper validations on translation models (e.g. slug presence validation), also meaning uniqueness validations will now work correctly per-locale +* Better support for future versions of Rails as `mobility` is more actively maintained + +Admin: + +* Rich-text editor for product description translations in admin (if enabled) +* Admin product search will no longer return duplicate results +* Works correctly if using custom Spree.admin_path config + +For more localization features, see my `better_spree_localization` gem. ## Model Translations This feature uses the [Mobility][3] gem to localize model data. So far the following models are translatable: