Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
bin
 
 
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Code Climate Test Coverage Build Status

RailsImager

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

Install

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"

Capistrano

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")

Usage

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

rails_imager_p helper method

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) %>

Rounded corners

Makes the corners of an image round.

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

Smart image sizing

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

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

Normal sizing

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

Max sizing

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

Border

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

Caching

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.

License

This project uses MIT-LICENSE.

About

A small library to handle re-sizing, transparent edges and caching of images in Rails.

Resources

License

Packages

No packages published