Chris@1517: # Redmine - project management software
Chris@1517: # Copyright (C) 2006-2014  Jean-Philippe Lang
Chris@1517: #
Chris@1517: # This program is free software; you can redistribute it and/or
Chris@1517: # modify it under the terms of the GNU General Public License
Chris@1517: # as published by the Free Software Foundation; either version 2
Chris@1517: # of the License, or (at your option) any later version.
Chris@1517: #
Chris@1517: # This program is distributed in the hope that it will be useful,
Chris@1517: # but WITHOUT ANY WARRANTY; without even the implied warranty of
Chris@1517: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Chris@1517: # GNU General Public License for more details.
Chris@1517: #
Chris@1517: # You should have received a copy of the GNU General Public License
Chris@1517: # along with this program; if not, write to the Free Software
Chris@1517: # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
Chris@1517: 
Chris@1517: class Setting < ActiveRecord::Base
Chris@1517: 
Chris@1517:   DATE_FORMATS = [
Chris@1517:         '%Y-%m-%d',
Chris@1517:         '%d/%m/%Y',
Chris@1517:         '%d.%m.%Y',
Chris@1517:         '%d-%m-%Y',
Chris@1517:         '%m/%d/%Y',
Chris@1517:         '%d %b %Y',
Chris@1517:         '%d %B %Y',
Chris@1517:         '%b %d, %Y',
Chris@1517:         '%B %d, %Y'
Chris@1517:     ]
Chris@1517: 
Chris@1517:   TIME_FORMATS = [
Chris@1517:     '%H:%M',
Chris@1517:     '%I:%M %p'
Chris@1517:     ]
Chris@1517: 
Chris@1517:   ENCODINGS = %w(US-ASCII
Chris@1517:                   windows-1250
Chris@1517:                   windows-1251
Chris@1517:                   windows-1252
Chris@1517:                   windows-1253
Chris@1517:                   windows-1254
Chris@1517:                   windows-1255
Chris@1517:                   windows-1256
Chris@1517:                   windows-1257
Chris@1517:                   windows-1258
Chris@1517:                   windows-31j
Chris@1517:                   ISO-2022-JP
Chris@1517:                   ISO-2022-KR
Chris@1517:                   ISO-8859-1
Chris@1517:                   ISO-8859-2
Chris@1517:                   ISO-8859-3
Chris@1517:                   ISO-8859-4
Chris@1517:                   ISO-8859-5
Chris@1517:                   ISO-8859-6
Chris@1517:                   ISO-8859-7
Chris@1517:                   ISO-8859-8
Chris@1517:                   ISO-8859-9
Chris@1517:                   ISO-8859-13
Chris@1517:                   ISO-8859-15
Chris@1517:                   KOI8-R
Chris@1517:                   UTF-8
Chris@1517:                   UTF-16
Chris@1517:                   UTF-16BE
Chris@1517:                   UTF-16LE
Chris@1517:                   EUC-JP
Chris@1517:                   Shift_JIS
Chris@1517:                   CP932
Chris@1517:                   GB18030
Chris@1517:                   GBK
Chris@1517:                   ISCII91
Chris@1517:                   EUC-KR
Chris@1517:                   Big5
Chris@1517:                   Big5-HKSCS
Chris@1517:                   TIS-620)
Chris@1517: 
Chris@1517:   cattr_accessor :available_settings
Chris@1517:   @@available_settings = YAML::load(File.open("#{Rails.root}/config/settings.yml"))
Chris@1517:   Redmine::Plugin.all.each do |plugin|
Chris@1517:     next unless plugin.settings
Chris@1517:     @@available_settings["plugin_#{plugin.id}"] = {'default' => plugin.settings[:default], 'serialized' => true}
Chris@1517:   end
Chris@1517: 
Chris@1517:   validates_uniqueness_of :name
Chris@1517:   validates_inclusion_of :name, :in => @@available_settings.keys
Chris@1517:   validates_numericality_of :value, :only_integer => true, :if => Proc.new { |setting|
Chris@1517:     (s = @@available_settings[setting.name]) && s['format'] == 'int'
Chris@1517:   }
Chris@1517: 
Chris@1517:   # Hash used to cache setting values
Chris@1517:   @cached_settings = {}
Chris@1517:   @cached_cleared_on = Time.now
Chris@1517: 
Chris@1517:   def value
Chris@1517:     v = read_attribute(:value)
Chris@1517:     # Unserialize serialized settings
Chris@1517:     v = YAML::load(v) if @@available_settings[name]['serialized'] && v.is_a?(String)
Chris@1517:     v = v.to_sym if @@available_settings[name]['format'] == 'symbol' && !v.blank?
Chris@1517:     v
Chris@1517:   end
Chris@1517: 
Chris@1517:   def value=(v)
Chris@1517:     v = v.to_yaml if v && @@available_settings[name] && @@available_settings[name]['serialized']
Chris@1517:     write_attribute(:value, v.to_s)
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Returns the value of the setting named name
Chris@1517:   def self.[](name)
Chris@1517:     v = @cached_settings[name]
Chris@1517:     v ? v : (@cached_settings[name] = find_or_default(name).value)
Chris@1517:   end
Chris@1517: 
Chris@1517:   def self.[]=(name, v)
Chris@1517:     setting = find_or_default(name)
Chris@1517:     setting.value = (v ? v : "")
Chris@1517:     @cached_settings[name] = nil
Chris@1517:     setting.save
Chris@1517:     setting.value
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Defines getter and setter for each setting
Chris@1517:   # Then setting values can be read using: Setting.some_setting_name
Chris@1517:   # or set using Setting.some_setting_name = "some value"
Chris@1517:   @@available_settings.each do |name, params|
Chris@1517:     src = <<-END_SRC
Chris@1517:     def self.#{name}
Chris@1517:       self[:#{name}]
Chris@1517:     end
Chris@1517: 
Chris@1517:     def self.#{name}?
Chris@1517:       self[:#{name}].to_i > 0
Chris@1517:     end
Chris@1517: 
Chris@1517:     def self.#{name}=(value)
Chris@1517:       self[:#{name}] = value
Chris@1517:     end
Chris@1517: END_SRC
Chris@1517:     class_eval src, __FILE__, __LINE__
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Sets a setting value from params
Chris@1517:   def self.set_from_params(name, params)
Chris@1517:     params = params.dup
Chris@1517:     params.delete_if {|v| v.blank? } if params.is_a?(Array)
Chris@1517: 
Chris@1517:     m = "#{name}_from_params"
Chris@1517:     if respond_to? m
Chris@1517:       self[name.to_sym] = send m, params
Chris@1517:     else
Chris@1517:       self[name.to_sym] = params
Chris@1517:     end
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Returns a hash suitable for commit_update_keywords setting
Chris@1517:   #
Chris@1517:   # Example:
Chris@1517:   # params = {:keywords => ['fixes', 'closes'], :status_id => ["3", "5"], :done_ratio => ["", "100"]}
Chris@1517:   # Setting.commit_update_keywords_from_params(params)
Chris@1517:   # # => [{'keywords => 'fixes', 'status_id' => "3"}, {'keywords => 'closes', 'status_id' => "5", 'done_ratio' => "100"}]
Chris@1517:   def self.commit_update_keywords_from_params(params)
Chris@1517:     s = []
Chris@1517:     if params.is_a?(Hash) && params.key?(:keywords) && params.values.all? {|v| v.is_a? Array}
Chris@1517:       attributes = params.except(:keywords).keys
Chris@1517:       params[:keywords].each_with_index do |keywords, i|
Chris@1517:         next if keywords.blank?
Chris@1517:         s << attributes.inject({}) {|h, a|
Chris@1517:           value = params[a][i].to_s
Chris@1517:           h[a.to_s] = value if value.present?
Chris@1517:           h
Chris@1517:         }.merge('keywords' => keywords)
Chris@1517:       end
Chris@1517:     end
Chris@1517:     s
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Helper that returns an array based on per_page_options setting
Chris@1517:   def self.per_page_options_array
Chris@1517:     per_page_options.split(%r{[\s,]}).collect(&:to_i).select {|n| n > 0}.sort
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Helper that returns a Hash with single update keywords as keys
Chris@1517:   def self.commit_update_keywords_array
Chris@1517:     a = []
Chris@1517:     if commit_update_keywords.is_a?(Array)
Chris@1517:       commit_update_keywords.each do |rule|
Chris@1517:         next unless rule.is_a?(Hash)
Chris@1517:         rule = rule.dup
Chris@1517:         rule.delete_if {|k, v| v.blank?}
Chris@1517:         keywords = rule['keywords'].to_s.downcase.split(",").map(&:strip).reject(&:blank?)
Chris@1517:         next if keywords.empty?
Chris@1517:         a << rule.merge('keywords' => keywords)
Chris@1517:       end
Chris@1517:     end
Chris@1517:     a
Chris@1517:   end
Chris@1517: 
Chris@1517:   def self.commit_fix_keywords
Chris@1517:     ActiveSupport::Deprecation.warn "Setting.commit_fix_keywords is deprecated and will be removed in Redmine 3"
Chris@1517:     if commit_update_keywords.is_a?(Array)
Chris@1517:       commit_update_keywords.first && commit_update_keywords.first['keywords']
Chris@1517:     end
Chris@1517:   end
Chris@1517: 
Chris@1517:   def self.commit_fix_status_id
Chris@1517:     ActiveSupport::Deprecation.warn "Setting.commit_fix_status_id is deprecated and will be removed in Redmine 3"
Chris@1517:     if commit_update_keywords.is_a?(Array)
Chris@1517:       commit_update_keywords.first && commit_update_keywords.first['status_id']
Chris@1517:     end
Chris@1517:   end
Chris@1517: 
Chris@1517:   def self.commit_fix_done_ratio
Chris@1517:     ActiveSupport::Deprecation.warn "Setting.commit_fix_done_ratio is deprecated and will be removed in Redmine 3"
Chris@1517:     if commit_update_keywords.is_a?(Array)
Chris@1517:       commit_update_keywords.first && commit_update_keywords.first['done_ratio']
Chris@1517:     end
Chris@1517:   end
Chris@1517: 
Chris@1517:   def self.openid?
Chris@1517:     Object.const_defined?(:OpenID) && self[:openid].to_i > 0
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Checks if settings have changed since the values were read
Chris@1517:   # and clears the cache hash if it's the case
Chris@1517:   # Called once per request
Chris@1517:   def self.check_cache
Chris@1517:     settings_updated_on = Setting.maximum(:updated_on)
Chris@1517:     if settings_updated_on && @cached_cleared_on <= settings_updated_on
Chris@1517:       clear_cache
Chris@1517:     end
Chris@1517:   end
Chris@1517: 
Chris@1517:   # Clears the settings cache
Chris@1517:   def self.clear_cache
Chris@1517:     @cached_settings.clear
Chris@1517:     @cached_cleared_on = Time.now
Chris@1517:     logger.info "Settings cache cleared." if logger
Chris@1517:   end
Chris@1517: 
Chris@1517: private
Chris@1517:   # Returns the Setting instance for the setting named name
Chris@1517:   # (record found in database or new record with default value)
Chris@1517:   def self.find_or_default(name)
Chris@1517:     name = name.to_s
Chris@1517:     raise "There's no setting named #{name}" unless @@available_settings.has_key?(name)
Chris@1517:     setting = where(:name => name).first
Chris@1517:     unless setting
Chris@1517:       setting = new
Chris@1517:       setting.name = name
Chris@1517:       setting.value = @@available_settings[name]['default']
Chris@1517:     end
Chris@1517:     setting
Chris@1517:   end
Chris@1517: end