149 lines
6.1 KiB
Markdown
149 lines
6.1 KiB
Markdown
# Change History / Release Notes
|
|
|
|
## Version 1.1.1
|
|
|
|
* added the to be added/deleted element to the event, this allows to add animations/actions onto them
|
|
* added extra option :wrap_object, allowing to use Decorators instead of the association object
|
|
* added an option :force_non_association_create, that will allow to use `link_to_add_association` inside the fields-partial
|
|
|
|
## Version 1.1.0
|
|
|
|
* BREAKING: the triggered javascript events `removal-callback`, `after-removal-callback`, and `insertion-callback` are renamed to the more correct and symmetric
|
|
`cocoon:after-insert, cocoon:before-insert, cocoon:after-remove, cocoon:before-remove`. Also the events are namespaced to prevent collisions with other libraries.
|
|
* allow created objects to be decorated with a callable. This is especially useful if you are using Draper or some decorator instead of the plain model in your views.
|
|
* it is now possible to specify a relative node, and use standard jquery traversal methods on insertion
|
|
* trigger insertion event on correct `insertionNode`
|
|
* thanks to #90 cocoon now supports non-AR associations and array-fields, you just have to supply your own `build_<association>` methods
|
|
|
|
I would really really like to thank all contributors, check them out https://github.com/nathanvda/cocoon/graphs/contributors
|
|
They made cocoon way more awesome than I could have done in my lonesome.
|
|
|
|
## Version 1.0.22
|
|
|
|
* Fix that it still works for mongoid
|
|
|
|
## Version 1.0.21
|
|
|
|
* Use association build methods instead of assoc.klass.new. This avoids mass-assignment errors and other misbehaviors around attribute accessibility.
|
|
|
|
|
|
## Version 1.0.20
|
|
|
|
* improved handing of the `:partial`: remove the extra options-hash, and just make it use the single hash, so now we can just write
|
|
|
|
= link_to_add_association 'add something', f, :tasks, :partial => 'shared/task_fields'
|
|
= link_to_add_association 'add something', f, :tasks, :class => 'your-special-class', :partial => 'shared/task_fields'
|
|
|
|
|
|
## Version 1.0.19
|
|
|
|
* pull #53 (@CuriousCurmudgeon): fixed some bugs introduced in previous version (ooooops! Thanks!!!)
|
|
|
|
## Version 1.0.18
|
|
|
|
* pull in #51 (@erwin): adding an `after-removal-callback` in javascript, very useful if you want to recalculate e.g. total-items or indexes
|
|
* pull in #42 (@zacstewart): allow to hand extra `:locals` to the partial
|
|
* updated documentation
|
|
|
|
## Version 1.0.17
|
|
|
|
* fix: make sure that cocoon still works for rails 3.0, where the `conditions` is not available yet
|
|
|
|
## Version 1.0.16
|
|
|
|
* merged pull request #33 (@fl00r): added the a custom partial option! genius :)
|
|
Also the creation of the nested objects takes any available conditions into account.
|
|
Now you can write
|
|
|
|
= link_to_add_association 'add something', f, :tasks, {}, :partial => 'shared/task_fields'
|
|
|
|
## Version 1.0.15
|
|
|
|
* added `data-association-insertion-method` that gives more control over where to insert the new nested fields.
|
|
It takes a jquery method as parameter that inserts the new data. `before`, `after`, `append`, `prepend`, etc. Default: `before`.
|
|
* `data-association-insertion-position` is still available and acts as an alias. Probably this will be deprecated in the future.
|
|
|
|
|
|
## Version 1.0.14
|
|
|
|
* When playing with `simple_form` and `twitter-bootstrap`, I noticed it is crucial that I call the correct nested-fields function.
|
|
That is: `fields_for` for standard forms, `semantic_fields_for` in formtastic and `simple_fields_for` for simple_form.
|
|
Secondly, this was not enough, I needed to be able to hand down options to that method. So in the `link_to_add_association` method you
|
|
can now an extra option `:render_options` and that hash will be handed to the association-builder.
|
|
|
|
This allows the nested fields to be built correctly with `simple_form` for `twitter-bootstrap`.
|
|
|
|
## Version 1.0.13
|
|
|
|
* A while ago we added the option to add a javascript callback on inserting a new associated object, I now made sure we can add a callback on insertion
|
|
and on removal of a new item. One example where this was useful for me is visible in the demo project `cocoon_simple_form_demo` where I implemented a
|
|
`belongs_to` relation, and either select from a list, or add a new element.
|
|
So: the callback-mechanism has changed, and now the callback is bound to the parent container, instead of the link itself. This is because we can also
|
|
bind the removal callback there (as the removal link is inserted in the html dynamically).
|
|
|
|
For more info, see the `README`.
|
|
|
|
## Version 1.0.12
|
|
|
|
* using "this" in `association-insertion-node` is now possible
|
|
|
|
If you are using rails < 3.1, you should run
|
|
|
|
rails g cocoon:install
|
|
|
|
to install the new `cocoon.js` to your `public/javascripts` folder.
|
|
|
|
|
|
## Version 1.0.11
|
|
|
|
|
|
## Version 1.0.10
|
|
|
|
* Fuck! Built the gem with 1.9.2 again. Built the gem again with 1.8.7.
|
|
|
|
## Version 1.0.9
|
|
|
|
* is now rails 3.1 compatible. If you are not using Rails 3.1 yet, this should have no effect.
|
|
For rails 3.1 the cocoon.js no longer needs to be installed using the `rails g cocoon:install`. It is
|
|
automatically used from the gem.
|
|
|
|
## Version 1.0.8
|
|
|
|
* Loosened the gem dependencies.
|
|
|
|
## Version 1.0.7 (20/06/2011)
|
|
|
|
Apparently, the gem 1.0.6 which was generated with ruby 1.9.2 gave the following error upon install:
|
|
|
|
uninitialized constant Psych::Syck (NameError)
|
|
|
|
This is related to this bug: http://rubyforge.org/tracker/?group_id=126&atid=575&func=detail&aid=29163
|
|
|
|
This should be fixed in the next release of rubygems, the fix should be to build the gem with ruby 1.8.7.
|
|
Let's hope this works.
|
|
|
|
## Version 1.0.6 (19/06/2011)
|
|
|
|
* The javascript has been improved to consistently use `e.preventDefault` instead of returning false.
|
|
|
|
Run
|
|
|
|
rails g cocoon:install
|
|
|
|
to copy the new `cocoon.js` to your `public/javascripts` folder.
|
|
|
|
|
|
## Version 1.0.5 (17/06/2011)
|
|
|
|
* This release make sure that the `link_to_add_association` generates a correctly clickable
|
|
link in the newer rails 3 versions as well. In rails 3.0.8. the html was double escaped.
|
|
|
|
If you are upgrading from 1.0.4, you just have to update the gem. No other actions needed. If you are updating
|
|
from earlier versions, it is safer to do
|
|
|
|
rails g cocoon:install
|
|
|
|
This will copy the new `cocoon.js` files to your `public/javascripts` folder.
|
|
|
|
|