Repository is archived
No release in over 3 years
Low commit activity in last 3 years
Process your Paperclip attachments in the background using Mongoid and Resque. Loosely based on delayed_paperclip and mongoid-paperclip.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

Mongoid::PaperclipQueue

This repository is archived and now read-only. Other libraries have far surpassed the usefulness of this one.

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.