module ActsAsTaggableOn::Taggable::Core::ClassMethods

Public Instance Methods

grouped_column_names_for(object) click to toggle source

all column names are necessary for PostgreSQL group clause

# File lib/acts_as_taggable_on/taggable/core.rb, line 85
def grouped_column_names_for(object)
  object.column_names.map { |column| "#{object.table_name}.#{column}" }.join(', ')
end
initialize_acts_as_taggable_on_core() click to toggle source
# File lib/acts_as_taggable_on/taggable/core.rb, line 19
      def initialize_acts_as_taggable_on_core
        include taggable_mixin
        tag_types.map(&:to_s).each do |tags_type|
          tag_type = tags_type.to_s.singularize
          context_taggings = "#{tag_type}_taggings".to_sym
          context_tags = tags_type.to_sym
          taggings_order = (preserve_tag_order? ? "#{ActsAsTaggableOn::Tagging.table_name}.id" : [])

          class_eval do
            # when preserving tag order, include order option so that for a 'tags' context
            # the associations tag_taggings & tags are always returned in created order
            has_many context_taggings, -> { includes(:tag).order(taggings_order).where(context: tags_type) },
                     as: :taggable,
                     class_name: 'ActsAsTaggableOn::Tagging',
                     dependent: :destroy,
                     after_add: :dirtify_tag_list,
                     after_remove: :dirtify_tag_list

            has_many context_tags, -> { order(taggings_order) },
                     class_name: 'ActsAsTaggableOn::Tag',
                     through: context_taggings,
                     source: :tag

            attribute "#{tags_type.singularize}_list".to_sym, ActsAsTaggableOn::Taggable::TagListType.new
          end

          taggable_mixin.class_eval <<-RUBY, __FILE__, __LINE__ + 1
            def #{tag_type}_list
              tag_list_on('#{tags_type}')
            end

            def #{tag_type}_list=(new_tags)
              parsed_new_list = ActsAsTaggableOn.default_parser.new(new_tags).parse

              if self.class.preserve_tag_order? || (parsed_new_list.sort != #{tag_type}_list.sort)
                if ActsAsTaggableOn::Utils.legacy_activerecord?
                  set_attribute_was("#{tag_type}_list", #{tag_type}_list)
                else
                  unless #{tag_type}_list_changed?
                    @attributes["#{tag_type}_list"] = ActiveModel::Attribute.from_user("#{tag_type}_list", #{tag_type}_list, ActsAsTaggableOn::Taggable::TagListType.new)
                  end
                end
                write_attribute("#{tag_type}_list", parsed_new_list)
              end

              set_tag_list_on('#{tags_type}', new_tags)
            end

            def all_#{tags_type}_list
              all_tags_list_on('#{tags_type}')
            end

            private
            def dirtify_tag_list(tagging)
              attribute_will_change! tagging.context.singularize+"_list"
            end
          RUBY
        end
      end
is_taggable?() click to toggle source
# File lib/acts_as_taggable_on/taggable/core.rb, line 119
def is_taggable?
  true
end
taggable_mixin() click to toggle source
# File lib/acts_as_taggable_on/taggable/core.rb, line 123
def taggable_mixin
  @taggable_mixin ||= Module.new
end
taggable_on(preserve_tag_order, *tag_types) click to toggle source
Calls superclass method
# File lib/acts_as_taggable_on/taggable/core.rb, line 79
def taggable_on(preserve_tag_order, *tag_types)
  super(preserve_tag_order, *tag_types)
  initialize_acts_as_taggable_on_core
end
tagged_with(tags, options = {}) click to toggle source

Return a scope of objects that are tagged with the specified tags.

@param tags The tags that we want to query for @param [Hash] options A hash of options to alter you query:

* <tt>:exclude</tt> - if set to true, return objects that are *NOT* tagged with the specified tags
* <tt>:any</tt> - if set to true, return objects that are tagged with *ANY* of the specified tags
* <tt>:order_by_matching_tag_count</tt> - if set to true and used with :any, sort by objects matching the most tags, descending
* <tt>:match_all</tt> - if set to true, return objects that are *ONLY* tagged with the specified tags
* <tt>:owned_by</tt> - return objects that are *ONLY* owned by the owner
* <tt>:start_at</tt> - Restrict the tags to those created after a certain time
* <tt>:end_at</tt> - Restrict the tags to those created before a certain time

Example:

User.tagged_with(["awesome", "cool"])                     # Users that are tagged with awesome and cool
User.tagged_with(["awesome", "cool"], :exclude => true)   # Users that are not tagged with awesome or cool
User.tagged_with(["awesome", "cool"], :any => true)       # Users that are tagged with awesome or cool
User.tagged_with(["awesome", "cool"], :any => true, :order_by_matching_tag_count => true)  # Sort by users who match the most tags, descending
User.tagged_with(["awesome", "cool"], :match_all => true) # Users that are tagged with just awesome and cool
User.tagged_with(["awesome", "cool"], :owned_by => foo ) # Users that are tagged with just awesome and cool by 'foo'
User.tagged_with(["awesome", "cool"], :owned_by => foo, :start_at => Date.today ) # Users that are tagged with just awesome, cool by 'foo' and starting today
# File lib/acts_as_taggable_on/taggable/core.rb, line 110
def tagged_with(tags, options = {})
  tag_list = ActsAsTaggableOn.default_parser.new(tags).parse
  options = options.dup

  return none if tag_list.empty?

  ::ActsAsTaggableOn::Taggable::TaggedWithQuery.build(self, ActsAsTaggableOn::Tag, ActsAsTaggableOn::Tagging, tag_list, options)
end