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: 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:
    shell
    bundle install

  2. Copy & run migrations
    shell
    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.

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

Comments

No comments yet

Please login to add comment.