simple_form 2.0.4 → 2.1.0

data/CHANGELOG.md

@@ -1,305 +1,37 @@
-## 2.0.4
-
-### bug fix
-
-  * Remove invalid files from the gem package.
-  Closes [#673](https://github.com/plataformatec/simple_form/issues/673)
-
-## 2.0.3
-
-### enhancements
-  * Allow to specify custom wrappers for input types.
-  ([@nashby](https://github.com/nashby))
-  Closes [#636](https://github.com/plataformatec/simple_form/issues/636)
-  * Use separate config file to do bootstrap specific configuration.
-  ([@nashby](https://github.com/nashby))
-
-### bug fix
-  * Allow to specify checked and uncked values for boolean input
-  ([@nashby](https://github.com/nashby)).
-  Closes [#643](https://github.com/plataformatec/simple_form/issues/643)
-  * Allow to add additional classes only for wrapper.
-  ([@nashby](https://github.com/nashby)).
-  Closes [#629](https://github.com/plataformatec/simple_form/issues/629)
-  * Boolean hidden field now respects `:name` attribute when nested.
-  ([@amiel](https://github.com/amiel)).
-  Closes [#619](https://github.com/plataformatec/simple_form/issues/619)
-  * Prevent generation of `class=""`. ([@pkmiec](https://github.com/pkmiec))
-  * Fix namespace html propagation to single wrapper of `label` and `input`
-  * Association creates blank select if `:collection` is `nil`.
-  ([@nashby](https://github.com/nashby)).
-  Closes [#595](https://github.com/plataformatec/simple_form/issues/595)
-  * Fix readonly attribute check. ([@retoo](https://github.com/retoo))
-  * Fix error when `collection_check_boxes` used with `form_for` instead of `simple_form_for`.
-  ([@RohanM](https://github.com/RohanM))
-  * Ensure ActionView::Base.field_error_proc is preserved when exceptions occur within
-  `with_simple_form_field_error_proc`.
-  ([@jim](https://github.com/jim))
-  * Handle array of strings in `:checked` option.
-  ([@nashby](https://github.com/nashby))
-
-## 2.0.2
-
-### enhancements
-  * Add `:inline_label` option to nested booleans to display text inline with checkbox.
-  If the value is `true` it uses the default label text. ([@ehoch](https://github.com/ehoch))
-  * Add html support for hints. ([@findrails](https://github.com/findrails))
-
-### bug fix
-  * Fix `min_max` component to not output maximum value. ([@julian7](https://github.com/julian7)).
-  Closes [#483](https://github.com/plataformatec/simple_form/issues/483)
-  * Remove leading and trailing whitespace from `label_text`.
-  Closes [#492](https://github.com/plataformatec/simple_form/issues/492)
-  * Fix checked radio button issue when value is false. ([@georgehemmings](https://github.com/georgehemmings)).
-  * Propagate defaults options to nested forms.
-  Closes [#553](https://github.com/plataformatec/simple_form/issues/533).
-  ([@nashby](https://github.com/nashby))
-  * Fix limit and maxlength with decimal points. ([@shwoodard](https://github.com/shwoodard))
-  * Fix issue when html are duplicated.
-  Closes [#488](https://github.com/plataformatec/simple_form/issues/488).
-  ([@ebonical](https://github.com/ebonical))
-
-## 2.0.1
-
-### bug fix
-  * Sanitaze html attributes to `label` method. ([@nashby](https://github.com/nashby)).
-  Closes [#472](https://github.com/plataformatec/simple_form/issues/472)
-  * Make `collection_check_boxes` and `collection_radio_buttons` work with local variables.
-  Closes [#474](https://github.com/plataformatec/simple_form/issues/474)
-  * Use `html5` component by default in the bootstrap generator. ([@isc](https://github.com/isc)).
-  Closes [#471](https://github.com/plataformatec/simple_form/issues/471)
-
-## 2.0.0
+## 2.1.0
 
 ### enhancements
-  * Add `button_class` configuration to change the class of buttons. ([@sryche](https://github.com/sryche))
-  * Add `disabled` class to a disabled input.
-  * Generate configuration file with `browser_validations` disabled.
-  * Add option and configuration to specify the collection wrapper class. ([@mfila](https://github.com/mfila))
-  * Add proc support to `collection` option. ([@jeffkreeftmeijer](https://github.com/jeffkreeftmeijer))
-  * `simple_form_for` allows default options for its inputs `:defaults => {}`.
-  * Add `readonly` as option of input method. ([@Untainted123](https://github.com/Untainted123))
-  * `simple_fields_for` for inherits wrapper option form the form builder. ([@nashby](https://github.com/nashby))
-  * Use action prefix in the form css class. Closes [#360](https://github.com/plataformatec/simple_form/issues/360).
-    This is not backward compatible with the previous versions of SimpleForm.
-    For more informations see [this comment](https://github.com/plataformatec/simple_form/issues/360#issuecomment-3000780).
+  * `input_field` supports components that don't generate tags
+    as `:min_max`, `:maxlength`, `:placeholder`, `:pattern`, `:readonly`.
+    Closes[#362](https://github.com/plataformatec/simple_form/issues/632).
     ([@nashby](https://github.com/nashby))
-  * Add a readonly component that does automatically readonly lookup from object
-  * Add support for proc or lambda as option for format validator ([@nashby](https://github.com/nashby))
-  * Handle validates_length_of :is option in maxlength ([@nashby](https://github.com/nashby))
-  * Add field_with_hint css class to the wrapper when the input has a hint, similar to field_with_errors ([@nashby](https://github.com/nashby))
-  * Add :grouped_select input type, mapping to Rails grouped_collection_select helper ([@semaperepelitsa](https://github.com/semaperepelitsa))
-  * Add automatic translation of options for collection inputs given a collection of symbols ([@klobuczek](https://github.com/klobuczek))
-  * Add `:boolean_style` config to change how check boxes and radios will be displayed.
-    Options are `:inline = input + label` (default) and `:nested = label > input`.
-  * Add possibility to give a block to `collection_radio` and `collection_check_boxes`,
-    yielding a custom builder to generate custom label and input structure. It
-    is used internally with the :nested option for `:boolean_style`, and is useful
-    to allow some more customization if required.
-  * Do not generate hidden check box field when using nested boolean style, as it is considered
-    invalid markup in HTML5. This will work by default in Rails > 3.2.1 (not released at this time),
-    and is backported inside SimpleForm builder extensions.
-    More info in [#215](https://github.com/plataformatec/simple_form/issues/215)
-  * Add `item_wrapper_class` configuration option for collection radio buttons / check boxes inputs.
-  * Change default generator templates to use .form-inputs and .form-actions classes in wrapper divs.
-    (the latter is the default in bootstrap, so this makes it easier to integrate).
-  * Field error now accepts HTML tags ([@edison](https://github.com/edison))
-  * Add `generate_additional_classes_for` config option to selectively disable extra
-    css classes for components - wrapper, label and input. ([krzyzak](https://github.com/krzyzak))
-
-### deprecation
-  * Deprecate part of the old configuration API in favor of the wrapper API which allows you to customize your inputs
-    in a more flexible way. See [this guide](https://github.com/plataformatec/simple_form/wiki/Upgrading-to-Simple-Form-2.0)
-    to know how upgrade.
-  * Deprecate the `translate` configuration in favor of `translate_labels`
-  * Deprecate the `html5` configuration in favor of a new `html5` component
-  * Deprecate `:radio` input type in favor of `:radio_buttons`
-  * Deprecate `collection_radio` form helper in favor of `collection_radio_buttons`
-    (the label class has changed as well)
-  * Remove `error_notification_id` configuration
-
-### bug fix
-  * Fix i18n lookup with attributes with same name of models.
-    Closes [#149](https://github.com/plataformatec/simple_form/issues/149)
-    and [#364](https://github.com/plataformatec/simple_form/issues/364).
-    ([@nashby](https://github.com/nashby) and [@MarceloCajueiro](https://github.com/MarceloCajueiro))
-  * Do not generate `for` attribute for the collection label when it is a checkbox or radio.
-    Closes [#344](https://github.com/plataformatec/simple_form/issues/344).
-    ([@nashby](https://github.com/nashby) and [@mfila](https://github.com/mfila))
-  * Select can have required option when the `:include_blank` option is passed.
-    Closes [#340](https://github.com/plataformatec/simple_form/issues/340). ([@nashby](https://github.com/nashby))
-  * `:checked` option should override the existing associations on `collection_check_boxes`.
-    Closes [#341](https://github.com/plataformatec/simple_form/issues/341). ([@nashby](https://github.com/nashby))
-  * Move default attribute translations out of root - use "defaults" key instead
-    Closes [#384](https://github.com/plataformatec/simple_form/issues/384). ([@fringd](https://github.com/fringd))
-  * Fix label to datetime inputs to point to first select. ([@georgehemmings](https://github.com/georgehemmings))
-  * Fix usage of f.button :button with Rails 3.2.
-    Closes [#449](https://github.com/plataformatec/simple_form/issues/449).
-
-## 1.5.2
-
-### bug fix
-  * Remove the internal usage of deprecated `:components`
-
-## 1.5.1
-
-### deprecation
-  * `:components` options is now deprecated
-
-### bug fix
-  * Fallback to default label when block is provided. ([@pivotal-casebook](https://github.com/pivotal-casebook))
-  * Do not override default selection through attribute value in collection select when label/value methods are lambdas.
-
-## 1.5.0
-
-### enhancements
-  * Simplified generator by using directory action. ([@rupert654](https://github.com/rupert654))
-  * Support for `maxlength` on string inputs inferred from validation. ([@srbartlett](https://github.com/srbartlett))
-  * Change form css class handling to only add the dom class when one is not given to the form call.
-    ([@patrick99e99](https://github.com/patrick99e99))
-  * Support for required attributes when action validations are present. ([@csegura](http://github.com/csegura))
-  * Do not generate `size` attribute for numeric input. ([@csegura](https://github.com/jasonmp85))
-  * Support for `maxlength` on text area inputs inferred from validation.
-  * Support for `pattern` on text field inferred from validation when `:pattern` is true.
-  * Break Text, Password and File into their own inputs.
-  * Support easy enabling and disabling of components for specific inputs.
-  * Add HTML5 range input.
-
-### bug fix
-  * Fix bug when `simple_fields_for` is used with a hash like models and Rails 3.1.
-  * Fix bug that does not remove the `:item_wrapper_tag` or the `:collection_wrapper_tag` on collection
-    inputs when nil or false value is passed to these options. ([@dw2](https://gitbub.com/dw2))
-  * Fix bug that disable the entire select and wrapper when `disabled` option is a string or array.
-  * Fix bug when using label/value methods as procs together with disabled/selected options as procs for select inputs.
-
-## 1.4.2
-
-### enhancements
-  * Rails 3.1 support.
-
-## 1.4.1
-
-### enhancements
-  * ignore required attribute when conditional validations are present.
-
-### bug fix
-  * Do not use `required='required'` when browser validations are turned off.
-  * Sanitize HMTL attributes in error and hint helpers when options are present.
-  * Improve i18n lookup by ignoring explicit child index given to form builder.
-    (tests by [@rywall](https://github.com/rywall))
-  * Fixes the form specific validation option if specified on the form itself. ([@medihack](https://github.com/medihack))
-
-## 1.4.0
-
-### enhancements
-  * Add label class configuration option. ([@reu](http://github.com/reu))
-  * Improve i18n lookup (labels/hints/placeholders) for nested models.
-  * Use the given custom builder with `simple_fields_for`. ([@giniedp](https://github.com/giniedp))
-  * Add slim form generator. ([@fagiani](https://github.com/fagiani))
-  * Add `form_class` configuration option. ([@fagiani](https://github.com/fagiani))
-  * Default step of `any` for number input with non integer attributes. ([@fedesoria](https://github.com/fedesoria))
-  * Add option to disable HTML5 browser validations on all forms. ([@coryschires](https://github.com/coryschires))
-  * Add option to disable all HTML5 extensions. ([@wolframarnold](https://github.com/wolframarnold))
-  * Add `input_field` helper to form builder. ([@jeroenhouben](https://github.com/jeroenhouben))
-  * Allow inputs to be discovered on demand by placing them at app/inputs (a la formtastic).
-  * Add `full_error` on that shows the error with the attribute name.
-
-### bug fix
-  * Fix for file attributes automatic detection, to work with virtual attributes.
-  * Fix for numeric fields validation options using symbols and procs.
-  * Fix password attributes to add `size` and `maxlength` options the same way as string. ([@fedesoria](https://github.com/fedesoria))
-  * Fix bug with custom form builders and new mappings being added to the superclass builder. ([@rdvdijk](https://github.com/rdvdijk))
-  * Fix HTML validation issue with `collection_check_boxes`.
-
-## 1.3.1
-
-### enhancements
-  * Add `:autofocus` HTML5 attribute support. ([@jpzwarte](https://github.com/jpzwarte))
-  * Add possibility to specify custom builder and inherit mappings. ([@rejeep](https://github.com/rejeep))
-  * Make custom mappings work with all attributes types. ([@rafaelfranca](https://github.com/rafaelfranca))
-  * Add support for procs/lambdas in text/value methods for `collection_select`.
-
-### deprecation
-  * removed the deprecated `:remote_form_for`
-
-### bug fix
-  * Only add the `required` HTML 5 attribute for valid inputs, disable in selects (not allowed).
-  * Fix error when using hints without an attribute.
-    ([@butsjoh](https://github.com/butsjoh) and [@rafaelfranca](https://github.com/rafaelfranca))
-  * Fix messy html output for hint, error and label components.
-    ([@butsjoh](https://github.com/butsjoh) and [@rafaelfranca](https://github.com/rafaelfranca))
-  * Allow direct setting of for attribute on label. ([@Bertg](https://github.com/Bertg))
-
-## 1.3.0
-
-### enhancements
-  * Allow collection input to accept a collection of symbols.
-  * Add default css class to button.
-  * Allow forms for objects that do not respond to the `errors` method.
-  * `collection_check_boxes` and `collection_radio` now wrap the input in the label.
-  * Automatic add min/max values for numeric attributes based on validations and step for integers - HTML5.
-    ([@dasch](https://github.com/dasch))
-  * Add `:placeholder` option for string inputs, allowing customization through I18n - HTML5.
-    ([@jonathan](https://github.com/jonathan))
-  * Add `:search` and `:tel` input types, with `:tel` mapping automatically from attributes matching "phone" - HTML5.
-  * Add `:required` html attribute for required inputs - HTML5.
-  * Add optional `:components` option to input to control component rendering. ([@khoan](https://github.com/khoan))
-  * Add `SimpleForm.translate` as an easy way to turn off SimpleForm internal translations.
-  * Add `:disabled` option for all inputs. ([@fabiob](https://github.com/fabiob))
-  * Add collection wrapper tag and item wrapper tag to wrap elements in collection helpers - radio / check boxes.
-  * Add `SimpleForm.input_mappings` to allow configuring custom mappings for inputs. ([@TMaYaD](https://github.com/TMaYaD))
-
-### bug fix
-  * Search for validations on both association and attribute.
-  * Use `controller.action_name` to lookup action only when available, to fix issue with Rspec views tests.
-    ([@rafaelfranca](https://github.com/rafaelfranca))
-
-## 1.2.2
-
-### enhancements
-  * Compatibility with Rails 3 RC.
-
-## 1.2.1
-
-### enhancements
-  * Added haml generator support. ([@grimen](https://github.com/grimen))
-  * Added `error_notification` message to form builder.
-  * Added required by default as configuration option.
-  * Added `label_input` as component, allowing boolean to change its order (input appearing first than label).
-  * Added `error_method` to tidy up how errors are exhibited.
-  * Added error class on wrappers. ([@jduff](https://github.com/jduff))
-  * Changed numeric types to have `type=number` for HTML5.
-
-## 1.2.0
-
-### deprecation
-  * Changed `simple_form_install` generator to `simple_form:install`.
-
-### enhancements
-  * Added support to presence validation to check if attribute is required or not. ([@gcirne](https://github.com/gcirne))
-  * Added `input` as class to wrapper tag.
-  * Added config options for hint and error tags. ([@tjogin](https://github.com/tjogin))
-
-## 1.1.3
-
-### deprecation
-  * removed `:conditions`, `:order`, `:joins` and `:include` support in `f.association`.
-
-## 1.1.2
-
-### bug fix
-  * Ensure type is set to "text" and not "string".
-
-## 1.1.1
-
-### bug fix
-  * Fix some escaping issues.
-
-## 1.1.0
-
-### enhancements
-  * Rails 3 support with generators, templates and HTML 5.
-
-## 1.0
+  * support for Rails eager loading.
+    Closes [#478](https://github.com/plataformatec/simple_form/issues/478).
+  * generate required attribute for `date_time` input.
+    ([@nashby](https://github.com/nashby))
+    Closes [#730](https://github.com/plataformatec/simple_form/issues/730).
+  * `grouped_collection_select` now accepts proc/lambda as label and value method.
+    ([@svendahlstrand](https://github.com/svendahlstrand))
+    Closes [#623](https://github.com/plataformatec/simple_form/issues/623).
+  * Add Zurb Foundation 3 integration.
+    ([@balexand](https://github.com/balexand))
+  * Generates additional wrapper class based on object + attribute name.
+    ([@lucasmazza](https://github.com/lucasmazza))
+    Closes [#576](https://github.com/plataformatec/simple_form/issues/576).
+  * Allow `input_field` to work with `:defaults` options.
+    ([@smidwap](https://github.com/smidwap))
+
+### bug fix
+  * Do not lookup for hints if it was explicitly given false.
+  After #405 we added hint classes for the wrappers, but this has forced the
+  loading of the hint text doing I18n lookups, even though it was explicitly
+  given false. This checks for the option in `#has_hint?`, avoiding the lookup
+  in such cases. This issues has been caught with #627, thanks to
+  ([@shwoodard](https://github.com/shwoodard)).
+  * Fix default I18n lookup for association input.
+  ([@nashby](https://github.com/nashby))
+  Closes [#679](https://github.com/plataformatec/simple_form/issues/679).
+  * Fix escaping issue in `label_input` component
+  ([@allomov](https://github.com/allomov))
 
-* First release.
+Please check [v2.0](https://github.com/plataformatec/simple_form/blob/v2.0/CHANGELOG.md) for previous changes.

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2012 Plataformatec http://plataformatec.com.br/
+Copyright (c) 2009-2013 Plataformatec http://plataformatec.com.br/
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,42 +1,48 @@
 # SimpleForm - Rails forms made easy.
-[![Build Status](https://secure.travis-ci.org/plataformatec/simple_form.png)](http://travis-ci.org/plataformatec/simple_form)
+[![Build Status](https://secure.travis-ci.org/plataformatec/simple_form.png?branch=master)](http://travis-ci.org/plataformatec/simple_form)
 
 **SimpleForm** aims to be as flexible as possible while helping you with powerful components to create
 your forms. The basic goal of SimpleForm is to not touch your way of defining the layout, letting
 you find the better design for your eyes. Most of the DSL was inherited from Formtastic,
 which we are thankful for and should make you feel right at home.
 
-INFO: This README is [also available in a friendly navigable format](http://simple-form.plataformatec.com.br/)
-and refers to **SimpleForm** 2.0. If you are using **SimpleForm** in the versions 1.x, you should
-check this branch:
-
-https://github.com/plataformatec/simple_form/tree/v1.5
+INFO: This README refers to **SimpleForm** 2.1. For older releases, check the related branch for your version.
 
 ## Installation
 
 Add it to your Gemfile:
 
-`gem 'simple_form'`
+```ruby
+gem 'simple_form'
+```
 
 Run the following command to install it:
 
-`bundle install`
+```console
+bundle install
+```
 
 Run the generator:
 
-`rails generate simple_form:install`
+```console
+rails generate simple_form:install
+```
 
 Also, if you want to use the country select, you will need the
 [country_select gem](https://rubygems.org/gems/country_select), add it to your Gemfile:
 
-`gem 'country_select'`
+```ruby
+gem 'country_select'
+```
 
 ### Twitter Bootstrap
 
 **SimpleForm** 2.0 can be easily integrated to the [Twitter Bootstrap](http://twitter.github.com/bootstrap).
 To do that you have to use the `bootstrap` option in the install generator, like this:
 
-`rails generate simple_form:install --bootstrap`
+```console
+rails generate simple_form:install --bootstrap
+```
 
 You have to be sure that you added a copy of the [Twitter Bootstrap](http://twitter.github.com/bootstrap)
 assets on your application.
@@ -47,6 +53,18 @@ For more information see the generator output, our
 
 **NOTE**: **SimpleForm** integration requires Twitter Bootstrap version 2.0 or higher.
 
+### Zurb Foundation 3
+
+To generate wrappers that are compatible with [Zurb Foundation 3](http://foundation.zurb.com/), pass the `foundation` option to the generator, like this:
+
+```console
+rails generate simple_form:install --foundation
+```
+
+Please note that the Foundation wrapper does not support the `:hint` option by default. In order to enable hints, please uncomment the appropriate line in `config/initializers/simple_form_foundation.rb`. You will need to provide your own CSS styles for hints.
+
+Please see the [instructions on how to install Foundation in a Rails app](http://foundation.zurb.com/docs/rails.php).
+
 ## Usage
 
 **SimpleForm** was designed to be customized as you need to. Basically it's a stack of components that
@@ -857,4 +875,4 @@ https://github.com/plataformatec/simple_form/issues
 
 ## License
 
-MIT License. Copyright 2012 Plataformatec. http://plataformatec.com.br
+MIT License. Copyright 2009-2013 Plataformatec. http://plataformatec.com.br

data/lib/generators/simple_form/install_generator.rb

@@ -5,12 +5,13 @@ module SimpleForm
       source_root File.expand_path('../templates', __FILE__)
       class_option :template_engine, :desc => 'Template engine to be invoked (erb, haml or slim).'
       class_option :bootstrap, :type => :boolean, :desc => 'Add the Twitter Bootstrap wrappers to the SimpleForm initializer.'
+      class_option :foundation, :type => :boolean, :desc => 'Add the Zurb Foundation 3 wrappers to the SimpleForm initializer.'
 
       def info_bootstrap
-        return if options.bootstrap?
-        puts "SimpleForm 2 supports Twitter bootstrap. In case you want to " \
-          "generate bootstrap configuration, please re-run this " \
-          "generator passing --bootstrap as option."
+        return if options.bootstrap? || options.foundation?
+        puts "SimpleForm 2 supports Twitter Bootstrap and Zurb Foundation 3. If you want "\
+          "a configuration that is compatible with one of these frameworks, then please " \
+          "re-run this generator with --bootstrap or --foundation as an option."
       end
 
       def copy_config
@@ -18,6 +19,8 @@ module SimpleForm
 
         if options[:bootstrap]
           template "config/initializers/simple_form_bootstrap.rb"
+        elsif options[:foundation]
+          template "config/initializers/simple_form_foundation.rb"
         end
 
         directory 'config/locales'