README.md

#JQuery Cheats

JQUery cheats is a simple gem that is suppose to make a few things easier within the Rails framework. It is designed to be used with Rails >= 3.0.0 and later will support the asset pipeline requiring Rails >= 3.1.0

##The Asset Pipeline

Because we want to make installing the asset pipeline easier we've provided the following instructions:

1. This gem has a generator to include the needed files run rails g jquery_cheats:asset_pipeline

2. Make sure that your Gemfile has the following lines of code in it:

   group :assets do
     gem 'sass-rails', " ~> 3.1.0"
     gem 'coffee-rails', " ~> 3.1.0"
     gem 'uglifier'
   end
   gem 'jquery-rails'

3. Replace the following:

Bundler.require(:default, Rails.env) if defined?(Bundler)

with:

if defined?(Bundler)
# If you precompile assets before deploying to production, use this line
Bundler.require *Rails.groups(:assets => %w(development test))
# If you want your assets lazily compiled in production, use this line
# Bundler.require(:default, :assets, Rails.env)
end

4.See the rest on RailsCasts

##Functions

Mouse over image, Image1 changes to Image2 when moused over:

<%= mouseoverimage("/path/to/image1.jpg","/path/to/image2.jpg") %>

Submit Image, allows you to use an image instead of a button for a form:

<%= submitimage("/path/to/image.png") %>

This can also be used with an alternate text parameter

<%= submitimage("/path/to/image.png","Image Alt Text") %>

Simple Mouse Over Link, Provide one image and a link and it will provide a mouse over image to that link. The function will look for imagename-hover so make sure your image file is named right

<%= simplemolink("/path/to/imgage.png",link_path) %>

This will try to find /path/to/image-hover.png as the image to use when moused over.

##Ajax Requests for Field Items

The new assetpipline JavaScript makes it possible to submit form elements via data-remote calls when changed. Only the following are supported.

###Select Box

To use ajax with jquery_cheats add data-onchange="true" and data-url="/path/to"

###Radio Button

To use with jquery_cheats simply pass a URL into the data-onchange parameter, if you need to send extra parameters use data-params using a serialized string such as(item=4&item2=3)

<%= f.radio_button "foo", foo_path, "data-onchange"=>"/path" %>

##Graphing

JQuery Cheats works in conjunction with plotSimple to provide you with a graphing interface.

##Change Log

• Version 5.0 removes DOMSubtreeModified due to browser issues. Work around call barChart(id,xmlurl) in your JavaScript