#-- encoding: UTF-8 #-- copyright # ChiliProject is a project management system. # # Copyright (C) 2010-2012 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. # # See doc/COPYRIGHT.rdoc for more details. #++ class Setting < ActiveRecord::Base DATE_FORMATS = [ '%Y-%m-%d', '%d/%m/%Y', '%d.%m.%Y', '%d-%m-%Y', '%m/%d/%Y', '%d %b %Y', '%d %B %Y', '%b %d, %Y', '%B %d, %Y' ] TIME_FORMATS = [ '%H:%M', '%I:%M %p' ] ENCODINGS = %w(US-ASCII windows-1250 windows-1251 windows-1252 windows-1253 windows-1254 windows-1255 windows-1256 windows-1257 windows-1258 windows-31j ISO-2022-JP ISO-2022-KR ISO-8859-1 ISO-8859-2 ISO-8859-3 ISO-8859-4 ISO-8859-5 ISO-8859-6 ISO-8859-7 ISO-8859-8 ISO-8859-9 ISO-8859-13 ISO-8859-15 KOI8-R UTF-8 UTF-16 UTF-16BE UTF-16LE EUC-JP Shift_JIS CP932 GB18030 GBK ISCII91 EUC-KR Big5 Big5-HKSCS TIS-620) cattr_accessor :available_settings @@available_settings = YAML::load(File.open("#{RAILS_ROOT}/config/settings.yml")) Redmine::Plugin.all.each do |plugin| next unless plugin.settings @@available_settings["plugin_#{plugin.id}"] = {'default' => plugin.settings[:default], 'serialized' => true} end validates_uniqueness_of :name validates_inclusion_of :name, :in => @@available_settings.keys validates_numericality_of :value, :only_integer => true, :if => Proc.new { |setting| @@available_settings[setting.name]['format'] == 'int' } def value v = read_attribute(:value) # Unserialize serialized settings v = YAML::load(v) if @@available_settings[name]['serialized'] && v.is_a?(String) v = v.to_sym if @@available_settings[name]['format'] == 'symbol' && !v.blank? v end def value=(v) v = v.to_yaml if v && @@available_settings[name] && @@available_settings[name]['serialized'] write_attribute(:value, v.to_s) end # Returns the value of the setting named name def self.[](name) if use_caching? Marshal.load(Rails.cache.fetch(self.cache_key(name)) {Marshal.dump(find_or_default(name).value)}) else find_or_default(name).value end end def self.[]=(name, v) setting = find_or_default(name) setting.value = (v ? v : "") Rails.cache.delete self.cache_key(name) setting.save setting.value end # Defines getter and setter for each setting # Then setting values can be read using: Setting.some_setting_name # or set using Setting.some_setting_name = "some value" @@available_settings.each do |name, params| src = <<-END_SRC def self.#{name} self[:#{name}] end def self.#{name}? self[:#{name}].to_i > 0 end def self.#{name}=(value) self[:#{name}] = value end END_SRC class_eval src, __FILE__, __LINE__ end # Helper that returns an array based on per_page_options setting def self.per_page_options_array per_page_options.split(%r{[\s,]}).collect(&:to_i).select {|n| n > 0}.sort end def self.openid? Object.const_defined?(:OpenID) && self[:openid].to_i > 0 end # Deprecation Warning: This method is no longer available. There is no # replacement. def self.check_cache # DEPRECATED SINCE 3.0.0beta2 ActiveSupport::Deprecation.warn "The Setting.check_cache method is " + "deprecated and will be removed in the future. There should be no " + "replacement for this functionality needed." end # Clears all of the Setting caches def self.clear_cache # DEPRECATED SINCE 3.0.0beta2 ActiveSupport::Deprecation.warn "The Setting.clear_cache method is " + "deprecated and will be removed in the future. There should be no " + "replacement for this functionality needed. To sweep the whole " + "cache Rails.cache.clear may be used. To invalidate the Settings " + "only, you may use Setting.first.try(:touch)" end # Temporarily deactivate settings caching in the block scope def self.uncached cache_setting = self.use_caching self.use_caching = false yield ensure self.use_caching = cache_setting end # Check if Setting caching should be performed def self.use_caching? !Thread.current['chiliproject/settings/do_not_use_caching'] end # Dis-/En-able Setting caching. This is mainly intended to be used in tests def self.use_caching=(new_value) Thread.current['chiliproject/settings/do_not_use_caching'] = !new_value end private # Returns the Setting instance for the setting named name # (record found in database or new record with default value) def self.find_or_default(name) name = name.to_s raise "There's no setting named #{name}" unless @@available_settings.has_key?(name) setting = find_by_name(name) setting ||= new(:name => name, :value => @@available_settings[name]['default']) if @@available_settings.has_key? name end def self.cache_key(name) "chiliproject/setting/#{Setting.maximum(:updated_on).to_i}/#{name}" end end