Solidus Internationalization

This is the Internationalization project for Solidus

---

Changes in Version 2.0

solidus_i18n Version 2.0+ only contains translation files.

Previous versions of solidus_i18n included extra functionality like locale selectors and which is now built in to Solidus 2.6+. Configuration for routing-filter has also been removed and must be configured manually (See Locale in URL).

Installation

Add the following to your Gemfile:

gem 'solidus_i18n'
gem 'rails-i18n'
gem 'kaminari-i18n'

Locale in URL

Older versions of solidus_i18n included the routing-filter gem and configured routes to include the locale in the URL. This is still supported (maybe even recommended) but requires some additional configuration.

1. Add this gem to your Gemfile, then run bundle install

gem 'routing-filter'

2. Add filter :locale to your config/routes.rb

Rails.application.routes.draw do
  filter :locale

  mount Spree::Core::Engine, at: '/'
end

3. Configure routing-fitler in config/initializers/locale_filter.rb (optional)

# Do not include the default locale in the URL
RoutingFilter::Locale.include_default_locale = false

Supported languages

We currently support the following locales by default. If you need a locale that is not in the list you can add a custom translation file into your application by following the Rails translations guide.

Updating Translations

If you want to improve the translations on your language, run the tasks:

bundle exec rake solidus_i18n:update_default
bundle exec i18n-tasks add-missing --nil-value --locale <LOCALE>

Substitute with your locale code (e.g: it).

This will do a cleanup and prepare <LOCALE>.yml with all the missing keys. You can then write the translations and open a pull request.

Model Translations

We removed support for translating models into a separate Gem.

Please update your Gemfile if you still need the model translations.

# Gemfile
gem 'solidus_globalize', github: 'solidusio-contrib/solidus_globalize', branch: 'master'

Localizing country names

You can translate country names by defining spree.country_names in your own locale files. For example, to have countries in Spanish do:

es:
  spree:
    country_names:
      US: Estados Unidos de América
      UK: Reino Unido
      CA: Canadá
      # ...

Some supported languages already define localized country names. Take a look at this repo's .yml files for your locale to confirm if we already provide translations.

Contributing

Solidus is an open source project and we encourage contributions. Please read CONTRIBUTING.md before contributing.

Development

Testing the extension

First bundle your dependencies, then run bin/rake. bin/rake will default to building the dummy app if it does not exist, then it will run specs. The dummy app can be regenerated by using bin/rake extension:test_app.

bin/rake

To run Rubocop static code analysis run

bundle exec rubocop

When testing your application's integration with this extension you may use its factories. You can load Solidus core factories along with this extension's factories using this statement:

SolidusDevSupport::TestingSupport::Factories.load_for(SolidusI18n::Engine)

Running the sandbox

To run this extension in a sandboxed Solidus application, you can run bin/sandbox. The path for the sandbox app is ./sandbox and bin/rails will forward any Rails commands to sandbox/bin/rails.

Here's an example:

$ bin/rails server
=> Booting Puma
=> Rails 6.0.2.1 application starting in development
* Listening on tcp://127.0.0.1:3000
Use Ctrl-C to stop

Releasing new versions

Please refer to the dedicated page in the Solidus wiki.

License

Copyright (c) 2026 Thomas von Deyen, released under the New BSD License.