gem 'spree', github: 'spree/spree', branch: '1-3-stable'```
Run `bundle update spree`.
This version of Spree bumps the dependency for jquery-rails to this:
gem 'jquery-rails', '2.2.0'```
Ensure that you have a line such as this in your Gemfile to allow that dependency.
## Copy and run migrations
Copy over the migrations from Spree (and any other engine) and run them using
In older versions of Spree, we had a helper method called `money` which
occasionally formatted money amounts incorrectly. Specifically, if the `I18n.locale` was changed, currencies started to display in that amount, rather than the proper amount. An item that was once $100, would suddenly become 100¥ if the locale was switched to Japanese, for instance.
In Spree 1.3, money handling
has been reworked by a major contribution by the [Free Running
Technologies](http://www.freerunningtech.com/) team. See [#2197](https://github.com/spree/spree/pull/2197) for details.
Prices are now stored in a separate table, called `spree_prices`. This table tracks the variant, the price amount, and the currency. This allows for variants to have different prices in different currencies.
Along with this, we introduced the `Spree::Money` class which is used to display amounts correctly. Where previously Spree would have done this:
<td><%%= money adjustment.amount %></td>```
<td><%%= adjustment.display_amount.to_html %></td>```
Alternatively, you can use `Spree::Money.new(amount)` to get a `Spree::Money` representation. Calling `to_html` on that object will format it neatly for HTML views, and calling `to_s` will format it nicely everywhere else.
Along with these changes, the `Spree::Variant.active` scope now takes an argument for the currency. Whatever currency is specified will return variants in that currency. Previously it may have been enough to just do this:
But now you must specify a currency:
Or you can rely on the current currency within views:
## Read the release notes
For information about changes contained with this release, please read the [1.3.0 Release Notes](http://guides.spreecommerce.org/release_notes/spree_1_3_0.html).
## Verify that everything is OK
Click around in your store and make sure it's performing as normal. Fix any deprecation warnings you see.