Skip to content

🌍 Model data globalization for Solidus

License

BSD-3-Clause, BSD-3-Clause licenses found

Licenses found

BSD-3-Clause
LICENSE
BSD-3-Clause
LICENSE.md
Notifications You must be signed in to change notification settings

batamire/solidus_globalize

 
 

Solidus Globalize

CircleCICode Climate

This is the globalization project for Solidus.

NOTE: If you just need to change the language of your store, and will only have data in database in one language, then you don't need this gem, use solidus_i18n, which provides translations for static content (links, headers etc).

This gem adds the model data translation support using the Globalize gem. Read more

Happy translating!


Installation

Add the following to your Gemfile:

gem 'solidus_globalize', github: 'solidusio-contrib/solidus_globalize'

Run bundle install

You can use the generator to install migrations and append solidus_globalize assets to your app solidus manifest file.

bin/rails g solidus_globalize:install

This will insert this line into your solidus manifest file (vendor/assets/javascripts/spree/backend/all.js):

//= require spree/backend/solidus_globalize

Model Translations

This feature uses the Globalize gem to localize model data. So far the following models are translatable:

Product, Promotion, OptionType, Taxonomy, Taxon, Property and ShippingMethod.

Start your server and you should see a TRANSLATIONS link or a flag icon on each admin section that supports this feature.

To enable adding translations in admin for a specific language you have to set into an initializer:

SolidusGlobalize::Config.supported_locales = [:en, :'pt-BR']

PS 1. The languages you add to this configuration need to be supported by your store. This means that you need to have a transations file for them into /config/locales/ (eg. /config/locales/pt-BR.yml).

PS 2. Please use symbols, not strings. e.g. :'pt-BR' not just 'pt-BR'. Otherwise you may get unexpected errors

Or if you prefer they're also available on the admin UI general settings section.

Every record needs to have a translation. If by any chance you remove solidus_globalize from your Gemfile, add some records and then add solidus_globalize gem back you might get errors like undefined method for nilClass because Globalize will try fetch translations that do not exist.


Contributing

See corresponding guidelines


Copyright (c) 2020 Soldius and other contributors. Released under the New BSD License

About

🌍 Model data globalization for Solidus

Resources

License

BSD-3-Clause, BSD-3-Clause licenses found

Licenses found

BSD-3-Clause
LICENSE
BSD-3-Clause
LICENSE.md

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 79.5%
  • HTML 16.8%
  • CoffeeScript 3.4%
  • Other 0.3%