mbleigh-acts-as-taggable-on 1.0.1 → 1.0.2

data/CHANGELOG

@@ -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)

data/README

@@ -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 

data/lib/acts_as_taggable_on/acts_as_taggable_on.rb

@@ -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

data/spec/acts_as_taggable_on/taggable_spec.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")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mbleigh-acts-as-taggable-on
 version: !ruby/object:Gem::Version 
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors: 
 - Michael Bleigh