Build Status
Code Climate

Spree currency converter. Use foreign exchange rates (relative to main currency) mannualy entered in admin area.

Extends spree-contrib/spree_multi_currency.

Adds FX Rates tab:
FX Rates tab

FX Rates currencies based from general settings:
General settings

Prices are calculated relative to product master price:

Prices are recalculated each time when product/variant is changing
When FX Rate changes - all products prices are recalculated

Product prices:
Product prices

Frontend product example:

Frontend example 1
Frontend example 2
Frontend example 3

FX Rates can be fetched from http://fixer.io/ (JSON API for foreign exchange rates and currency conversion) from the admin area


  1. Add this extension to your Gemfile with this line: ruby gem 'spree_fx_currency', github: 'itbeaver/spree_fx_currency', branch: '3-0-stable'

The branch option is important: it must match the version of Spree you're using.
For example, use 3-1-stable if you're using Spree 3-1-stable or any 3.1.x version.

  1. Install the gem using Bundler:
    bundle install

  2. Copy & run migrations
    bundle exec rails g spree_fx_currency:install

  3. Restart your server

If your server was running, restart it so that it can find the assets properly.


First bundle your dependencies, then run rake. 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 rake test_app.

bundle exec rake

When testing your applications integration with this extension you may use it's factories.
Simply add this require statement to your spec_helper:

require 'spree_fx_currency/factories'

Don't forget to run spree_multi_currency generator in spec/dummy directory

bundle exec rails g spree_multi_currency:install


If you'd like to contribute, please take a look at the
instructions for installing dependencies and crafting a good
pull request.

Copyright (c) 2016 Artem Russkikh, released under the New BSD License


No comments yet

Please login to add comment.