faithfulgeek / acts_as_currency

Allows you to enter a '$' in fields stored as decimal but are actually currency types

This URL has Read+Write access

acts_as_currency / README
100644 45 lines (30 sloc) 2.227 kb
raw blame history 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

ActsAsCurrency
==============
 
There's a problem in ActiveRecord.  Let's say you have a field in a table that's supposed to be money, for example:
 
add_column :products, :price, :decimal
 
and you have an entry form on your website for admins to add products.  Without even thinking, they will likely type the price with a dollar sign ('$').  If you follow the principal of least surprise, you will need to support this scenario.  However, since ActiveRecord interprets the type as a decimal (since that's how it is in the database), you will get a silent fail in which all of your prices are 0!  This is because all characters after the first non-number are interpreted as 0.  That's where acts_as_currency comes in.  Add it to your model and pass in any price fields, and they will all be able to take a '$'.  Hope you enjoy!  If you have any questions, please feel free to contact me at joe@faithfulgeek.org.
 
Install
=======
 
This project is hosted on github.  There are a few options for installing it.
 
#1 Using git-rails gem
	- This is by far the easiest method.  Install git-rails by issuing:
			sudo gem install git-rails (Windows: gem install git-rails)
			git-rails install git://github.com/faithfulgeek/acts_as_currency.git
 
#2 Using git-clone
	- This method requires that you have Git installed (might as well do it, it's a great alternative to svn)
	- Assumes your current working directory is your rails app root
	cd vendor/plugins
	git-clone git://github.com/faithfulgeek/acts_as_currency.git acts_as_currency
 
#3 Source Tarball
	- If you cannot access Git at all, use this link http://github.com/faithfulgeek/acts_as_currency/tarball/master to download the source tarball
	cd vendor/plugins
	mkdir acts_as_currency && cd acts_as_currency
	tar xvcf faithfulgeek-acts-as-currency-master.tar.gz
 
Troubles?  Let me know!  joe@faithfulgeek.org
 
Example
=======
 
class Product < ActiveRecord::Base
	acts_as_currency :price, :discount_price
end
 
For an example of the problem and how acts_as_currency solves it, please see specs/acts_as_currency_spec.rb.  If you have rspec installed you can play around with different values and see how it all works.
 
 
Copyright (c) 2008 Joe Fiorini, released under the MIT license