= acts_as_zipcoded

This plugin allows an ActiveRecord model to have zipcode information.  It provides a complete list of US zipcodes by city and state.

== Where to get it

Subversion

* http://svn.6brand.com/projects/plugins/acts_as_zipcoded

How to install it

1. type the following:
    ruby script/plugin source http://svn.6brand.com/projects/plugins
    ruby script/plugin install acts_as_zipcoded
    
2. create and execute a migration based off the example_migration.rb found in this plugin.

3. add a string column to the model you want to modify.  NOTE: This must be a string column, not an integer!
    add_column :users, :zip_id, :string
    
4. add the acts_as_zipcoded command to your model:
    class User < ActiveRecord::Base
      acts_as_zipcoded
    end

This will give you the following object methods:
zipcode
zipcode=(any valid zipcode)
city
state

So you can use it like so:
@user = User.new
@user.zipcode = 90210
@user.city            => "Beverly Hills"
@user.state           => "CA"
@user.zipcode = 00000
@user.city            => nil
@user.zipcode = 98125
@user.city            => "Seattle"

Many thanks to Rick Olson whose source code I totally stared at while writing this thing.