RailsImager

Generate images on the fly with caching by giving simple parameters to URL's.

First add RailsImager to your gemfile and bundle it:

gem 'rails_imager'

The mount RailsImager in your "routes.rb":

YourApp::Application.routes.draw do
  ...
  mount RailsImager::Engine => "/rails_imager"
  ...
end

Add this to the ApplicationHelper in order to gain access to the rails_imager_p-helper method for generating URL's easy.

module ApplicationHelper
  include RailsImager::ImagesHelper
end

In case you use RailsImager in an engine, you might want to alter the path through an initializer file (config/initializers/rails_imager.rb):

RailsImager.config.path = "/my_engine/rails_imager"

If you use Capistrano to deploy, you probably symlink the "public/system" directory, in order to share uploaded images between releases. This screws with RailsImager's security only to serve images from the "public"-folder.

You can solve this by adding the following initializer in "config/initializers/rails_imager.rb":

# Add public/system to path, because it is symlinked through Capistrano on deployed servers.
RailsImager.config.allowed_paths << File.realpath("#{Rails.public_path.to_s}/system")

Now you can use RailsImager to convert any image located in the public-folder like so:

Usage with a static image in the public folder:

<%= image_tag rails_imager_p("/picture.jpg", :smartsize => 200, :rounded_corners => 10, :border => 1, :border_color => "black") %>

Usage with a Paperclip attachment on a model:

<%= image_tag rails_imager_p(user.picture, :smartsize => 200) %>

Makes the corners of an image round.

http://localhost:3000/rails_imager/images/filename.png?rounded_corners=5

Resize the longest side of an image to have a given size:

http://localhost:3000/rails_imager/images/filename.png?smartsize=200

Resize the given size but keep the aspect of the image:

http://localhost:3000/rails_imager/images/filename.png?width=200

http://localhost:3000/rails_imager/images/filename.png?height=200

Sets the maximum size of an image but keeps the aspect:

http://localhost:3000/rails_imager/images/filename.png?maxwidth=200

http://localhost:3000/rails_imager/images/filename.png?maxheight=200

Give the image a border of a certain size and/or with a certain color.

http://localhost:3000/rails_imager/images/filename.png?border=2&border_color=black

RailsImager performs various forms of caching, to avoid having to do too much work in regards to the actual resizing.

It caches the results as temp-files, so it never has to render the same image with the same parameters again.

It sends out the appropriate headers to the client, so the client doesn't read the same image again and again.

This project uses MIT-LICENSE.