Class: ActsAsTaggableOn::Tag

Inherits:
ActiveRecord::Base
  • Object
show all
Defined in:
app/models/acts_as_taggable_on/tag.rb

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.counts(options = {}) ⇒ Object

Calculate the tag counts for all tags.

  • :start_at - restrict the tags to those created after a certain time
  • :end_at - restrict the tags to those created before a certain time
  • :at_least - exclude tags with a frequency less than the given value
  • :at_most - exclude tags with a frequency greater than the given value

Deprecated:

  • :conditions
  • :limit
  • :order


29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'app/models/acts_as_taggable_on/tag.rb', line 29

def counts(options = {})
  options.assert_valid_keys :start_at, :end_at, :at_least, :at_most, :conditions, :limit, :order, :joins

  tags = joins(:taggings)
  tags = tags.having(["COUNT(#{ActsAsTaggableOn::Tagging.quoted_table_name}.id) >= ?", options[:at_least]]) if options[:at_least]
  tags = tags.having(["COUNT(#{ActsAsTaggableOn::Tagging.quoted_table_name}.id) <= ?", options[:at_most]])  if options[:at_most]
  tags = tags.where("#{ActsAsTaggableOn::Tagging.quoted_table_name}.created_at >= ?", options[:start_at]) if options[:start_at]
  tags = tags.where("#{ActsAsTaggableOn::Tagging.quoted_table_name}.created_at <= ?", options[:end_at])   if options[:end_at]

  # TODO: deprecation warning
  tags = tags.where(options[:conditions]) if options[:conditions]
  tags = tags.limit(options[:limit])      if options[:limit]
  tags = tags.order(options[:order])      if options[:order]

  if joins = options.delete(:joins)
    tags = tags.joins(joins)
  end

  tags.select("#{quoted_table_name}.id, #{quoted_table_name}.name, COUNT(#{quoted_table_name}.id) AS count").group("#{quoted_table_name}.id, #{quoted_table_name}.name")
end

.default_per_page ⇒ Object 



12
13
14
 
# File 'app/models/acts_as_taggable_on/tag.rb', line 12

def default_per_page
  25
end

.popular(limit = 20, type = nil) ⇒ Object 



6
7
8
9
10
 
# File 'app/models/acts_as_taggable_on/tag.rb', line 6

def popular(limit = 20, type = nil)
  tags = ActsAsTaggableOn::Tag.counts(:at_least => 0).limit(limit).order('count DESC')
  tags = tags.where("taggings.taggable_type = ?", type.capitalize) if type
  tags
end

Instance Method Details



57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'app/models/acts_as_taggable_on/tag.rb', line 57

def related_tags(limit = 10)
  taggables = self.taggings.limit(10).all.collect{|t| t.taggable }.compact

  tagging_ids = taggables.map{|t| t.taggings.limit(10).map(&:id) }.flatten.uniq
  return [] if tagging_ids.blank?

  ActsAsTaggableOn::Tag.where("tags.id != '#{self.id}'").
    select("tags.id, tags.name, COUNT(tags.id) as count").
    joins(:taggings).
    where({:taggings => {:id => tagging_ids }}).
    group("tags.id, tags.name").
    order("count DESC").
    limit(limit)
end

#to_param ⇒ Object 



53
54
55
 
# File 'app/models/acts_as_taggable_on/tag.rb', line 53

def to_param
  URI.escape(URI.escape(self.name), /[\/.?#]/)
end