radiant-taggable-extension 1.2.0

data/spec/datasets/tags_dataset.rb

@@ -0,0 +1,43 @@
+require 'digest/sha1'
+
+class TagsDataset < Dataset::Base
+  datasets = [:pages]
+  datasets << :tag_sites if defined? Site
+  uses *datasets
+  
+  def load
+    create_tag "colourless"
+    create_tag "green"
+    create_tag "ideas"
+    create_tag "sleep"
+    create_tag "furiously"
+    
+    apply_tag :colourless, pages(:first)
+    apply_tag :ideas, pages(:first), pages(:another), pages(:grandchild)
+    apply_tag :sleep, pages(:first)
+    apply_tag :furiously, pages(:first)
+  end
+  
+  helpers do
+    def create_tag(title, attributes={})
+      attributes = tag_attributes(attributes.update(:title => title))
+      tag = create_model Tag, title.symbolize, attributes
+    end
+    
+    def tag_attributes(attributes={})
+      title = attributes[:name] || "Tag"
+      attributes = { 
+        :title => title
+      }.merge(attributes)
+      attributes[:site] = sites(:test) if defined? Site
+      attributes
+    end
+        
+    def apply_tag(tag, *items)
+      tag = tag.is_a?(Tag) ? tag : tags(tag)
+      items.each { |i| i.attached_tags << tag }
+    end
+    
+  end
+ 
+end

data/spec/lib/taggable_page_spec.rb

@@ -0,0 +1,93 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Page do
+  dataset :tags
+  
+  it "should report itself taggable" do
+    Page.is_taggable?.should be_true
+  end
+
+  it "should return a list of pages form tag list" do
+    Page.tagged_with("colourless").should == [pages(:first)]
+  end
+  
+  it "should return a weighted list of tags from page list" do
+    Page.tags_for_cloud_from([pages(:first)]).should == Tag.from_list("colourless, ideas, sleep, furiously")
+  end
+  
+  describe "instantiated with tags" do
+    before do
+      @page = pages(:first)
+    end
+    
+    it "should return tag list" do
+      @page.attached_tags.should == Tag.from_list("colourless, ideas, sleep, furiously")
+    end
+    
+    it "should add and remove tags" do
+      @page.add_tag("howdy")
+      @page.attached_tags.should == Tag.from_list("colourless, ideas, sleep, furiously, howdy")
+      @page.remove_tag("howdy")
+      @page.attached_tags.should == Tag.from_list("colourless, ideas, sleep, furiously")
+      Tag.for('Howdy').pages.include?(@page).should be_false
+    end
+
+    it "should return tags string as keywords" do
+      @page.keywords.should == "colourless, ideas, sleep, furiously"
+    end
+
+    it "should accept tags string as keywords=" do
+      @page.keywords = "Lovable, Rogue"
+      @page.attached_tags.should == [Tag.for("Lovable"), Tag.for("Rogue")]
+      @page.keywords.should == "Lovable, Rogue"
+    end
+
+    it "should return keywords string to keywords_before_type_cast (for form helpers)" do
+      @page.keywords_before_type_cast.should == "colourless, ideas, sleep, furiously"
+    end
+    
+    it "should return a list of related pages" do
+      @page.related.include?(pages(:another)).should be_true
+      @page.related.include?(pages(:child)).should be_false
+      @page.related.include?(pages(:grandchild)).should be_true
+    end
+    
+    it "should have related_pages methods" do
+      @page.respond_to?(:related_pages).should be_true
+      @page.respond_to?(:closely_related_pages).should be_true
+    end
+    
+  end
+  
+  describe "when cloud-building" do
+    describe "across the whole collection" do
+      before do
+        @tags = Tag.sized(Tag.most_popular(10))
+      end
+      
+      it "should weight the tags" do
+        tag = @tags.select{|t| t.title = "Ideas"}.first
+        tag.cloud_size.should_not be_nil
+        tag.use_count.should == "3"                 # counting every use
+      end
+    end
+    
+    before do
+      @page = pages(:parent)
+      @tags = @page.tags_for_cloud
+    end
+    
+    it "should gather its descendants" do
+      @page.with_children.length.should == 6
+      @page.with_children.include?(pages(:child_2)).should be_true
+      @page.with_children.include?(pages(:great_grandchild)).should be_true
+    end
+
+    it "should return a weighted list of tags attached to itself and descendants" do
+      @tags.first.should == tags(:ideas)
+      @tags.first.cloud_size.should_not be_nil
+      @tags.first.use_count.should == "1"           # counting only within this family tree
+    end
+
+  end
+end

data/spec/models/tag_spec.rb

@@ -0,0 +1,39 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Tag do
+  dataset :tags
+  
+  it "should reuse an existing tag if possible" do
+    tag = Tag.for('colourless')
+    tag.should == tags(:colourless)
+  end
+  
+  it "should create a tag where none exists" do
+    tag = Tag.for('calumny')
+    tag.should be_valid
+    tag.new_record?.should be_false
+  end
+
+  it "should find_or_create tags from a list" do
+    tags = Tag.from_list('colourless,ideas,lifebelt')
+    tags[0].should == tags(:colourless)
+    tags[1].should == tags(:ideas)
+    tags[2].created_at.should be_close((Time.now).utc, 10.seconds)
+  end
+  
+  describe "instantiated" do
+    before do
+      @tag = tags(:sleep)
+    end
+    
+    it "should have retrieval methods for taggable models" do
+      @tag.respond_to?(:page_taggings).should be_true
+      @tag.respond_to?(:pages).should be_true
+    end
+    
+    it "should return its list of pages" do
+      @tag.pages.should == [pages(:first)]
+    end
+    
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+profile
+--loadby
+mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,36 @@
+unless defined? RADIANT_ROOT
+  ENV["RAILS_ENV"] = "test"
+  case
+  when ENV["RADIANT_ENV_FILE"]
+    require ENV["RADIANT_ENV_FILE"]
+  when File.dirname(__FILE__) =~ %r{vendor/radiant/vendor/extensions}
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../../")}/config/environment"
+  else
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../")}/config/environment"
+  end
+end
+require "#{RADIANT_ROOT}/spec/spec_helper"
+
+Dataset::Resolver.default << (File.dirname(__FILE__) + "/datasets")
+
+if File.directory?(File.dirname(__FILE__) + "/matchers")
+  Dir[File.dirname(__FILE__) + "/matchers/*.rb"].each {|file| require file }
+end
+
+Spec::Runner.configure do |config|
+  # config.use_transactional_fixtures = true
+  # config.use_instantiated_fixtures  = false
+  # config.fixture_path = RAILS_ROOT + '/spec/fixtures'
+
+  # You can declare fixtures for each behaviour like this:
+  #   describe "...." do
+  #     fixtures :table_a, :table_b
+  #
+  # Alternatively, if you prefer to declare them only once, you can
+  # do so here, like so ...
+  #
+  #   config.global_fixtures = :table_a, :table_b
+  #
+  # If you declare global fixtures, be aware that they will be declared
+  # for all of your examples, even those that don't use them.
+end

data/taggable_extension.rb

@@ -0,0 +1,36 @@
+class TaggableExtension < Radiant::Extension
+  version "1.2.0"
+  description "General purpose tagging and retrieval extension: more versatile but less focused than the tags extension"
+  url "http://github.com/spanner/radiant-taggable-extension"
+    
+  def activate
+    ActiveRecord::Base.send :include, TaggableModel                     # provide is_taggable for everything but don't call it for anything
+    Page.send :is_taggable                                              # make pages taggable 
+    Page.send :include, TaggablePage                                    # then fake the keywords column and add some inheritance
+    Page.send :include, TaggableTags                                    # and the basic radius tags for showing page tags and tag pages
+    Admin::PagesController.send :include, TaggableAdminPageController   # tweak the admin interface to make page tags more prominent
+    UserActionObserver.instance.send :add_observer!, Tag                # tags get creator-stamped
+
+    unless defined? admin.tag
+      Radiant::AdminUI.send :include, TaggableAdminUI
+      admin.tag = Radiant::AdminUI.load_default_tag_regions
+    end
+
+    if respond_to?(:tab)
+      tab("Content") do
+        add_item("Tags", "/admin/tags")
+      end
+    else
+      admin.tabs.add "Tags", "/admin/tags", :after => "Layouts", :visibility => [:all]
+      if admin.tabs['Tags'].respond_to?(:add_link)
+        admin.tabs['Tags'].add_link('tag list', '/admin/tags')
+        admin.tabs['Tags'].add_link('tag cloud', '/admin/tags/cloud')
+        admin.tabs['Tags'].add_link('new tag', '/admin/tags/new')
+      end
+    end
+  end
+  
+  def deactivate
+    admin.tabs.remove "Tags" unless respond_to?(:tab)
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: radiant-taggable-extension
+version: !ruby/object:Gem::Version 
+  hash: 31
+  prerelease: false
+  segments: 
+  - 1
+  - 2
+  - 0
+  version: 1.2.0
+platform: ruby
+authors: 
+- spanner
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-10 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: radiant
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 59
+        segments: 
+        - 0
+        - 9
+        - 0
+        version: 0.9.0
+  type: :runtime
+  version_requirements: *id001
+description: "General purpose tagging extension: more versatile but less focused than the tags extension"
+email: will@spanner.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- README.md
+- Rakefile
+- VERSION
+- app/controllers/admin/taggings_controller.rb
+- app/controllers/admin/tags_controller.rb
+- app/models/tag.rb
+- app/models/tagging.rb
+- app/views/admin/pages/_edit_title.html.haml
+- app/views/admin/tags/_form.html.haml
+- app/views/admin/tags/_search_results.html.haml
+- app/views/admin/tags/cloud.html.haml
+- app/views/admin/tags/edit.html.haml
+- app/views/admin/tags/index.html.haml
+- app/views/admin/tags/new.html.haml
+- app/views/admin/tags/show.html.haml
+- config/routes.rb
+- db/migrate/001_create_tags.rb
+- db/migrate/002_import_keywords.rb
+- lib/taggable_admin_page_controller.rb
+- lib/taggable_admin_ui.rb
+- lib/taggable_model.rb
+- lib/taggable_page.rb
+- lib/taggable_tags.rb
+- lib/tasks/taggable_extension_tasks.rake
+- pkg/radiant-taggable-extension-1.2.0.gem
+- public/images/admin/new-tag.png
+- public/images/admin/tag.png
+- public/images/furniture/detag.png
+- public/stylesheets/admin/tags.css
+- public/stylesheets/sass/tagcloud.sass
+- radiant-taggable-extension.gemspec
+- spec/datasets/tag_sites_dataset.rb
+- spec/datasets/tags_dataset.rb
+- spec/lib/taggable_page_spec.rb
+- spec/models/tag_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- taggable_extension.rb
+has_rdoc: true
+homepage: http://github.com/spanner/radiant-taggable-extension
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Taggable Extension for Radiant CMS
+test_files: 
+- spec/datasets/tag_sites_dataset.rb
+- spec/datasets/tags_dataset.rb
+- spec/lib/taggable_page_spec.rb
+- spec/models/tag_spec.rb
+- spec/spec_helper.rb