Dead Letter Office

Description

This project implements a Dead letter office (mail recovery center) as an engine for your Rails 3 application. Undeliverable emails which raise exceptions will be logged to the database and can be viewed via a mountable web interface.

Requirements

Supported Platforms

Dead letter office is currently being developed against the following stack:

Ruby

Ruby 1.9.2
Ruby 1.9.3
~~JRuby 1.6+ (1.9 mode)~~ (passes locally, fails on Travis CI)
~~Rubinius 2.0 (1.9 mode)~~ (I am anxiously awaiting passable 1.9 support)

Rails

Rails 3.2.x

It is possible that this may work on older versions of Rails. I do not have any plans to support older versions of Ruby.

Installation

Add dead_letter_office to your Gemfile

gem "dead_letter_office"

Run bundle
Copy the migrations and prepare your databases:

rake dead_letter_office:install:migrations db:migrate db:test:prepare

Mount the web interface in your config/routes.rb file:

namespace :admin do
  mount DeadLetterOffice::Engine => "/dead_letter_office"
end

Using the example above, you may now view the UI at http://lvh.me:3000/admin/dead_letter_office

TODO

add http authentication
retry message delivery
clear all failures
customizable alert notifications

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

License

dead_letter_office

Freely distributable and licensed under the MIT license.
http://phlippers.net/