Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
An ActiveRecord extension that helps you format and validate phone numbers.
Ruby
Branch: master
Pull request Compare This branch is 1 commit ahead of btelles:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
spec
tasks
.gitignore
Gemfile
README
README.rdoc
Rakefile
discover.rb
validates_and_formats_phones.gemspec

README.rdoc

ValidatesAndFormatsPhones

Allows you to easily format and validate phone numbers in your desired format (sensible defaults provided).

Just add 'validates_and_formats_phones' to your ActiveRecord model.

The default format is a 10-digit US phone number on the column 'phone'. But you can change all that…just read on.

Installation

  1. Install it as a gem:

    (sudo) gem install validates_and_formats_phones
  2. Then add it to your Gemfile file

    gem 'validates_and_formats_phones', '~> 1.0.0'
  3. Add the method validates_and_formats_phones to your model

Example

Adding the validates_and_formats_phones method by itself gives you validation and formatting for the field :phone like so:

class Person
  validates_and_formats_phones
end

> person = Person.new(:phone => '123 456 7890')
> person.save 
> person.phone 
> => '(123) 456-7890'
>
> person.phone = '123'
> person.save
> => false

You can pass your own fields like so:

class Person
  validates_and_formats_phones :fax, :mobile
end

Or your own formats by using a # symbol for number substitutions:

class Person
  validates_and_formats_phones '####-####', '### ###-####'
end

Note that the validation is simplistic. It counts the number of digits in the given field. If the number of digits in the given field matches one of the formats, then the validation passes and the format that has the same number of '#' symbols will be used to format the phone number.

You can also format and specify fields, like so:

class Person
  validates_and_formats_phones :fax, mobile, '####-####'
end

Configuration options

All configuration options available to validates_each are also available to the phone validator. For example:

class Person
  validates_and_formats_phones :fax, '###-###-####', :if => :some_function_name
end

Here's a quick link to the validates_each documentation at the time of writing:

http://api.rubyonrails.org/classes/ActiveModel/Validations/ClassMethods.html#method-i-validates_each

Tiny string extension

As a tiny added benefit, String is extended with a to_phone method.

> '123 456 7890'.to_phone
> => '(123) 456-7890'
>
> '12345678'.to_phone('####-####')
> => '1234-5678'

Change Log

1.0.0
 No significant changes.
0.0.10
 1. Make compatible with Rails 3 (note this breaks compatibility with previous Rails versions)
0.0.7
 1. Bug fix for ...yes... Ruby 1.8.5...That's dedication right there.
0.0.6
 1. Add configuration options available in validates_each method.

If you find any bugs, please report them at our github page:

http://github.com/btelles-validates_and_formats_phones

Copyright © 2010 [Bernie Telles], released under the MIT license

Something went wrong with that request. Please try again.