sisyphus-rails/README.md

61 lines
1.3 KiB
Markdown
Raw Normal View History

2012-10-01 12:29:36 +00:00
# Sisyphus::Rails
A gem to add gmail like form saving through sisyphus.js
## Installation
Add this line to your application's Gemfile:
gem 'sisyphus-rails'
And then execute:
$ bundle
Or install it yourself as:
$ gem install sisyphus-rails
2012-10-01 20:55:36 +00:00
For a basic install include the following in your *app/assets/javascripts/application.js* file
2012-10-01 14:37:28 +00:00
//= require jstorage
//= require sisyphus
2012-10-01 20:42:14 +00:00
## How it Works
2012-10-01 20:55:36 +00:00
Sisyphus uses an aliased form_tag method to automatically put a *<script>...</script>* tag infront of your forms to initialize Sisyphus
2012-10-01 20:42:14 +00:00
2012-10-01 20:55:36 +00:00
<script>$(document).ready(function() {$('#sampleform').sisyphus();});</script>
<form id="sampleform">
...
</form>
2012-10-01 12:29:36 +00:00
## Usage
2012-10-01 20:42:14 +00:00
Sisyphus automatically works with all your forms, including custom form builders.
### Exclude form
2012-10-01 14:37:28 +00:00
## Dependencies
- Rails >= 3.1
- Jquery
2012-10-01 12:29:36 +00:00
## TODO
- Tests
- Multiple library support for jStorage (Prototype, Mootools etc.)
2012-10-01 14:37:28 +00:00
- Model/Object based exclusions
2012-10-01 12:29:36 +00:00
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
## Dependencies
https://github.com/simsalabim/sisyphus
https://github.com/andris9/jStorage