Adds #activity_provider shortcut method to the plugin API.

git-svn-id: http://redmine.rubyforge.org/svn/trunk@1702 e93f8b46-1217-0410-a6f0-8f06a7374b81

Adds #activity_provider shortcut method to the plugin API.
git-svn-id: http://redmine.rubyforge.org/svn/trunk@1702 e93f8b46-1217-0410-a6f0-8f06a7374b81
d05bcda2 · Jean-Philippe Lang · a774c5c4 · d05bcda2 · d05bcda2
Commit d05bcda2 authored Jul 27, 2008 by Jean-Philippe Lang
Hide whitespace changes
Inline Side-by-side

Showing with 26 additions and 8 deletions

activity.rb lib/redmine/activity.rb +0 -8

plugin.rb lib/redmine/plugin.rb +26 -0

No files found.
--- a/lib/redmine/activity.rb
+++ b/lib/redmine/activity.rb
@@ -30,14 +30,6 @@ module Redmine
      end
      
      # Registers an activity provider
-      # 
-      # Options:
-      # * :class_name - one or more model(s) that provide these events (inferred from event_type by default)
-      # * :default - setting this option to false will make the events not displayed by default
-      # 
-      # Examples:
-      #   register :issues
-      #   register :myevents, :class_name => 'Meeting'
      def register(event_type, options={})
        options.assert_valid_keys(:class_name, :default)
        

--- a/lib/redmine/plugin.rb
+++ b/lib/redmine/plugin.rb
@@ -116,6 +116,32 @@ module Redmine #:nodoc:
      self.instance_eval(&block)
      @project_module = nil
    end
+    
+    # Registers an activity provider.
+    #
+    # Options:
+    # * <tt>:class_name</tt> - one or more model(s) that provide these events (inferred from event_type by default)
+    # * <tt>:default</tt> - setting this option to false will make the events not displayed by default
+    # 
+    # A model can provide several activity event types.
+    # 
+    # Examples:
+    #   register :news
+    #   register :scrums, :class_name => 'Meeting'
+    #   register :issues, :class_name => ['Issue', 'Journal']
+    # 
+    # Retrieving events:
+    # Associated model(s) must implement the find_events class method.
+    # ActiveRecord models can use acts_as_activity_provider as a way to implement this class method.
+    # 
+    # The following call should return all the scrum events visible by current user that occured in the 5 last days: 
+    #   Meeting.find_events('scrums', User.current, 5.days.ago, Date.today)
+    #   Meeting.find_events('scrums', User.current, 5.days.ago, Date.today, :project => foo) # events for project foo only
+    # 
+    # Note that :view_scrums permission is required to view these events in the activity view.
+    def activity_provider(*args)
+      Redmine::Activity.register(*args)
+    end

    # Returns +true+ if the plugin can be configured.
    def configurable?