======
README
======


About
=====

merb_helpers_monkey is a Merb plug-in to extend the following helper methods.

* radio_button() to take boolean value as :checked options.
* fields_for(), form_for(), and fieldset_for() to take :index_by option.


Install
=======

  ### install gem
  $ sudo gem install merb_helpers_monkey
  ## add 'dependency "merb_helpers_monkey"
  $ vi config/dependencies.rb


Usage
=====


radio_button()
--------------

In Merb, 'radio_button :checked=>true' and 'radio_button :checked=>false'
will genereate:

    <input type="radio" checked="true" />
    <input type="radio" checked="false" />

But the following output should be generated:

    <input type="radio" checked="checked" />
    <input type="radio" />

Merb_helpers_monkey extends radio_button() to generate the above <input> tag.
So you can write such as 'radio_button :checked=>(params[:foo]="y")'.


fields_for(), form_for(), fieldsset_for()
----------------------------------------- 

These methods are extended to accept new ':index_by' option.

For example:

    <% @users.each do |user| %>
    <%=  fields_for user, :index_by => :id do %>
    <p>
      <%= text_field :name, :label => 'Name' %>
      <%= text_field :mail, :label => 'Mail' %>
    </p>
    <%   end =%>
    <% end %>

will generate:

    <p>
      <label for="user_name_101">Name</label>
      <input type="text" name="user[101][name]" id="user_name_101" value="Foo" />
      <label for="user_mail_101">Mail</label>
      <input type="text" name="user[101][mail]" id="user_mail_101" value="foo@mail.com" />
    </p>
    <p>
      <label for="user_name_102">Name</label>
      <input type="text" name="user[102][name]" id="user_name_102" value="Bar" />
      <label for="user_mail_102">Mail</label>
      <input type="text" name="user[102][mail]" id="user_mail_102" value="bar@mail.com" />
    </p>

and the following parameters will be sent:

    params = {
      :user => {
        "101" => { :name => "Foo", :mail => "foo@mail.com" },
        "102" => { :name => "Bar", :mail => "bar@mail.com" },
      }
    }

So you can define controller action like the following:

    def update
      params[:user].each do |user_id, values|
        user = User.get(ur_id)  or raise NotFound
        user.update_attribute(values)
        ...
      end
    end


Author
------

makoto kuwata <kwa(at)kuwata-lab.com>
copyright(c) 2008 kuwata-lab.com all rights reserved.


License
-------

MIT License