Class: ActsAsTaggableOn::Tag

Inherits:
ActiveRecord::Base
  • Object
show all
Includes:
Utils
Defined in:
lib/acts_as_taggable_on/tag.rb

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Utils

included

Class Method Details

.find_or_create_all_with_like_by_name(*list) ⇒ Object 



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

def self.find_or_create_all_with_like_by_name(*list)
  list = [list].flatten

  return [] if list.empty?

  existing_tags = Tag.named_any(list)

  list.map do |tag_name|
    comparable_tag_name = comparable_name(tag_name)
    existing_tag = existing_tags.find { |tag| comparable_name(tag.name) == comparable_tag_name }

    existing_tag || Tag.create(:name => tag_name)
  end
end

.find_or_create_with_like_by_name(name) ⇒ Object

CLASS METHODS:



50
51
52
53
54
55
56
 
# File 'lib/acts_as_taggable_on/tag.rb', line 50

def self.find_or_create_with_like_by_name(name)
  if (ActsAsTaggableOn.strict_case_match)
    self.find_or_create_all_with_like_by_name([name]).first
  else
    named_like(name).first || create(:name => name)
  end
end

.named(name) ⇒ Object

SCOPES:



24
25
26
27
28
29
30
 
# File 'lib/acts_as_taggable_on/tag.rb', line 24

def self.named(name)
  if ActsAsTaggableOn.strict_case_match
    where(["name = #{binary}?", name])
  else
    where(["lower(name) = ?", name.downcase])
  end
end

.named_any(list) ⇒ Object 



32
33
34
35
36
37
38
 
# File 'lib/acts_as_taggable_on/tag.rb', line 32

def self.named_any(list)
  if ActsAsTaggableOn.strict_case_match
    where(list.map { |tag| sanitize_sql(["name = #{binary}?", tag.to_s.mb_chars]) }.join(" OR "))
  else
    where(list.map { |tag| sanitize_sql(["lower(name) = ?", tag.to_s.mb_chars.downcase]) }.join(" OR "))
  end
end

.named_like(name) ⇒ Object 



40
41
42
 
# File 'lib/acts_as_taggable_on/tag.rb', line 40

def self.named_like(name)
  where(["name #{like_operator} ? ESCAPE '!'", "%#{escape_like(name)}%"])
end

.named_like_any(list) ⇒ Object 



44
45
46
 
# File 'lib/acts_as_taggable_on/tag.rb', line 44

def self.named_like_any(list)
  where(list.map { |tag| sanitize_sql(["name #{like_operator} ? ESCAPE '!'", "%#{escape_like(tag.to_s)}%"]) }.join(" OR "))
end

Instance Method Details

#==(object) ⇒ Object

INSTANCE METHODS:



75
76
77
 
# File 'lib/acts_as_taggable_on/tag.rb', line 75

def ==(object)
  super || (object.is_a?(Tag) && name == object.name)
end

#count ⇒ Object 



83
84
85
 
# File 'lib/acts_as_taggable_on/tag.rb', line 83

def count
  read_attribute(:count).to_i
end

#to_s ⇒ Object 



79
80
81
 
# File 'lib/acts_as_taggable_on/tag.rb', line 79

def to_s
  name
end

#validates_name_uniqueness? ⇒ Boolean

monkey patch this method if don’t need name uniqueness validation

Returns:

  • (Boolean) 


18
19
20
 
# File 'lib/acts_as_taggable_on/tag.rb', line 18

def validates_name_uniqueness?
  true
end