SoundSoftware Code Site

# Redmine - project management software

# Copyright (C) 2006-2012  Jean-Philippe Lang

#

# This program is free software; you can redistribute it and/or

# modify it under the terms of the GNU General Public License

# as published by the Free Software Foundation; either version 2

# of the License, or (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

module Redmine

  module Acts

    module ActivityProvider

      def self.included(base)

        base.extend ClassMethods

      end

      module ClassMethods

        def acts_as_activity_provider(options = {})

          unless self.included_modules.include?(Redmine::Acts::ActivityProvider::InstanceMethods)

            cattr_accessor :activity_provider_options

            send :include, Redmine::Acts::ActivityProvider::InstanceMethods

          end

          options.assert_valid_keys(:type, :permission, :timestamp, :author_key, :find_options)

          self.activity_provider_options ||= {}

          # One model can provide different event types

          # We store these options in activity_provider_options hash

          event_type = options.delete(:type) || self.name.underscore.pluralize

          options[:timestamp] ||= "#{table_name}.created_on"

          options[:find_options] ||= {}

          options[:author_key] = "#{table_name}.#{options[:author_key]}" if options[:author_key].is_a?(Symbol)

          self.activity_provider_options[event_type] = options

        end

      end

      module InstanceMethods

        def self.included(base)

          base.extend ClassMethods

        end

        module ClassMethods

          # Returns events of type event_type visible by user that occured between from and to

          def find_events(event_type, user, from, to, options)

            provider_options = activity_provider_options[event_type]

            raise "#{self.name} can not provide #{event_type} events." if provider_options.nil?

            scope = self

            if from && to

              scope = scope.scoped(:conditions => ["#{provider_options[:timestamp]} BETWEEN ? AND ?", from, to])

            end

            if options[:author]

              return [] if provider_options[:author_key].nil?

              scope = scope.scoped(:conditions => ["#{provider_options[:author_key]} = ?", options[:author].id])

            end

            if options[:limit]

              # id and creation time should be in same order in most cases

              scope = scope.scoped(:order => "#{table_name}.id DESC", :limit => options[:limit])

            end

            if provider_options.has_key?(:permission)

              scope = scope.scoped(:conditions => Project.allowed_to_condition(user, provider_options[:permission] || :view_project, options))

            elsif respond_to?(:visible)

              scope = scope.visible(user, options)

            else

              ActiveSupport::Deprecation.warn "acts_as_activity_provider with implicit :permission option is deprecated. Add a visible scope to the #{self.name} model or use explicit :permission option."

              scope = scope.scoped(:conditions => Project.allowed_to_condition(user, "view_#{self.name.underscore.pluralize}".to_sym, options))

            end

            scope.all(provider_options[:find_options].dup)

          end

        end

      end

    end

  end

end