#-- 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. #++ module Redmine module Hook @@listener_classes = [] @@listeners = nil @@hook_listeners = {} class << self # Adds a listener class. # Automatically called when a class inherits from Redmine::Hook::Listener. def add_listener(klass) raise 'Hooks must include Singleton module.' unless klass.included_modules.include?(Singleton) @@listener_classes << klass clear_listeners_instances end # Returns all the listener instances. def listeners @@listeners ||= @@listener_classes.map(&:instance) end # Returns the listener instances for the given hook. def hook_listeners(hook) @@hook_listeners[hook] ||= listeners.select { |listener| listener.respond_to?(hook) } end # Clears all the listeners. def clear_listeners @@listener_classes = [] clear_listeners_instances end # Clears all the listeners instances. def clear_listeners_instances @@listeners = nil @@hook_listeners = {} end # Calls a hook. # Returns the listeners response. def call_hook(hook, context = {}) [].tap do |response| hook_listeners(hook).each do |listener| response << listener.send(hook, context) rescue StandardError => e msg = "Failed to collect hook response for #{hook} from #{listener.inspect}" ::OpenProject.logger.error(msg, exception: e, extra: { hook_name: hook }) end end end end # Base class for hook listeners. class Listener include Singleton include Redmine::I18n # Registers the listener def self.inherited(child) Redmine::Hook.add_listener(child) super end end # Listener class used for views hooks. # Listeners that inherit this class will include various helpers by default. class ViewListener < Listener include ERB::Util include ActionView::Helpers::TagHelper include ActionView::Helpers::FormHelper include ActionView::Helpers::FormTagHelper include ActionView::Helpers::FormOptionsHelper include ActionView::Helpers::JavaScriptHelper include ActionView::Helpers::NumberHelper include ActionView::Helpers::UrlHelper include Sprockets::Rails::Helper include ActionView::Helpers::TextHelper include Rails.application.routes.url_helpers include ApplicationHelper # Default to creating links using only the path. Subclasses can # change this default as needed def self.default_url_options { host: OpenProject::StaticRouting::UrlHelpers.host, only_path: true, script_name: OpenProject::Configuration.rails_relative_url_root } end # Helper method to directly render a partial using the context: # # class MyHook < Redmine::Hook::ViewListener # render_on :view_issues_show_details_bottom, partial: "show_more_data" # end # def self.render_on(hook, options = {}) define_method hook do |context| if context[:hook_caller].respond_to?(:render) context[:hook_caller].send(:render, { locals: context }.merge(options)) elsif context[:controller].is_a?(ActionController::Base) context[:controller].send(:render_to_string, { locals: context }.merge(options)) else raise "Cannot render #{name} hook from #{context[:hook_caller].class.name}" end end end def controller nil end def config ActionController::Base.config end end end end