additionals/lib/additionals.rb

# frozen_string_literal: true

require 'redmine_plugin_kit'

module Additionals
  MAX_CUSTOM_MENU_ITEMS = 5
  DEFAULT_MODAL_WIDTH = '350px'
  GOTO_LIST = " \xc2\xbb"
  LIST_SEPARATOR = "#{GOTO_LIST} ".freeze
  EMOJI_ASSERT_PATH = 'plugin_assets/additionals/images/emojis'

  include RedminePluginKit::PluginBase

  class << self
    def full_url(path = nil)
      "#{Setting.protocol}://#{Setting.host_name.chomp '/'}#{path}"
    end

    def class_prefix(klass)
      klass_name = klass.is_a?(String) ? klass : klass.name
      klass_name.underscore.tr '/', '_'
    end

    def now_with_user_time_zone(user = User.current)
      if user.time_zone.nil?
        Time.current
      else
        user.time_zone.now
      end
    end

    def time_zone_correct(time, user: User.current)
      timezone = user.time_zone || Time.zone
      timezone.utc_offset - Time.zone.local_to_utc(time).localtime.utc_offset
    end

    def hash_remove_with_default(field, options, default = nil)
      value = nil
      if options.key? field
        value = options[field]
        options.delete field
      elsif !default.nil?
        value = default
      end
      [value, options]
    end

    def per_page_first_limit
      Setting.per_page_options_array.first || 25
    end

    def split_ids(phrase, limit: nil)
      limit ||= per_page_first_limit
      raw_ids = phrase.strip_split
      ids = []
      raw_ids.each do |id|
        if id.include? '-'
          range = id.split('-').map(&:strip)
          if range.size == 2
            left_id = range.first.to_i
            right_id = range.last.to_i
            min = [left_id, right_id].min
            max = [left_id, right_id].max
            # if range to large, take lowest numbers + last possible number
            ids << if max - min > limit
                     old_max = max
                     max = limit + min - 2
                     ids << (min..max).to_a
                     old_max
                   else
                     (min..max).to_a
                   end
          end
        else
          ids << id.to_i
        end
      end
      ids.flatten!
      ids.uniq!
      ids.take limit
    end

    def max_live_search_results
      if setting(:max_live_search_results).present?
        setting(:max_live_search_results).to_i
      else
        50
      end
    end

    def debug(message = 'running', console: false)
      if console
        RedminePluginKit::Debug.msg message
      else
        RedminePluginKit::Debug.log message
      end
    end

    private

    def setup
      RenderAsync.configuration.jquery = true

      loader.add_patch %w[ApplicationController
                          AutoCompletesController
                          Issue
                          IssuePriority
                          TimeEntry
                          Mailer
                          Project
                          ProjectQuery
                          Wiki
                          WikiPage
                          ProjectsController
                          WelcomeController
                          ReportsController
                          SettingsController
                          Principal
                          Query
                          QueryFilter
                          Role
                          User
                          UserPreference]

      loader.add_helper %w[Issues
                           Wiki
                           CustomFields]

      loader.add_helper({ controller: 'Issues', helper: 'AdditionalsCommonJournals' })

      loader.add_patch [{ target: Redmine::Views::LabelledFormBuilder, patch: 'LabelledFormBuilder' }]

      loader.add_global_helper [Additionals::Helpers,
                                AdditionalsFontawesomeHelper,
                                AdditionalsMenuHelper,
                                AdditionalsSelect2Helper]

      Redmine::WikiFormatting.format_names.each do |format|
        case format
        when 'markdown'
          loader.add_patch [{ target: Redmine::WikiFormatting::Markdown::HTML, patch: 'FormatterMarkdown' },
                            { target: Redmine::WikiFormatting::Markdown::Helper, patch: 'FormattingHelper' }]
        when 'common_mark'
          loader.add_patch [{ target: Redmine::WikiFormatting::CommonMark::Formatter, patch: 'FormatterCommonMark' }]
          loader.add_patch [{ target: Redmine::WikiFormatting::CommonMark::Helper, patch: 'FormattingHelper' }]
        when 'textile'
          loader.add_patch [{ target: Redmine::WikiFormatting::Textile::Formatter, patch: 'FormatterTextile' },
                            { target: Redmine::WikiFormatting::Textile::Helper, patch: 'FormattingHelper' }]
        end
      end

      # Clients
      loader.require_files File.join('wiki_formatting', 'common_mark', '**/*_filter.rb')

      # Apply patches and helper
      loader.apply!

      # Macros
      loader.load_macros!

      # Load view hooks
      loader.load_view_hooks!
    end
  end

  # Run the classic redmine plugin initializer after rails boot
  class Plugin < ::Rails::Engine
    require 'tanuki_emoji'
    require 'render_async'
    require 'rss'
    require 'slim'

    config.after_initialize do
      # engine_name could be used (additionals_plugin), but can
      # create some side effencts
      plugin_id = 'additionals'

      # TODO: enable again, if fallback for emoji support
      #       has been implemented for mail delivery and pdf
      # Additionals::Gemify.install_emoji_assets

      # if plugin is already in plugins directory, use this and leave here
      next if Redmine::Plugin.installed? plugin_id

      # gem is used as redmine plugin
      require File.expand_path '../init', __dir__
      Additionals::Gemify.install_assets plugin_id
      Additionals::Gemify.create_plugin_hint plugin_id
    end
  end
end

class String
  def strip_split(sep = ',')
    split(sep).map(&:strip).compact_blank
  end
end

class Array
  # alias for join with ', ' as seperator
  def to_comma_list
    join ', '
  end
end