openproject/app/helpers/settings_helper.rb

#-- encoding: UTF-8
#-- copyright
# OpenProject is a project management system.
# Copyright (C) 2012-2015 the OpenProject Foundation (OPF)
#
# 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-2013 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 doc/COPYRIGHT.rdoc for more details.
#++

module SettingsHelper
  def administration_settings_tabs
    [{ name: 'general', partial: 'settings/general', label: :label_general },
     { name: 'display', partial: 'settings/display', label: :label_display },
     { name: 'authentication', partial: 'settings/authentication', label: :label_authentication },
     { name: 'users', partial: 'settings/users', label: :label_user_plural },
     { name: 'projects', partial: 'settings/projects', label: :label_project_plural },
     { name: 'work_packages', partial: 'settings/work_packages', label: :label_work_package_tracking },
     { name: 'notifications', partial: 'settings/notifications', label: Proc.new { User.human_attribute_name(:mail_notification) } },
     { name: 'mail_handler', partial: 'settings/mail_handler', label: :label_incoming_emails },
     { name: 'repositories', partial: 'settings/repositories', label: :label_repository_plural }
    ]
  end

  def setting_select(setting, choices, options = {})
    if blank_text = options.delete(:blank)
      choices = [[blank_text.is_a?(Symbol) ? I18n.t(blank_text) : blank_text, '']] + choices
    end

    options[:class]  = ''
    options[:class] << 'form--select'

    ret = content_tag(:span, class: 'form--field-container') do
      select_tag("settings[#{setting}]", options_for_select(choices, Setting.send(setting).to_s), options)
    end
    ret = setting_label(setting).safe_concat(ret) unless options[:label] == false

    ret
  end

  def setting_multiselect(setting, choices, options = {})
    setting_values = Setting.send(setting)
    setting_values = [] unless setting_values.is_a?(Array)

    setting_label(setting, options) +
      content_tag(:span, class: 'form--field-container') do
        hidden_field_tag("settings[#{setting}][]", '') +
          choices.map do |choice|
            text, value = (choice.is_a?(Array) ? choice : [choice, choice])

            content_tag('label',
                        check_box_tag("settings[#{setting}][]", value, Setting.send(setting).include?(value),
                                      class: 'form--check-box') + text.to_s,
                        class: 'block'
            )
          end.join.html_safe
      end
  end

  def settings_multiselect(settings, choices, options = {})
    ('<table>' +
      '<thead>' +
        '<tr>' +
          '<th>' + I18n.t(options[:label_choices] || :label_choices) + '</th>' +
          settings.map do |setting|
            '<th>' + hidden_field_tag("settings[#{setting}][]", '') + I18n.t('setting_' + setting.to_s) + '</th>'
          end.join +
        '</tr>' +
      '</thead>' +
      '<tbody>' +
        choices.map do |choice|
          text, value = (choice.is_a?(Array)) ? choice : [choice, choice]
          '<tr>' +
            '<td>' + h(text) + '</td>' +
            settings.map do |setting|
              '<td align="center">' +
                check_box_tag("settings[#{setting}][]", value, Setting.send(setting).include?(value),
                              id: "#{setting}_#{value}", class: 'form--check-box') + '</td>'
            end.join +
          '</tr>'
        end.join +
      '</tbody>' +
    '</table>').html_safe
  end

  def setting_text_field(setting, options = {})
    setting_label(setting, options) +
      content_tag(:span, class: 'form--field-container') do
        text_field_tag("settings[#{setting}]", Setting.send(setting), options)
      end
  end

  def setting_text_area(setting, options = {})
    setting_label(setting, options) +
      content_tag(:span, class: 'form--field-container') do
        text_area_tag("settings[#{setting}]", Setting.send(setting), options)
      end
  end

  def setting_check_box(setting, options = {})
    setting_label(setting, options) +
      content_tag(:span, class: 'form--field-container') do
        tag(:input, type: 'hidden', name: "settings[#{setting}]", value: 0, id: "settings_#{setting}_hidden") +
          check_box_tag("settings[#{setting}]", 1, Setting.send("#{setting}?"), options)
      end
  end

  def setting_label(setting, options = {})
    label = options.delete(:label)
    label != false ? content_tag('label', I18n.t(label || "setting_#{setting}"),
                                 for: "settings_#{setting}",
                                 class: 'form--label') : ''.html_safe
  end

  # Renders a notification field for a Redmine::Notifiable option
  def notification_field(notifiable)
    content_tag(:label,
                check_box_tag('settings[notified_events][]',
                              notifiable.name,
                              Setting.notified_events.include?(notifiable.name),
                              class: 'form--check-box') +
                  l_or_humanize(notifiable.name, prefix: 'label_'),
                class: 'form--label' + (notifiable.parent.present? ? ' parent' : ''))
  end
end