Skip to content

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

License

Notifications You must be signed in to change notification settings

itbeaver/spree_fx_currency

Repository files navigation

SpreeFxCurrency

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: Product

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

Installation

  1. Add this extension to your Gemfile with this line:
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
  1. Copy & run migrations
bundle exec rails g spree_fx_currency:install
  1. Restart your server

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

Testing

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
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

Contributing

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