#-- encoding: UTF-8 #-- copyright # OpenProject is an open source project management software. # Copyright (C) 2012-2020 the OpenProject GmbH # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License version 3. # # OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows: # Copyright (C) 2006-2017 Jean-Philippe Lang # Copyright (C) 2010-2013 the ChiliProject Team # # 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. # # See docs/COPYRIGHT.rdoc for more details. #++ ############################################################################### # The base activity provider class provides a default implementation for the # # most common activity jobs. You may implement the following methods to set # # the respective activity details: # # - event_name # # - event_title # # - event_type # # - event_description # # - event_datetime # # - event_path # # - event_url # # # # See the comments on the methods to get additional information. # ############################################################################### class Activity::BaseActivityProvider include Redmine::Acts::ActivityProvider include I18n include Redmine::I18n include OpenProject::StaticRouting ############################################################################# # Activities may need information not available in the journal table. Thus, # # if you need further information from different tables (e.g., projects # # table) you may extend the query in this method. # ############################################################################# def extend_event_query(_query, _activity) end ############################################################################# # This method returns a list of columns that the activity query needs to # # return, so the activity provider can actually create an activity object. # # You must at least return the column containing the project reference with # # the alias 'project_id'. # ############################################################################# def event_query_projection(_activity) [] end ############################################################################# # Override this method if the journal table does not contain a reference to # # the 'projects' table. # ############################################################################# def projects_reference_table(activity) activity_journals_table(activity) end def filter_for_event_datetime(query, journals_table, typed_journals_table, from, to) if from query = query.where(journals_table[:created_at].gteq(from)) end if to query = query.where(journals_table[:created_at].lteq(to)) end query end def activity_journals_table(_activity) @activity_journals_table ||= JournalManager.journal_class(activitied_type).arel_table end def activitied_type(_activity = nil) activity_type = self.class.name namespace = activity_type.deconstantize class_name = activity_type.demodulize class_name.gsub('ActivityProvider', '').constantize end def format_event(event, event_data, activity) [:event_name, :event_title, :event_type, :event_description, :event_datetime, :event_path, :event_url].each do |a| event[a] = send(a, event_data, activity) if self.class.method_defined? a end event end protected def journal_table @journal_table ||= Journal.arel_table end def activitied_table @activitied_table ||= activitied_type.arel_table end def work_packages_table @work_packages_table ||= WorkPackage.arel_table end def projects_table @projects_table ||= Project.arel_table end def types_table @types_table = Type.arel_table end def statuses_table @statuses_table = Status.arel_table end def activity_journal_projection_statement(column, name, activity) projection_statement(activity_journals_table(activity), column, name) end def projection_statement(table, column, name) table[column].as(name) end class UndefinedEventTypeError < StandardError; end def event_type(_event, _activity) raise UndefinedEventTypeError.new('Abstract method event_type called') end def event_name(event, activity) I18n.t(event_type(event, activity).underscore, scope: 'events') end def url_helpers @url_helpers ||= OpenProject::StaticRouting::StaticUrlHelpers.new end end