Permalink
Browse files

Add docs explaining how to protect all attributes using attr_accessib…

…le with no arguments. Closes #9631 [boone, rmm5t]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@8032 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
  • Loading branch information...
1 parent 27941f6 commit d761ac409586f887570cba88cf8d74f2c783223b Marcel Molina committed Oct 26, 2007
Showing with 19 additions and 1 deletion.
  1. +2 −0 activerecord/CHANGELOG
  2. +17 −1 activerecord/lib/active_record/base.rb
View
@@ -1,5 +1,7 @@
*SVN*
+* Add docs explaining how to protect all attributes using attr_accessible with no arguments. Closes #9631 [boone, rmm5t]
+
* Update add_index documentation to use new options api. Closes #9787 [kamal]
* Allow find on a has_many association defined with :finder_sql to accept id arguments as strings like regular find does. Closes #9916 [krishna]
@@ -623,6 +623,8 @@ def decrement_counter(counter_name, id)
#
# customer.credit_rating = "Average"
# customer.credit_rating # => "Average"
+ #
+ # To start from an all-closed default and enable attributes as needed, have a look at attr_accessible.
def attr_protected(*attributes)
write_inheritable_array("attr_protected", attributes - (protected_attributes || []))
end
@@ -634,7 +636,21 @@ def protected_attributes # :nodoc:
# If this macro is used, only those attributes named in it will be accessible for mass-assignment, such as
# <tt>new(attributes)</tt> and <tt>attributes=(attributes)</tt>. This is the more conservative choice for mass-assignment
- # protection. If you'd rather start from an all-open default and restrict attributes as needed, have a look at
+ # protection.
+ #
+ # Example:
+ #
+ # class Customer < ActiveRecord::Base
+ # attr_accessible :phone, :email
+ # end
+ #
+ # Passing an empty argument list protects all attributes:
+ #
+ # class Product < ActiveRecord::Base
+ # attr_accessible # none
+ # end
+ #
+ # If you'd rather start from an all-open default and restrict attributes as needed, have a look at
# attr_protected.
def attr_accessible(*attributes)
write_inheritable_array("attr_accessible", attributes - (accessible_attributes || []))

0 comments on commit d761ac4

Please sign in to comment.