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: