tinted_tags 0.0.2

data/.gitignore

@@ -0,0 +1,8 @@
+.bundle/
+log/*.log
+*.gem
+pkg/
+.DS_Store
+tmp
+spec/dummy/db/*.sqlite3
+spec/dummy/log/*.log

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,19 @@
+source "http://rubygems.org"
+
+# Declare your gem's dependencies in tinted_tags.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# jquery-rails is used by the dummy application
+gem "jquery-rails"
+gem 'ammeter'
+gem 'acts-as-taggable-on', '~> 2.3.1'
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+# To use debugger
+# gem 'debugger'

data/Gemfile.lock

@@ -0,0 +1,133 @@
+PATH
+  remote: .
+  specs:
+    tinted_tags (0.0.1)
+      acts-as-taggable-on (~> 2.3.1)
+      compass
+      rails (>= 3.2.11)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.11)
+      actionpack (= 3.2.11)
+      mail (~> 2.4.4)
+    actionpack (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.11)
+      activesupport (= 3.2.11)
+      builder (~> 3.0.0)
+    activerecord (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
+    activesupport (3.2.11)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    acts-as-taggable-on (2.3.3)
+      rails (~> 3.0)
+    ammeter (0.2.8)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec (>= 2.2)
+      rspec-rails (>= 2.2)
+    arel (3.0.2)
+    builder (3.0.4)
+    chunky_png (1.2.5)
+    compass (0.12.2)
+      chunky_png (~> 1.2)
+      fssm (>= 0.2.7)
+      sass (~> 3.1)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    fssm (0.2.8.1)
+    hike (1.2.1)
+    i18n (0.6.1)
+    journey (1.0.4)
+    jquery-rails (2.2.0)
+      railties (>= 3.0, < 5.0)
+      thor (>= 0.14, < 2.0)
+    json (1.7.6)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    multi_json (1.5.0)
+    polyglot (0.3.3)
+    rack (1.4.4)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.11)
+      actionmailer (= 3.2.11)
+      actionpack (= 3.2.11)
+      activerecord (= 3.2.11)
+      activeresource (= 3.2.11)
+      activesupport (= 3.2.11)
+      bundler (~> 1.0)
+      railties (= 3.2.11)
+    railties (3.2.11)
+      actionpack (= 3.2.11)
+      activesupport (= 3.2.11)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.0.3)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+    rspec-rails (2.12.2)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    sass (3.2.5)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.7)
+    thor (0.17.0)
+    tilt (1.3.3)
+    treetop (1.4.12)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.35)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  acts-as-taggable-on (~> 2.3.1)
+  ammeter
+  jquery-rails
+  rspec-rails (~> 2.0)
+  sqlite3
+  tinted_tags!

data/MIT-LICENSE.md

@@ -0,0 +1,20 @@
+Copyright 2013 Ben Woodward
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,67 @@
+# TintedTags
+
+This plugin is to be used with
+[acts_as_taggable_on](https://github.com/mbleigh/acts-as-taggable-on).
+TintedTags allows you to create a tag cloud where tag popularity is
+illustrated with colour.
+It achieves this by adding a :tint attribute to the Tag model, and allows you to calculate
+a colour (in the form of a hex code) for each tag based on its
+popularity. These hex codes are added to the tags in the view via
+inline-css.
+
+Tags are updated via an ```after_save``` filter on a TintedTags object.
+
+## Installation
+
+### Rails 3.x
+
+To use it, add it to your Gemfile:
+
+```ruby
+gem 'acts-as-taggable-on', '~> 2.3.1'
+gem 'tinted_tags'
+```
+
+#### Post Installation
+
+```shell
+rails generate tinted_tags:migration
+rake db:migrate
+```
+
+## Usage
+
+### Model
+
+```ruby
+acts_as_taggable_on
+tinted_tags base: '#ffffff', tint: '#000000'
+```
+
+### Controller
+
+```ruby
+@tags = Post.tag_counts_on(:tags).order('count desc')
+```
+
+### Views
+
+```ruby
+tinted_tag_cloud
+```
+returns ..
+
+```html
+<ul class="tinted-tag-cloud">
+  <li style="background-color: #ffffff">one</li>
+  <li style="background-color: #7f7f7f">two</li>
+</ul>
+```
+
+## Author
+
+* [Ben Woodward](https://github.com/benwoodward)
+
+Copyright (c) Ben Woodward (http://benw.me/)
+Copyright Released under the [MIT
+license](https://github.com/benwoodward/tinted_tags/blob/master/MIT-LICENSE.md)

data/Rakefile

@@ -0,0 +1,24 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+Bundler.setup :default, :development
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+require 'rspec/core/rake_task'
+
+desc "Run all specs in spec directory (excluding plugin specs)"
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task default: :spec
+
+Bundler::GemHelper.install_tasks

data/app/assets/javascripts/tinted_tags/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require jquery
+//= require jquery_ujs
+//= require_tree .

data/app/assets/stylesheets/tinted_tags/application.css

@@ -0,0 +1,13 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the top of the
+ * compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_self
+ *= require_tree .
+ */

data/app/controllers/tinted_tags/application_controller.rb

@@ -0,0 +1,4 @@
+module TintedTags
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/helpers/tinted_tags/application_helper.rb

@@ -0,0 +1,4 @@
+module TintedTags
+  module ApplicationHelper
+  end
+end

data/app/views/layouts/tinted_tags/application.html.erb

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TintedTags</title>
+  <%= stylesheet_link_tag    "tinted_tags/application", :media => "all" %>
+  <%= javascript_include_tag "tinted_tags/application" %>
+  <%= csrf_meta_tags %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,2 @@
+TintedTags::Engine.routes.draw do
+end

data/lib/generators/tinted_tags/migration/migration_generator.rb

@@ -0,0 +1,38 @@
+require 'rails/generators'
+require 'rails/generators/migration'
+
+module TintedTags
+  class MigrationGenerator < Rails::Generators::Base
+    include Rails::Generators::Migration
+
+    desc "Generates migration for Tag tints"
+
+    def self.orm
+      Rails::Generators.options[:rails][:orm]
+    end
+
+    def self.source_root
+      File.join(File.dirname(__FILE__), 'templates', (orm.to_s unless orm.class.eql?(String)) )
+    end
+
+    def self.orm_has_migration?
+      [:active_record].include? orm
+    end
+
+    def self.next_migration_number(dirname)
+      if ActiveRecord::Base.timestamped_migrations
+        migration_number = Time.now.utc.strftime("%Y%m%d%H%M%S").to_i
+        migration_number += 1
+        migration_number.to_s
+      else
+        "%.3d" % (current_migration_number(dirname) + 1)
+      end
+    end
+
+    def create_migration_file
+      if self.class.orm_has_migration?
+        migration_template 'migration.rb', 'db/migrate/tinted_tags_migration'
+      end
+    end
+  end
+end

data/lib/generators/tinted_tags/migration/templates/active_record/migration.rb

@@ -0,0 +1,5 @@
+class TintedTagsMigration < ActiveRecord::Migration
+  def change
+    add_column :tags, :tint, :string
+  end
+end

data/lib/tinted_tags.rb

@@ -0,0 +1,28 @@
+require "tinted_tags/engine"
+require "tinted_tags/tag_tinter"
+require "view_helpers/view_helpers"
+
+module TintedTags
+
+  def tinted_tags(opts={})
+    class_attribute :opts
+    self.opts = opts
+
+    class_eval do
+
+      attr_accessible :tag_list
+      after_save :update_tints, if: :tag_list_changed?
+
+      private
+
+      def update_tints
+        TagTinter.new(self.class, opts).update_tints
+      end
+    end
+  end
+
+  if defined?(ActiveRecord::Base)
+    ActiveRecord::Base.extend TintedTags
+  end
+end
+

data/lib/tinted_tags/engine.rb

@@ -0,0 +1,8 @@
+module TintedTags
+  class Engine < ::Rails::Engine
+    isolate_namespace TintedTags
+    initializer 'tinted tags' do
+      ActionView::Base.send :include, TintedTags::ViewHelpers
+    end
+  end
+end

data/lib/tinted_tags/tag_tinter.rb

@@ -0,0 +1,42 @@
+require 'compass'
+
+module TintedTags
+  class TagTinter
+    def initialize(klass, opts={})
+      @base = opts[:base]
+      @tint = opts[:tint]
+      @strategy = opts[:strategy]
+      @klass = klass
+    end
+
+    def update_tints
+      @klass.tag_counts_on(:tags).each do |tag|
+        percent = percentage(tag.count)
+        tag.tint = evaluate("mix(#{@base}, #{@tint}, #{percent})")
+        tag.save
+      end
+    end
+
+    private
+
+    def percentage(count)
+      return percentage_of_total(count) unless @strategy == :rated_as_range
+      percentage_within_range(count)
+    end
+
+    def percentage_of_total(count)
+      total = @klass.tag_counts_on(:tags).map(&:count).inject(:+)
+      ((count * 100) / total).round(2)
+    end
+
+    def percentage_within_range(count)
+      max = @klass.tag_counts_on(:tags).order('count desc').first.count
+      min = @klass.tag_counts_on(:tags).order('count desc').last.count
+      ((100 * (count-min)) / (max-min)).round(2)
+    end
+
+    def evaluate(value)
+      Sass::Script::Parser.parse(value, 0, 0).perform(Sass::Environment.new).to_s
+    end
+  end
+end