Agile Web Development

System Settings is a plugin that provides a convenient way to store and retrieve system configuration settings in the database. The plugin provides a single model SystemSetting with two properties: name; and value. Names must be unique whereas values have no such restriction.

To create and retrieve system settings, the usual active record operations can be used:

  SystemSetting.create(:name => :environment, :value => 'production')
  SystemSetting.find_by_name(:environment)    # 'production'
  SystemSetting[:environment]                 # 'production'

System Settings requires the creation of a single table. You may choose to perform this step manually, or use the generator provided. To use the generator, run:

  ./script/generate system_settings_migration

This will generate an appropriately numbered migration script named NNN_create_system_settings.rb in the db/migrate directory. The next time you run rake migrate, the table will automatically be created for you.

If you would prefer a different name for the script, simply pass the name as an argument. For example:

  ./script/generate system_settings_migration create_the_system_settings_table

The plugin fully supports and understands the following active-record configuration properties:

• config.active_record.pluralize_table_names
• config.active_record.table_name_prefix
• config.active_record.table_name_suffix

Dependencies

• Schema Validations (schema_validations)—unless you choose to implement the functionality yourself.

Owner: Red Hill Consulting

Home: http://www.redhillconsulting.com.au/rails_plugins.html

Repository: svn://rubyforge.org/var/svn/redhillonrails/trunk/vendor/plugins/system_settings

License: Rails' (MIT)

Category: Misc. Enhancements