refinerycms-settings 0.9.9.1

data/config/locales/sl.yml

@@ -0,0 +1,25 @@
+sl:
+  activerecord:
+    models:
+      refinery_setting: Refinery nastavitve
+    attributes:
+      refinery_setting:
+        name: Ime
+        value: Vrednost
+  admin:
+    refinery_settings:
+      delete: Odstrani nastavitev
+      edit: Uredi nastavitev
+      index:
+        new: Dodaj novo nastavitev
+        empty_set: Tretnutno ni nobene nastavitve.
+        create_first: "Kliknite '%{link}' da boste dodali vašo prvo nastavitev."
+      form:
+        enabled: "Da, omogoči to nastavitev."
+        restart_may_be_in_order_html: "<strong>Prosimo upoštevajte</strong> da boste morali včasih ponovno zagnati spletno stran, da bo nastavitev stopila v veljavo."
+        yes_make_this_setting_restricted: Da, ta nastavitev naj bo omejena samo na super-uporabnike.
+        help:
+          restricted: To omogoča da nastavitev lahko vidijo in urejajo samo super-uporabniki (kot ste vi).
+  plugins:
+    refinery_settings:
+      title: Nastavitve

data/config/locales/sv.yml

@@ -0,0 +1,45 @@
+sv:
+  plugins:
+    refinery_settings:
+      title: Inställningar
+      description: Hantera inställningar i Refinery
+  admin:
+    refinery_settings:
+      delete: Ta bort den här inställningen för alltid
+      edit: Redigera den här inställningen
+      index:
+        new: Lägg till ny inställning
+        empty_set: Det finns inga inställningar ännu.
+        create_first: "Klicka '%{link}' för att lägga till din första inställning."
+      form:
+        enabled: "Ja, aktivera den här inställningen."
+        restart_may_be_in_order_html: <strong>Var god notera</strong> att du kan behöva starta om webbplatsen för att den här inställningen ska träda i kraft.
+        yes_make_this_setting_restricted: "Ja, gör så att enbart huvudanvändare kan komma åt den här inställningen."
+        help:
+          restricted: Det här gör inställnigen synlig och redigerbar av huvudanvändare (tex. du).
+          activity_show_limit: Det här begränsar antalet rader som kan visas i din Dashboard.
+          analytics_page_code: Den här koden aktiverar Google Analytics på din webbplats. Om den här inställningen lämnas tom eller är installd till UA-xxxxx-x så är den avstängd.
+          frontend_refinery_stylesheets_enabled: Som standard så inkluderar Refinery stilmallar för gränssnittet som ger ett enkelt utseende utan att komma ivägen för dina egna stilmallar. Detta aktiveras eller inaktiveras med denna inställning.
+          image_dialogue_sizes: Den här inställningen gäller dialogen för att "Ladda upp en bild". Du behöver implementera olika tumnagelstorlekar såväl som ändra den här.
+          image_thumbnails: Om du ändrar den här inställningen så måste du återskapa dina bilder genom att köra rake images:regenerate (eller rake images:update om du bara har lagt till nya tumnaglar). Annars kommer inställningen inte gälla bilder som fanns innan ändringen
+          menu_hide_children: Dölj alla undersidor från huvudmenyn även om de är tillgängliga.
+          new_page_parts: Tillåt att lägga till nya innehållssektioner i sidredigeraren.
+          page_title: Här kan du ställa in CSS eller html tag. Du kan även ställa in brödsmulor (s.k. breadcrumbs) för sidans ursprung
+          pages_advanced_options_include_seo: Den här styr om huruvida sökmotoroptimering visas i de avancerade alternativen för en sida
+          preferred_image_view: Den här styr vilken vy tillägsprogrammet för bilder väljer att visa bilder i. 'Grid View' för rutnät eller 'List View' för lista. Det finns en knapp för att automatisera denna process i tillägsprogrammet.
+          refinery_enable_backend_reordering: Du kan ta bort möjligheten att ändra ordningen på plugins med den här inställningen.
+          refinery_menu_cache_action_suffix: Den här inställningen kontrollerar nyckeln som används för att buffra sidans meny. Om du använder ett tema är det bättre att lämna den här som standard för temat kommer hantera det ändå.
+          show_contact_privacy_link: Du kan välja att visa eller dölja Registerbeskrivning (privacy policy) bredvid skicka knappen.
+          site_name: Det här är webbplatsens namn och den kommer visas i huvudrubryken, Refinery och i foten på hemsidan.
+          theme: Fyll i namnet på det tema du vill aktivera. Det här tar effekt direkt och måste hitta ett existerande tema för att fungera.
+          use_google_ajax_libraries: Om du vill använda Googles AJAX CDN så välj true
+          use_marketable_urls: Ändra URLer från /pages/about till /about och hantera automatiskt konflikter med andra plugin
+          use_resource_caching: Rekomenderat att aktivera den här inställningen i produktionsläget då den buffrar javascript, stilmallar m.m. till ett enskilt paket att skicka vilket minimerar antalet kopplingar till din webbplats och snabbar upp laddningstiden.
+  activerecord:
+    models:
+      refinery_setting: inställning
+    attributes:
+      refinery_setting:
+        name: Namn
+        value: Värde
+        restricted: Begränsad

data/config/locales/vi.yml

@@ -0,0 +1,47 @@
+vi:
+  plugins:
+    refinery_settings:
+      title: Settings
+      description: Quản lý các thiết lập của Refinery
+  admin:
+    refinery_settings:
+      delete: Xóa thiết lập này vĩnh viễn
+      edit: Chỉnh sửa thiết lập này
+      index:
+        new: Thêm thiết lập mới
+        empty_set: Chưa có thiết lập nào cả.
+        create_first: "Bấm vào đây '%{link}' để thêm thiết lập đầu tiên của bạn."
+      form:
+        enabled: "OK, kích hoạt cài đặt này."
+        restart_may_be_in_order_html: <strong>Chú ý:</strong> có thể bạn cần phải khởi động lại trang web để thiết lập này có hiệu lực.
+        yes_make_this_setting_restricted: "OK, thiết lập này bị giới hạn cho superusers."
+        help:
+          restricted: Điều này làm cho các thiết lập chỉ hiển thị và chỉnh sửa bởi superusers (những người như bạn).
+          activity_show_limit: Điều này hạn chế số lượng hàng có thể hiển thị trong danh sách Bảng điều khiển.
+          analytics_page_code: "Mã này kích hoạt Google Analytics theo dõi trong trang web của bạn. Nếu thiết lập được để trống, hoặc có dạng UA-xxxxxx-x có nghĩa là vô hiệu hoá và không có tương tác với Google Analytics được thực hiện."
+          frontend_refinery_stylesheets_enabled: "Theo mặc định, Refinery bao gồm các stylesheets cho frontend, mà sẽ không ảnh hưởng các stylesheets riêng của bạn, kích hoạt hay vô hiệu hóa bằng cách thiết lập này."
+          image_dialogue_sizes: Thiết lập này áp dụng cho các Insert Image box. Bạn phải làm các kích thước thumbnail khác nhau cũng như thay đổi thiết lập này.
+          image_thumbnails: "Nếu bạn thay đổi cài đặt này, bạn sẽ phải tạo lại hình ảnh của bạn bằng cách chạy  rake images:regenerate (hoặc rake images:update nếu bạn chỉ thêm vào hình thu nhỏ khác) nếu không thiết lập sẽ không áp dụng cho hình ảnh hiện tại."
+          menu_hide_children: Ẩn bất kỳ trang con từ trình đơn ngay cả khi nó có mặt.
+          new_page_parts: Kích hoạt tính năng bổ sung thêm bộ phận mới của trang (các phần nội dung) trong các phần để chỉnh sửa trang.
+          page_title: Đây là các tùy chọn rất phức tạp để thiết lập tiêu đề trang. Tại đây bạn có thể tùy chỉnh CSS hoặc tag hoặc thay đổi cấu trúc breadcrumb.
+          pages_advanced_options_include_seo: Các tùy chọn SEO được hiển thị trong các tùy chọn nâng cao cho một trang.
+          preferred_image_view: Thiết lập này điều khiển các trang mà các plugin về hình ảnh có thể hiển thị hình ảnh hiện có - dạng lưới cho 'Grid View" và dạng danh sách cho "List View". Có một nút để tự động hóa quá trình này trên những hình ảnh plugin chính nó.
+          refinery_enable_backend_reordering: Bạn có thể loại bỏ khả năng sắp xếp lại thứ tự hiển thị của plugin này.
+          refinery_menu_cache_action_suffix: Thiết lập này điều khiển phím được sử dụng để cache menu của trang web. Nếu bạn đang sử dụng một theme thì tốt hơn là để như mặc định bởi vì theme sẽ xử lý nó.
+          show_contact_privacy_link: Bạn có thể ẩn hoặc hiển thị các liên kết đến trang privacy policy trên các form liên lạc bằng nút Submit.
+          site_name: "Đây là tên trang web của bạn và sẽ hiển thị trong phần đầu, trong trang admin của Refinery và trong phần bản quyền ở phần footer cho một số theme."
+          theme: Nhập tên của theme mà bạn muốn hiển thị. Điều này sẽ có hiệu lực ngay lập tức. Nhớ là  bạn phải viết tên theme chính các thì tùy chỉnh này mới hoạt động.
+          use_google_ajax_libraries: Nếu bạn muốn sử dụng Google AJAX CDN thì đặt thiết lập này là true.
+          use_marketable_urls: Thay đổi url từ /pages/about thành /about và tự động quản lý xung đột với các plugin khác.
+          use_resource_caching: Khuyến nghị để cho phép điều này trong chế độ production vì nó đóng gói javascript và stylesheet thành một gói tập tin duy nhất để giảm bớt số lượng web requests và tăng tốc độ site của bạn lên.
+          approximate_ascii: "Thiết lập này cho đúng nếu bạn sử dụng ký tự Latin với dấu và bỏ dấu trong tiêu đề của trang. Nó sẽ chuyển đổi các ký tự như ā, č, ž into a, c, z và bằng cách này những ký tự sẽ không xuất hiện kỳ lạ trong thanh địa chỉ của một số trình duyệt web."
+          
+  activerecord:
+    models:
+      refinery_setting: Thiết lập
+    attributes:
+      refinery_setting:
+        name: Tên
+        value: Giá trị
+        restricted: Giới hạn

data/config/locales/zh-CN.yml

@@ -0,0 +1,46 @@
+zh-CN:
+  plugins:
+    refinery_settings:
+      title: 设置
+      description: Refinery 设置管理
+  admin:
+    refinery_settings:
+      delete: 永久删除此设置
+      edit: 编辑此设置
+      index:
+        new: 添加新设置
+        empty_set: 这里还没有任何设置.
+        create_first: "点击 '%{link}' 去添加您的第一个设置."
+      form:
+        enabled: "是的, 打开这个设置."
+        restart_may_be_in_order_html: <strong>请注意</strong> 您可能需要重启网站去使得此设置生效.
+        yes_make_this_setting_restricted: "是的, 使此设置限制为只能由超级用户修改."
+        help:
+          restricted: 这使得设置只能由超级用户(像您一样)可见和修改.
+          activity_show_limit: 这能限制控制面板列表项所显示的数量.
+          analytics_page_code: 这个代码可启动 Google Analytics 来跟踪您的网站. 如果这项设定留白或是设为 UA-xxxxxx-x 则表示为关闭这项功能并且不会有任何远程的 Google Analytics 呼叫发生.
+          frontend_refinery_stylesheets_enabled: "在默认的情况, Refinery 包含了不影响您个人样式表的默认 CSS 样式表给前台使用, 可借由这个设定来开启或是关闭这个选项."
+          image_dialogue_sizes: 这个设定可以生效插入图片的对话方框. 您必须完成不同大小的缩图并且改变它.
+          image_thumbnails: 如果您修改了这个选项, 您必须执行 rake images:regenerate (或是 rake image:update, 如果您只是增加了更多缩图), 否则这个设定将不会影响任何已存在网站上的图片.
+          menu_hide_children: 从选单中隐藏任何子页面, 即使它们是存在的.
+          new_page_parts: 开启在页面编辑器可新增新页面区块 (内容区) 的功能.
+          page_title: 提供非常复杂的选项让您设定页面标题. 在这里您可以设定自订的 CSS 类別或是不同的标签, 或是加上记录着页面层级关系的导览列.
+          pages_advanced_options_include_seo: 这可控制是否 SEO 选项会显示在页面上的高级选项中.
+          preferred_image_view: 这可控制图片插件如何呈现目前这些已存在网站上的图片 - grid 表示 '网格模式' 以及 list 表示 '列表模式'. 图片插件本身提供一个按钮可以自动切换这些模式.
+          refinery_enable_backend_reordering: 您可以移除可以重新排列插件显示顺序的功能.
+          refinery_menu_cache_action_suffix: 这可控制用来使用在快取网站选单的金钥. 如果您正在使用布景主题, 那最好不要改变默认值, 让布景主题来为您处里.
+          show_contact_privacy_link: 您可以隐藏或是显示在联络人表单确认按钮旁的隐私条款页面链接.
+          site_name: 这是您的网站名称, 它将会显示在网站标题, Refinery 的后台管理系统, 以及部份有页尾版权宣告的布景主题中.
+          theme: 输入您想要开启的布景主题名称. 它将会马上生效并且确认为是有效的名称.
+          use_google_ajax_libraries: 如果您想要使用 Google 的 AJAX CDN 请设定为 true.
+          use_marketable_urls: 将网址从 /pages/about 改变为 /about 并且自动处理与其他插件的冲突.
+          use_resource_caching: 建议在 production 模式中开启这个选项, 它会将 javascript assets 与样式表 assets 包裹成一个单一文件来减少您网站被请求的次数并且达到加速的效果.
+          approximate_ascii: 如果您使用带有口音或是变音符号的拉丁字母请设定为 true. 它会将像是 ā, č, ž 的字母转为 a, c, z , 在某些网页浏览器中, 这些字母就不会奇怪地出现在网址列上.
+  activerecord:
+    models:
+      refinery_setting: 设置
+    attributes:
+      refinery_setting:
+        name: 名称
+        value: 设置值
+        restricted: 限制

data/config/locales/zh-TW.yml

@@ -0,0 +1,46 @@
+zh-TW:
+  plugins:
+    refinery_settings:
+      title: 設定
+      description: 管理 Refinery 設定值
+  admin:
+    refinery_settings:
+      delete: 永遠地移除這項設定值
+      edit: 編輯這項設定值
+      index:
+        new: 增加新設定值
+        empty_set: 目前沒有任何設定值.
+        create_first: "請按這兒 '%{link}' 加入您的第一個設定值."
+      form:
+        enabled: "是的, 啟動這項設定值."
+        restart_may_be_in_order_html: <strong>請注意</strong> 您必須重新啟動這個網站來讓設定值生效.
+        yes_make_this_setting_restricted: "是的, 讓這項設定只能被管理者修改."
+        help:
+          restricted: 這讓這項設定只能給有管理者權限的使用者 (像您一樣) 看見以及編輯.
+          activity_show_limit: 這可以限制在控制面板列出項目的數目.
+          analytics_page_code: 這個代碼可啟動 Google Analytics 來追蹤您的網站. 如果這項設定留白或是設為 UA-xxxxxx-x 表示為關閉這項功能並且不會有任何遠端的 Google Analytics 呼叫發生.
+          frontend_refinery_stylesheets_enabled: "在預設的情況, Refinery 包含了不影響您個人樣式表的預設 CSS 樣式表給前端使用, 可藉由這個設定來開啟或是關閉這個選項."
+          image_dialogue_sizes: 這個設定可以生效插入圖片的對話方框. 您必須完成不同大小的縮圖並且改變它.
+          image_thumbnails: 如果您修改了這個選項, 您必須執行 rake images:regenerate (或是 rake image:update, 如果您只是增加了更多縮圖), 否則這個設定將不會影響任何已存在網站上的圖片.
+          menu_hide_children: 從選單中隱藏任何次頁面, 即使它們是存在的.
+          new_page_parts: 開啟在頁面編輯器可新增新頁面區塊 (內容區) 的功能.
+          page_title: 提供非常複雜的選項讓您設定頁面標題. 在這裡你可以設定自訂的 CSS 類別或是不同的標籤, 或是加上紀錄著頁面層級關係的導覽列.
+          pages_advanced_options_include_seo: 這可控制是否 SEO 選項會顯示在頁面上的進階選項中.
+          preferred_image_view: 這可控制圖片插件如何呈現目前這些已存在網站上的圖片 - grid 表示 '格狀模式' 以及 list 表示 '列表模式'. 圖片插件本身提供一個按鈕可以自動切換這些模式.
+          refinery_enable_backend_reordering: 您可以移除可以重新排列插件顯示順序的功能.
+          refinery_menu_cache_action_suffix: 這可控制用來使用在快取網站選單的金鑰. 如果您正在使用佈景主題, 那最不要改變預設值, 讓佈景主題來為您處裡.
+          show_contact_privacy_link: 您可以隱藏或是顯示在聯絡人表單確認按鈕旁的隱私條款頁面連結.
+          site_name: 這是您的網站名稱, 它將會顯示在網站標題, Refinery 的後台管理系統, 以及部份有頁尾版權宣告的佈景主題中.
+          theme: 輸入您想要開啟的佈景主題名稱. 它將會馬上生效並且確認為是有效的名稱.
+          use_google_ajax_libraries: 如果您想要使用 Google 的 AJAX CDN 請設定為 true.
+          use_marketable_urls: 將網址從 /pages/about 改變為 /about 並且自動處理與其他插件的衝突.
+          use_resource_caching: 建議在 production 模式中開啟這個選項, 它會將 javascript assets 與樣式表 assets 包裹成一個單一檔案來減少您網站被請求的次數並且達到加速的效果.
+          approximate_ascii: 如果您使用帶有口音或是變音符號的拉丁字母請設定為 true. 它會將像是 ā, č, ž 的字母轉為 a, c, z , 在某些網頁瀏覽器中, 這些字母就不會奇怪地出現在網址列上.
+  activerecord:
+    models:
+      refinery_setting: 設定
+    attributes:
+      refinery_setting:
+        name: 名稱
+        value: 設定值
+        restricted: 限制

data/config/routes.rb

@@ -0,0 +1,8 @@
+::Refinery::Application.routes.draw do
+  scope(:path => 'refinery', :as => 'admin', :module => 'admin') do
+    resources :settings,
+              :except => :show,
+              :as => :refinery_settings,
+              :controller => :refinery_settings
+  end
+end

data/db/migrate/20100913234710_create_refinerycms_settings_schema.rb

@@ -0,0 +1,24 @@
+class CreateRefinerycmsSettingsSchema < ActiveRecord::Migration
+  def self.up
+    create_table ::RefinerySetting.table_name, :force => true do |t|
+      t.string   "name"
+      t.text     "value"
+      t.boolean  "destroyable",             :default => true
+      t.datetime "created_at"
+      t.datetime "updated_at"
+      t.string   "scoping"
+      t.boolean  "restricted",              :default => false
+      t.string   "callback_proc_as_string"
+    end
+
+    add_index ::RefinerySetting.table_name, ["name"], :name => "index_#{::RefinerySetting.table_name}_on_name"
+  end
+
+  def self.down
+    [::RefinerySetting].reject{|m|
+      !(defined?(m) and m.respond_to?(:table_name))
+    }.each do |model|
+      drop_table model.table_name
+    end
+  end
+end

data/db/migrate/20100926142529_add_value_type_to_refinery_settings.rb

@@ -0,0 +1,9 @@
+class AddValueTypeToRefinerySettings < ActiveRecord::Migration
+  def self.up
+    add_column ::RefinerySetting.table_name, :form_value_type, :string
+  end
+
+  def self.down
+    remove_column ::RefinerySetting.table_name, :form_value_type
+  end
+end

data/features/manage_refinery_settings.feature

@@ -0,0 +1,5 @@
+@refinerycms @settings @settings-manage @refinery-settings
+Feature: Manage Refinery Settings
+  In order to control the configuration of my website
+  As an administrator
+  I want to create and manage refinery settings

data/features/step_definitions/setting_steps.rb

@@ -0,0 +1,9 @@
+Given /^I have no (?:|refinery )settings$/ do
+  RefinerySetting.delete_all
+end
+
+Given /^I (only )?have a (?:|refinery )setting titled "([^\"]*)"$/ do |only, title|
+  RefinerySetting.delete_all if only
+
+  RefinerySetting.set(title.to_s.gsub(' ', '').underscore.to_sym, nil)
+end

data/features/support/paths.rb

@@ -0,0 +1,14 @@
+module NavigationHelpers
+  module Refinery
+    module Settings
+      def path_to(page_name)
+        case page_name
+        when /the list of (?:|refinery )settings/
+          admin_refinery_settings_path
+        else
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/gemspec.rb

@@ -0,0 +1,33 @@
+require 'pathname'
+gempath = Pathname.new(File.expand_path('../../', __FILE__))
+require gempath.join('..', 'base', 'lib', 'base', 'refinery')
+
+gemspec = <<EOF
+# DO NOT EDIT THIS FILE DIRECTLY! Instead, use lib/gemspec.rb to generate it.
+
+Gem::Specification.new do |s|
+  s.name              = %q{#{gemname = 'refinerycms-settings'}}
+  s.version           = %q{#{::Refinery.version}}
+  s.summary           = %q{Settings engine for Refinery CMS}
+  s.description       = %q{The default settings engine that is required by Refinery CMS core. Adds programmer creatable, user editable settings for each engine.}
+  s.date              = %q{#{Time.now.strftime('%Y-%m-%d')}}
+  s.email             = %q{info@refinerycms.com}
+  s.homepage          = %q{http://refinerycms.com}
+  s.rubyforge_project = %q{refinerycms}
+  s.authors           = ['Resolve Digital', 'Philip Arndt', 'David Jones', 'Steven Heidel']
+  s.license           = %q{MIT}
+  s.require_paths     = %w(lib)
+  s.executables       = %w(#{Pathname.glob(gempath.join('bin/*')).map{|d| d.relative_path_from(gempath)}.sort.join(" ")})
+
+  s.files             = [
+    '#{%w( **/{*,.rspec,.gitignore,.yardopts} ).map { |file| Pathname.glob(gempath.join(file)) }.flatten.reject{|f|
+      !f.exist? or f.to_s =~ /\.gem$/ or (f.directory? and f.children.empty?)
+    }.map{|d| d.relative_path_from(gempath)}.uniq.sort.join("',\n    '")}'
+  ]
+
+  s.add_dependency 'refinerycms-base', '~> #{::Refinery::Version}'
+end
+EOF
+
+(gemfile = gempath.join("#{gemname}.gemspec")).open('w') {|f| f.puts(gemspec)}
+puts `cd #{gempath} && gem build #{gemfile}` if ARGV.any?{|a| a == "BUILD=true"}

data/lib/generators/refinerycms_settings_generator.rb

@@ -0,0 +1,8 @@
+require 'refinery/generators'
+
+class RefinerycmsSettings < ::Refinery::Generators::EngineInstaller
+
+  source_root File.expand_path('../../../', __FILE__)
+  engine_name "settings"
+
+end

data/lib/refinerycms-settings.rb

@@ -0,0 +1,26 @@
+require 'refinerycms-base'
+
+module Refinery
+  module Settings
+
+    class << self
+      attr_accessor :root
+      def root
+        @root ||= Pathname.new(File.expand_path('../../', __FILE__))
+      end
+    end
+
+    class Engine < ::Rails::Engine
+      config.after_initialize do
+        ::Refinery::Plugin.register do |plugin|
+          plugin.name = "refinery_settings"
+          plugin.url = {:controller => "/admin/refinery_settings"}
+          plugin.version = %q{0.9.9}
+          plugin.menu_match = /(refinery|admin)\/(refinery_)?settings$/
+        end
+      end
+    end
+  end
+end
+
+::Refinery.engines << 'settings'

data/license.md

@@ -0,0 +1,21 @@
+# MIT License
+ 
+Copyright (c) 2005-2010 [Resolve Digital](http://www.resolvedigital.com)
+ 
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+ 
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/readme.md

@@ -0,0 +1,55 @@
+# Settings
+
+![Refinery Settings](http://refinerycms.com/system/images/0000/0666/settings.png)
+
+## About
+
+Refinery comes out of the box with a full settings area that is populated with smart defaults to avoid configuration.
+
+## Settings of Interest
+
+Here's an overview of what comes out of the box
+
+### Google Analytics
+
+Just edit the setting called "Analytics Page Code" and enter just your account number. It will look something like this
+
+    UA-XXXXXX-X
+    
+Save this and Refinery will automatically note you have set the page code up and start rendering it on the front end so tracking can begin.
+
+### Firebug Lite Support
+
+[Firebug lite](http://getfirebug.com/lite) is fantastic for debugging your site in Internet Explorer.
+
+Set the 'Show Firebug Lite' setting to ``true`` and you'll be able to debug your views in Internet Explorer in no time.
+
+_Note: you'll want to turn this off once your site is live_
+
+### Use Google Ajax Libraries
+
+This setting will automatically change your AJAX libraries to use the ones delivered by Google's CDN (Content Delivery Network) which means your Javascript will be cached and delivery as quickly as possible.
+
+## How do I Make my Own Settings?
+
+Settings can be really useful, especially when you have custom display logic or new plugins that need to behave in different ways.
+
+To best explain how settings work let's use an example.  Say you have a client who has a display in a local trade show every year and 2 months before the trade show they want to display a little banner in the header of all pages.
+
+But once the trade show is finished, the client needs to be able to hide it again until next year. This is what my ``application.html.erb`` file might look like:
+
+    ...
+    <div id='header'>
+      <h1>My Company</h1>
+      
+      <% if RefinerySetting.find_or_set(:show_trade_show_banner, false) %> 
+        <%= image_tag ('trade-show-banner.jpg') %>
+      <% end %>
+    </div>
+    ...
+    
+The following will automatically create a new Refinery setting called "show_trade_show_banner" and default it to ``false``. If that setting already exists, it just reads in what the current value is.
+
+So as you can see this is quite clever because you can quickly define new settings and their defaults right from the view as you need them.
+
+This setting would then show up in the backend in the 'Settings' area where the client could change the value as their trade show approaches. Easy as pie!

data/refinerycms-settings.gemspec

@@ -0,0 +1,84 @@
+# DO NOT EDIT THIS FILE DIRECTLY! Instead, use lib/gemspec.rb to generate it.
+
+Gem::Specification.new do |s|
+  s.name              = %q{refinerycms-settings}
+  s.version           = %q{0.9.9.1}
+  s.summary           = %q{Settings engine for Refinery CMS}
+  s.description       = %q{The default settings engine that is required by Refinery CMS core. Adds programmer creatable, user editable settings for each engine.}
+  s.date              = %q{2011-02-15}
+  s.email             = %q{info@refinerycms.com}
+  s.homepage          = %q{http://refinerycms.com}
+  s.rubyforge_project = %q{refinerycms}
+  s.authors           = ['Resolve Digital', 'Philip Arndt', 'David Jones', 'Steven Heidel']
+  s.license           = %q{MIT}
+  s.require_paths     = %w(lib)
+  s.executables       = %w()
+
+  s.files             = [
+    'app',
+    'app/controllers',
+    'app/controllers/admin',
+    'app/controllers/admin/refinery_settings_controller.rb',
+    'app/helpers',
+    'app/helpers/refinery_settings_helper.rb',
+    'app/models',
+    'app/models/refinery_setting.rb',
+    'app/views',
+    'app/views/admin',
+    'app/views/admin/refinery_settings',
+    'app/views/admin/refinery_settings/_form.html.erb',
+    'app/views/admin/refinery_settings/_refinery_setting.html.erb',
+    'app/views/admin/refinery_settings/_refinery_settings.html.erb',
+    'app/views/admin/refinery_settings/edit.html.erb',
+    'app/views/admin/refinery_settings/index.html.erb',
+    'app/views/admin/refinery_settings/new.html.erb',
+    'config',
+    'config/locales',
+    'config/locales/cs.yml',
+    'config/locales/da.yml',
+    'config/locales/de.yml',
+    'config/locales/el.yml',
+    'config/locales/en.yml',
+    'config/locales/es.yml',
+    'config/locales/fr.yml',
+    'config/locales/it.yml',
+    'config/locales/lolcat.yml',
+    'config/locales/lt.yml',
+    'config/locales/lv.yml',
+    'config/locales/nb.yml',
+    'config/locales/nl.yml',
+    'config/locales/pl.yml',
+    'config/locales/pt-BR.yml',
+    'config/locales/rs.yml',
+    'config/locales/ru.yml',
+    'config/locales/sl.yml',
+    'config/locales/sv.yml',
+    'config/locales/vi.yml',
+    'config/locales/zh-CN.yml',
+    'config/locales/zh-TW.yml',
+    'config/routes.rb',
+    'db',
+    'db/migrate',
+    'db/migrate/20100913234710_create_refinerycms_settings_schema.rb',
+    'db/migrate/20100926142529_add_value_type_to_refinery_settings.rb',
+    'features',
+    'features/manage_refinery_settings.feature',
+    'features/step_definitions',
+    'features/step_definitions/setting_steps.rb',
+    'features/support',
+    'features/support/paths.rb',
+    'lib',
+    'lib/gemspec.rb',
+    'lib/generators',
+    'lib/generators/refinerycms_settings_generator.rb',
+    'lib/refinerycms-settings.rb',
+    'license.md',
+    'readme.md',
+    'refinerycms-settings.gemspec',
+    'spec',
+    'spec/models',
+    'spec/models/refinery_setting_spec.rb'
+  ]
+
+  s.add_dependency 'refinerycms-base', '~> 0.9.9.1'
+end

data/spec/models/refinery_setting_spec.rb

@@ -0,0 +1,101 @@
+require 'spec_helper'
+
+describe RefinerySetting do
+
+  before(:each) do
+    RefinerySetting.set(:creating_from_scratch, nil)
+    RefinerySetting.set(:rspec_testing_creating_from_scratch, nil)
+  end
+
+  context "set" do
+    it "should create a setting that didn't exist" do
+      RefinerySetting.get(:creating_from_scratch, :scoping => 'rspec_testing').should == nil
+      RefinerySetting.set(:creating_from_scratch, {:value => "Look, a value", :scoping => 'rspec_testing'}).should == "Look, a value"
+    end
+
+    it "should override an existing setting" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => "a value", :scoping => 'rspec_testing'})
+      @set.should == "a value"
+
+      @new_set = RefinerySetting.set(:creating_from_scratch, {:value => "newer replaced value", :scoping => 'rspec_testing'})
+      @new_set.should == "newer replaced value"
+    end
+
+    it "should default to form_value_type text_area" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => "a value", :scoping => 'rspec_testing'})
+      RefinerySetting.find_by_name(:creating_from_scratch.to_s, :conditions => {:scoping => 'rspec_testing'}).form_value_type.should == "text_area"
+    end
+
+    it "should fix true as a value to 'true' (string)" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => true, :scoping => 'rspec_testing'})
+      RefinerySetting.find_by_name(:creating_from_scratch.to_s, :conditions => {:scoping => 'rspec_testing'})[:value].should == 'true'
+      @set.should == true
+    end
+
+    it "should fix false as a value to 'false' (string)" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => false, :scoping => 'rspec_testing'})
+      RefinerySetting.find_by_name(:creating_from_scratch.to_s, :conditions => {:scoping => 'rspec_testing'})[:value].should == 'false'
+      @set.should == false
+    end
+
+    it "should fix '1' as a value with a check_box form_value_type to true" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => "1", :scoping => 'rspec_testing', :form_value_type => 'check_box'})
+      RefinerySetting.find_by_name(:creating_from_scratch.to_s, :conditions => {:scoping => 'rspec_testing'})[:value].should == 'true'
+      @set.should == true
+    end
+
+    it "should fix '0' as a value with a check_box form_value_type to false" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => "0", :scoping => 'rspec_testing', :form_value_type => 'check_box'})
+      RefinerySetting.find_by_name(:creating_from_scratch.to_s, :conditions => {:scoping => 'rspec_testing'})[:value].should == 'false'
+      @set.should == false
+    end
+  end
+
+  context "get" do
+    it "should retrieve a seting that was created" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => "some value", :scoping => 'rspec_testing'})
+      @set.should == 'some value'
+
+      @get = RefinerySetting.get(:creating_from_scratch, :scoping => 'rspec_testing')
+      @get.should == 'some value'
+    end
+
+    it "should also work with setting scoping using string and getting via symbol" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => "some value", :scoping => 'rspec_testing'})
+      @set.should == 'some value'
+
+      @get = RefinerySetting.get(:creating_from_scratch, :scoping => :rspec_testing)
+      @get.should == 'some value'
+    end
+
+    it "should also work with setting scoping using symbol and getting via string" do
+      @set = RefinerySetting.set(:creating_from_scratch, {:value => "some value", :scoping => :rspec_testing})
+      @set.should == 'some value'
+
+      @get = RefinerySetting.get(:creating_from_scratch, :scoping => 'rspec_testing')
+      @get.should == 'some value'
+    end
+  end
+
+  context "find_or_set" do
+    it "should create a non existant setting" do
+      @created = RefinerySetting.find_or_set(:creating_from_scratch, 'I am a setting being created', :scoping => 'rspec_testing')
+
+      @created.should == "I am a setting being created"
+    end
+
+    it "should not override an existing setting" do
+      @created = RefinerySetting.set(:creating_from_scratch, {:value => 'I am a setting being created', :scoping => 'rspec_testing'})
+      @created.should == "I am a setting being created"
+
+      @find_or_set_created = RefinerySetting.find_or_set(:creating_from_scratch, 'Trying to change an existing value', :scoping => 'rspec_testing')
+
+      @created.should == "I am a setting being created"
+    end
+
+    it "should work without scoping" do
+      RefinerySetting.find_or_set(:rspec_testing_creating_from_scratch, 'Yes it worked').should == 'Yes it worked'
+    end
+  end
+
+end