README.textile

Introduction

Rails plugin which simplifies adding money and currency attributes to
ActiveRecord models. Uses money gem by RubyMoney.

Installation

Install the plugin:

  script/plugin install git://github.com/kammerer/has_money.git

Usage

Currency field:

class Foo < ActiveRecord::Base
  has_currency :currency
  validates_currency :currency, :in => ["EUR", "PLN"]
end

foo = Foo.new
foo.currency = "EUR"
foo.currency # -> Money::Currency.new("EUR")

foo.currency = Money::Currency.new("PLN") 
foo.currency # -> Money::Currency.new("PLN")

Uses single database column called currency (string).

Money and currency fields:

class Bar < ActiveRecord::Base
  has_money :price
  validates_money :price, :greater_than => 0, :currency => { :in => ["EUR", "PLN"] }
end

bar = Bar.new
bar.price_currency = "EUR"
bar.price = 5
bar.price # -> Money.new(500, "EUR")

bar.price = Money.new(1000, "PLN")
bar.price # -> Money.new(2.5, "EUR")

bar.price_currency = "PLN"
bar.price # -> Money.new(1000, "PLN") assuming 1 EUR == 4 PLN

Uses two database columns:

• price (integer)
• price_currency (string)

Money validation options:

• :greater_than
• :greater_than_or_equal
• :less_than
• :less_than_or_equal
• :between

All options except :between expects amount of money in main units (i.e. euros or dollars, not cents) as a value. :between expects
a range.

Multiple money fields with the same currency:

class Baz
  has_currency :currency, :for => [:min_price, :max_price]
  has_money :min_price, :with_currency => :currency
  has_money :max_price, :with_currency => :currency
end

Uses three database columns:

• min_price (integer)
• max_price (integer)
• currency (string)

TODOs

• tests for ActiveRecord style validations