Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Cache render calls in Rails controllers.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 script
Octocat-spinner-32 spec
Octocat-spinner-32 tasks
Octocat-spinner-32 .gitignore
Octocat-spinner-32 CHANGELOG
Octocat-spinner-32 LICENSE
Octocat-spinner-32 Manifest
Octocat-spinner-32 README
Octocat-spinner-32 Rakefile
Octocat-spinner-32 TODO
Octocat-spinner-32 render-caching.gemspec
README
= Render Caching

Cache render calls in Rails controllers.


== Install

First install the gem.

  gem install ryanb-render-caching --source=http://gems.github.com

Then specify it in your Rails config.

	config.gem 'ryanb-render-caching', :lib => 'render_caching', :source => 'http://gems.github.com'

Rails 2.1 or later required.


== Usage

This gem adds the render_with_cache method to all controllers. Call 
this inside of an action to cache the view.

	def show
	  @user = User.find(params[:id])
	  render_with_cache
	end

This will cache the full rendered contents into a key matching the URL 
path (similar to action caching). You can change this key by simply 
passing any parameter.

	def show
	  @user = User.find(params[:id])
	  render_with_cache @user.cache_key
	end

Cache key is a method supplied by Rails. This includes the updated_at 
time which will give you an auto-expiring cache when the user record is 
updated.

You can also supply a block to the render call which will only get 
executed if there is no cache. Here is a good place to do any custom 
render calls.

	def show
	  @user = User.find(params[:id])
	  render_with_cache @user.cache_key do
	    render :layout => false
	  end
	end


== Development

This project can be found on github at the following URL.

http://github.com/ryanb/render-caching/

If you would like to contribute to this project, please fork the 
repository and send me a pull request.
Something went wrong with that request. Please try again.