default_scope(scope = nil)Link
Use this macro in your model to set a default scope for all operations on the model.
class Article < ActiveRecord::Base
default_scope { where(published: true) }
end
Article.all # => SELECT * FROM articles WHERE published = true
The default_scope is also applied while creating/building are cord. It is not applied while updating a record.
Article.new.published # => true
Article.create.published # => true
(You can also pass any object which responds to call to the default_scope macro, and it will be called when building thedefault scope.)
If you use multiple default_scope declarations in your model then they will be merged together:
class Article < ActiveRecord::Base
default_scope { where(published: true) }
default_scope { where(rating: 'G') }
end
Article.all # => SELECT * FROM articles WHERE published = true AND rating = 'G'
This is also the case with inheritance and module includes where the parentor module defines adefault_scope and the child or includingclass defines a second one.
If you need to do more complex things with a default scope, you canalternatively define it as a class method:
class Article < ActiveRecord::Base
def self.default_scope
# Should return a scope, you can call 'super' here etc.
end
end
Use this macro in your model to set a default scope for all operations on the model.
class Article < ActiveRecord::Base
default_scope { where(published: true) }
end
Article.all # => SELECT * FROM articles WHERE published = true
The default_scope is also applied while creating/building are cord. It is not applied while updating a record.
Article.new.published # => true
Article.create.published # => true
(You can also pass any object which responds to call to the default_scope macro, and it will be called when building thedefault scope.)
If you use multiple default_scope declarations in your model then they will be merged together:
class Article < ActiveRecord::Base
default_scope { where(published: true) }
default_scope { where(rating: 'G') }
end
Article.all # => SELECT * FROM articles WHERE published = true AND rating = 'G'
This is also the case with inheritance and module includes where the parentor module defines adefault_scope and the child or includingclass defines a second one.
If you need to do more complex things with a default scope, you canalternatively define it as a class method:
class Article < ActiveRecord::Base
def self.default_scope
# Should return a scope, you can call 'super' here etc.
end
end