justinfrench-formtastic 0.1.2 → 0.1.3

data/README.textile

@@ -1,4 +1,4 @@
-h1. Formtastic 0.1.1
+h1. Formtastic 0.1.3
 
 Formtastic is a Rails FormBuilder DSL (with some other goodies) to make it far easier to create beautiful, semantically rich, syntactically awesome, readily stylable and wonderfully accessible HTML forms in your Rails applications.
 
@@ -25,9 +25,9 @@ One day, I finally had enough, so I opened up my text editor, and wrote a DSL fo
       <%= form.input :url_title, :required => false %>
     <% end %>
 
-    <% form.inputs :for => :author do |author_form| %>
-      <%= form.input :first_name %>
-      <%= form.input :last_name %>
+    <% form.inputs :name => "Author", :for => :author do |author_form| %>
+      <%= author_form.input :first_name %>
+      <%= author_form.input :last_name %>
     <% end %>
 
     <% form.buttons do %>
@@ -86,13 +86,13 @@ And then add it as a dependency in your environment.rb file:
   config.gem "justinfrench-formtastic", 
     :lib     => 'formtastic', 
     :source  => 'http://gems.github.com', 
-    :version => '0.1.1'
+    :version => '0.1.3'
 </pre>
 
 If you're a little more old school, install it as a plugin:
 
 <pre>
-  ./script/install plugin git://github.com/justinfrench/formtastic.git
+  ./script/plugin install git://github.com/justinfrench/formtastic.git
 </pre>
 
 
@@ -156,30 +156,57 @@ If you want to customize the label text, or render some hint text below the fiel
   <% end %>
 </pre>
 
+If you want to customize html elements for any non button inputs you just need
+to specify the :input_html options hash.
+
+<pre>
+    <% semantic_form_for @post do |form| %>
+      <%= form.input :title, :input_html => {:size => 60} %>
+      <%= form.input :body %>
+      <%= form.input :created_at, :input_html => {:disabled => true} %>
+      <%= form.buttons %>
+    <% end %>
+</pre>
+
 Nested forms (Rails 2.3) are also supported. You can do it in the Rails way:
 
 <pre>
-  <% semantic_form_for @post do |post| %>
-    <%= post.inputs %>
+  <% semantic_form_for @post do |form| %>
+    <%= form.inputs :title, :body, :created_at %>
 
-    <%= post.semantic_fields_for :author do |author| %>
-      <%= author.inputs :first_name, :last_name %>
-    <%= end %>
+    <% form.semantic_fields_for :author do |author| %>
+      <%= author.inputs :first_name, :last_name, :name => 'Author' %>
+    <% end %>
 
-    <%= post.buttons %>
+    <%= form.buttons %>
   <% end %>
 </pre>
 
 Or in the formtastic way:
 
 <pre>
-  <% semantic_form_for @post do |post| %>
-    <%= post.inputs %>
-    <%= post.inputs :first_name, :last_name, :for => :author %>
-    <%= post.buttons %>
+  <% semantic_form_for @post do |form| %>
+    <%= form.inputs :title, :body, :created_at %>
+
+    <%= form.inputs :first_name, :last_name, :for => :author, :name => "Author" %>
+
+    <%= form.buttons %>
+  <% end %>
+</pre>
+
+When working in has many association, you can even supply "%i" in your fieldset
+name that it will be properly interpolated with the child index. For example:
+
+<pre>
+  <% semantic_form_for @post do |form| %>
+    <%= form.inputs %>
+    <%= form.inputs :name => 'Category #%i', :for => :categories %>
+    <%= form.buttons %>
   <% end %>
 </pre>
 
+Each category will be wrapped in a fieldset with legend "Category #1",
+"Category #2" and so on. But please notice that this works only with Rails 2.3.
 
 h2. The Available Inputs
 
@@ -226,9 +253,8 @@ If you wish, put something like this in config/initializers/formtastic_config.rb
   # Defaults to :sentence, valid options are :sentence, :list and :none
   Formtastic::SemanticFormBuilder.inline_errors = :list
 
-  # Set the method to call on label text to transform or format it for human-friendly reading
-  # Defaults to :to_s, because we are already using human_attribute_name when creating labels,
-  # but you might want to change for :titleize or another string method
+  # Set the method to call on label text to transform or format it for human-friendly
+  # reading when formtastic is user without object. Defaults to :humanize.
   Formtastic::SemanticFormBuilder.label_str_method = :titleize
 
   # Set the array of methods to try calling on parent objects in :select and :radio inputs
@@ -247,25 +273,7 @@ If you wish, put something like this in config/initializers/formtastic_config.rb
 
 h2. Internationalization (I18n)
 
-Supports I18n! ActiveRecord object names and attributes are, by default, taken from calling @object.human_name and @object.human_attribute_name(attr) respectively. There are a few words specific to Formtastic that can be translated.
-
-Here is an example locale file:
-
-<pre>
-  en:
-    formtastic:
-      yes: 'Yes'
-      no: 'No'
-      create: 'Create'
-      save: 'Save'
-      year: 'Year'
-      month: 'Month'
-      day: 'Day'
-      hour: 'Hour'
-      minute: 'Minute'
-      second: 'Second'
-      required: 'required'
-</pre>
+Supports I18n! ActiveRecord object names and attributes are, by default, taken from calling @object.human_name and @object.human_attribute_name(attr) respectively. There are a few words specific to Formtastic that can be translated.  See lib/locale/en.yml for more information.
 
 
 h2. ValidationReflection plugin
@@ -316,7 +324,9 @@ A proof-of-concept (very much a work-in-progress) stylesheet is provided which y
 </pre>
 
 
-h2. Many thanks to Formtastic's contributors
+h2. Contributors
+
+Formtastic wouldn't be as awesome as it is today if it weren't for the wonderful contributions of these fine, fine coders.  An extra huge thanks goes out to "José Valim":http://github.com/josevalim for nearly 50 patches.
 
 * "Justin French":http://justinfrench.com
 * "Xavier Shay":http://rhnh.net
@@ -330,13 +340,20 @@ h2. Many thanks to Formtastic's contributors
 * "Sascha Hoellger":http://github.com/mitnal
 * "Jeff Smick":http://github.com/sprsquish
 * "José Valim":http://github.com/josevalim
+* "Greg Fitzgerald":http://github.com/gregf/
+* "Gareth Townsend":http://github.com/quamen
+* "Jack Dempsey":http://github.com/jackdempsey/
+* "Simon Chiu":http://github.com/tolatomeow
+
+
+h2. Hey, join the Google group!
+
+Please join the "Formtastic Google Group":http://groups.google.com.au/group/formtastic, especially if you'd like to talk about a new feature, or report a bug.
 
 
 h2. Project Info
 
 Formtastic is hosted on Github: http://github.com/justinfrench/formtastic/, where your contributions, forkings, comments and feedback are greatly welcomed.
 
-There's also a newly created "Formtastic Google Group":http://groups.google.com.au/group/formtastic.
-
 
 Copyright (c) 2007-2008 Justin French, released under the MIT license.