@@ -1,3 +1,7 @@ +== 2008-07-17 + +* Can now use a named_scope to find tags! + == 2008-06-23 * Can now find related objects of another class (tristanzdunn) CHANGELOG @@ -76,15 +76,35 @@ end @user.tags # => [<Tag name:"awesome">,<Tag name:"slick">,<Tag name:"hefty">] @user.skills # => [<Tag name:"joking">,<Tag name:"clowning">,<Tag name:"boxing">] +# The old way User.find_tagged_with("awesome", :on => :tags) # => [@user] User.find_tagged_with("awesome", :on => :skills) # => [] +# The better way (utilizes named_scope) +User.tagged_with("awesome", :on => :tags) # => [@user] +User.tagged_with("awesome", :on => :skills) # => [] + @frankie = User.create(:name => "Frankie", :skill_list => "joking, flying, eating") User.skill_counts # => [<Tag name="joking" count=2>,<Tag name="clowning" count=1>...] @frankie.skill_counts +Finding Tagged Objects +====================== + +Acts As Taggable On utilizes Rails 2.1's named_scope to create an association +for tags. This way you can mix and match to filter down your results, and it +also improves compatibility with the will_paginate gem: + +class User < ActiveRecord::Base + acts_as_taggable_on :tags + named_scope :by_join_date, :order => "created_at DESC" +end + +User.tagged_with("awesome").by_date +User.tagged_with("awesome").by_date.paginate(:page => params[:page], :per_page => 20) + Relationships -==================== +============= You can find objects of the same type based on similar tags on certain contexts. Also, objects will be returned in descending order based on the total number of README @@ -79,6 +79,12 @@ module ActiveRecord before_save :save_cached_tag_list after_save :save_tags + + if respond_to?(:named_scope) + named_scope :tagged_with, lambda{ |tags, options| + find_options_for_find_tagged_with(tags, options) + } + end end include ActiveRecord::Acts::TaggableOn::InstanceMethods lib/acts_as_taggable_on/acts_as_taggable_on.rb @@ -56,6 +56,15 @@ describe "Taggable" do TaggableModel.find_tagged_with("bob", :on => :tags).first.should == @taggable end + it "should be able to use the tagged_with named scope" do + @taggable.skill_list = "ruby, rails, css" + @taggable.tag_list = "bob, charlie" + @taggable.save + TaggableModel.tagged_with("ruby", {}).first.should == @taggable + TaggableModel.tagged_with("bob", :on => :skills).first.should_not == @taggable + TaggableModel.tagged_with("bob", :on => :tags).first.should == @taggable + end + it "should not care about case" do bob = TaggableModel.create(:name => "Bob", :tag_list => "ruby") frank = TaggableModel.create(:name => "Frank", :tag_list => "Ruby") spec/acts_as_taggable_on/taggable_spec.rb 888bab36bdadc4b579f209c527d7c7b07af2b2a8 Michael Bleigh michael@intridea.com http://github.com/mbleigh/acts-as-taggable-on/commit/77f3e951162d39a2c57788d6a8bdb4f48680e4d1 77f3e951162d39a2c57788d6a8bdb4f48680e4d1 2008-07-17T12:33:48-07:00 2008-07-17T12:33:48-07:00 Added the 'tagged_with' named_scope for total awesomeness. c9bf9f14a66061858581de23b463b512ba7fb189 Michael Bleigh michael@intridea.com