aboutsummaryrefslogtreecommitdiffstats
path: root/activemodel/lib/active_model/validations/confirmation.rb
diff options
context:
space:
mode:
authorDavid Heinemeier Hansson <david@loudthinking.com>2008-04-01 00:05:48 +0000
committerDavid Heinemeier Hansson <david@loudthinking.com>2008-04-01 00:05:48 +0000
commit87535bd373a1d8a437b1d04a0272d35025192a79 (patch)
tree2bc21fac76ac0ad4facec36197a414b9c7d56bba /activemodel/lib/active_model/validations/confirmation.rb
parenta5445fd9c50161b8ccf2b36fcd26025882f73eaa (diff)
downloadrails-87535bd373a1d8a437b1d04a0272d35025192a79.tar.gz
rails-87535bd373a1d8a437b1d04a0272d35025192a79.tar.bz2
rails-87535bd373a1d8a437b1d04a0272d35025192a79.zip
Splitting them up first
git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@9173 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
Diffstat (limited to 'activemodel/lib/active_model/validations/confirmation.rb')
-rw-r--r--activemodel/lib/active_model/validations/confirmation.rb44
1 files changed, 44 insertions, 0 deletions
diff --git a/activemodel/lib/active_model/validations/confirmation.rb b/activemodel/lib/active_model/validations/confirmation.rb
new file mode 100644
index 0000000000..79c6635177
--- /dev/null
+++ b/activemodel/lib/active_model/validations/confirmation.rb
@@ -0,0 +1,44 @@
+module ActiveModel
+ module Validations
+ module ClassMethods
+ # Encapsulates the pattern of wanting to validate a password or email address field with a confirmation. Example:
+ #
+ # Model:
+ # class Person < ActiveRecord::Base
+ # validates_confirmation_of :user_name, :password
+ # validates_confirmation_of :email_address, :message => "should match confirmation"
+ # end
+ #
+ # View:
+ # <%= password_field "person", "password" %>
+ # <%= password_field "person", "password_confirmation" %>
+ #
+ # The added +password_confirmation+ attribute is virtual; it exists only as an in-memory attribute for validating the password.
+ # To achieve this, the validation adds accessors to the model for the confirmation attribute. NOTE: This check is performed
+ # only if +password_confirmation+ is not nil, and by default only on save. To require confirmation, make sure to add a presence
+ # check for the confirmation attribute:
+ #
+ # validates_presence_of :password_confirmation, :if => :password_changed?
+ #
+ # Configuration options:
+ # * <tt>message</tt> - A custom error message (default is: "doesn't match confirmation")
+ # * <tt>on</tt> - Specifies when this validation is active (default is :save, other options :create, :update)
+ # * <tt>if</tt> - Specifies a method, proc or string to call to determine if the validation should
+ # occur (e.g. :if => :allow_validation, or :if => Proc.new { |user| user.signup_step > 2 }). The
+ # method, proc or string should return or evaluate to a true or false value.
+ # * <tt>unless</tt> - Specifies a method, proc or string to call to determine if the validation should
+ # not occur (e.g. :unless => :skip_validation, or :unless => Proc.new { |user| user.signup_step <= 2 }). The
+ # method, proc or string should return or evaluate to a true or false value.
+ def validates_confirmation_of(*attr_names)
+ configuration = { :message => ActiveRecord::Errors.default_error_messages[:confirmation], :on => :save }
+ configuration.update(attr_names.extract_options!)
+
+ attr_accessor(*(attr_names.map { |n| "#{n}_confirmation" }))
+
+ validates_each(attr_names, configuration) do |record, attr_name, value|
+ record.errors.add(attr_name, configuration[:message]) unless record.send("#{attr_name}_confirmation").nil? or value == record.send("#{attr_name}_confirmation")
+ end
+ end
+ end
+ end
+end \ No newline at end of file