Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Process your Paperclip attachments in the background using Mongoid and Resque.
Ruby
branch: master

This branch is 1 commit ahead, 5 commits behind kellym:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
rails
test
.gitignore
.project
.rvmrc
CONTRIBUTING
Gemfile
LICENSE
README.textile
mongoid_paperclip_queue.gemspec

README.textile

Mongoid::PaperclipQueue

Mongoid::PaperclipQueue is a complete rewrite of Delayed_Paperclip and Mongoid_Paperclip to allow those of us using Mongoid to process Paperclip attachments in the background using Resque.

Why?

We all know how important it is to keep our page load times down, so this allows us to dump all that processing to Resque to perform in the background.

Installation

Install the gem:

sudo gem install mongoid_paperclip_queue

Or for Rails 3, to your Gemfile:

gem 'mongoid_paperclip_queue'

Dependencies:

  • Mongoid
  • Paperclip
  • Resque

You don’t need to include paperclip in your Gemfile.

Usage

In your model:


  class User 
    include Mongoid::Document
    extend Mongoid::PaperclipQueue

    has_queued_attached_file :avatar, :styles => { :medium => "300x300>", :thumb => "100x100>" }

  end

  # You can also embed attachments, too.
  class Team 
	include Mongoid::Document

	embeds_many :users, :cascade_callbacks => true # this will save all the attachments when Team is saved.
  end

  

Paperclip will behave exactly like they describe.

Resque

Make sure that you have Resque up and running. The jobs will be dispatched to the :paperclip queue, so you can correctly dispatch your worker. Configure resque and your workers exactly as you would otherwise.

Detect the processing state

Processing detection is built in. We take advantage of Redis since it should already be running, and we can keep our #{attachment_name}_processing field out of our MongoDB and into a more temporary key store. The temporary image url isn’t saved anywhere, so you’ll have to specify that on your own, but it’s easy to use:


  @user = User.find(1)
  url = @user.avatar.processing? ? "/images/missing.png" : @user.avatar.url

Contributing

Checkout out CONTRIBUTING for more info.

Something went wrong with that request. Please try again.