A gem plugin which allows messages prepared by ActionMailer to be delivered asynchronously. Assumes you're using Resque (github.com/defunkt/resque) for your background jobs.
Works in both Rails 2.x and Rails 3.x.
Include Resque::Mailer in your ActionMailer subclass(es) like this:
class MyMailer < ActionMailer::Base include Resque::Mailer end
Now, when MyMailer.deliver_subject_email is called, an entry will be created in the job queue. Your Resque workers will be able to deliver this message for you. The queue we're using is imaginatively named mailer, so just make sure your workers know about it and are loading your environment:
QUEUE=mailer rake environment resque:work
Note that you can still have mail delivered synchronously by using the bang method variant:
Oh, by the way. Don't forget that your async mailer jobs will be processed by a separate worker. This means that you should resist the temptation to pass database-backed objects as parameters in your mailer and instead pass record identifiers. Then, in your delivery method, you can look up the record from the id and use it as needed.
If you want to set a different default queue name for your mailer, you can change the default_queue_name property like so:
# config/initializers/resque_mailer.rb Resque::Mailer.default_queue_name = 'application_specific_mailer'
This is useful when you are running more than one application using resque_mailer in a shared environment. You will need to use the new queue name when starting your workers.
QUEUE=application_specific_mailer rake environment resque:work
Rails 3 Support
Rails 3 has made some changes to the ActionMailer interface. Instead of calling MyMailer.deliver_subject_email(params), you'll want to call MyMailer.subject_email(params).deliver.
You still need to include Resque::Mailer in your mailer as described above. Everything else should work as expected.
Resque::Mailer as a Project Default
If you have a variety of mailers in your application and want all of them to use Resque::Mailer by default, you can subclass ActionMailer::Base and have your other mailers inherit from an AsyncMailer:
# config/initializers/resque_mailer.rb class AsyncMailer < ActionMailer::Base include Resque::Mailer end # app/mailers/example_mailer.rb class ExampleMailer < AsyncMailer def say_hello(user) # ... end end
Install it as a plugin or as a gem plugin from Gemcutter:
gem install resque_mailer script/plugin install git://github.com/zapnap/resque_mailer.git # Rails 2: edit config/environment.rb config.gem 'resque_mailer' # Rails 3: add it to your Gemfile gem 'resque_mailer'
You don't want to be sending actual emails in the test environment, so you can configure the environments that should be excluded like so:
# config/initializers/resque_mailer.rb Resque::Mailer.excluded_environments = [:test, :cucumber]
Note on Patches / Pull Requests
Fork the project.
Make your feature addition or bug fix.
Add tests for it. This is important so I don't break it in a future version unintentionally.
Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
Send me a pull request. Bonus points for topic branches.
This work was inspired by delayed_job_mailer (github.com/andersondias/delayed_job_mailer) by Anderson Dias. Enhanced and modified to work with Resque by Nick Plante.