No commit activity in last 3 years
No release in over 3 years
Spree Extension that adds translations to products
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 0.1.0.beta
>= 0.40.3
 Project Readme

Spree Product Translations

Makes product details, properties, prototypes, taxonomies and option types translatable by bridging the Globalize3 gem.

Installation and configuration

In your Gemfile, add:

gem 'spree_product_translations'

Then install the gem:

bundle install

Then copy the migrations to your spree application:

rake spree_product_translations:install

Finally migrate your database:

rake db:migrate

If you have pre-existing data, you'll need to run this rake task:

rake spree:extensions:product_translations:globalize_legacy_data

it will copy the original data over to the new translation tables. Globalize3 doesn't default to the original model table for the default locale like v1 used to.

How to use it

To edit the content in a specific language, simply change the locale on the language nav, and edit on the admin as usual.

Translated fields

Product

  • name
  • description
  • meta_description
  • meta_keywords

Property

  • presentation

Prototype

  • name

Taxonomy

  • name

Taxon

  • name
  • description

OptionType

  • presentation

OptionValue

  • presentation

Fallbacks for empty translations

If you have translations in your database (by using the spree-simple_product_translations extension for example) with empty translations (being a blank string instead of nil) you might want to add this configuration option to an initializer in your app:

Spree::Config.set :fallbacks_for_empty_translations => true

It will then use fallbacks for empty strings too.

Running tests

The tests are not updated since the original fork of the spree 0.11 compatible version. They will pretty sure fail. Feel free to fork the project and create a pull request with tests.

Test information by oliverbarnes

You might need to comment out the rspec gem requirement under config/environments/test.rb - for some reason, even with both the rspec gem and plugin installed, I would keep getting an annoying missing gem error.

Spree is officially making a choice for Test::Unit anyway, so this shouldn't create a problem.

(not that I don't like Rspec, I actually prefer it in other projects.)

Feature requests and patches welcome

If you see anything you need missing, or if you have a useful patch, feel free to submit them on the Issues section of the github project.