Skip to content

Latest commit

 

History

History
49 lines (31 loc) · 2.22 KB

README.markdown

File metadata and controls

49 lines (31 loc) · 2.22 KB

#mq

A Rails gem that generates an MVC stack that does email queuing

What it does

mq is a generator that generates an MVC stack for queuing emails. It has a UI too. I got tired of dealing with crappy email queuing systems in Rails, so I wrote my own.

###Requirements

None.

###How to Install

sudo gem install mq -s http://gemcutter.com

###How to Use

Assuming you'd like to name your mq table Email, and your Mailer model is named Notifier

Generate the files necessary for your app:

./script/generate mq Email Notifier

mq requires your Mailer methods accept an email address as its first parameter, so a Mailer method should look like:

Notifier.send_email_method(email_address)

Of course, you can pass as many parameters as you'd like:

Notifier.send_email_method(email_address, some_object, some_other_object, ...)

Queue an email by calling Email.queue with the name of your Notifier method as the first parameter, and the recipient email address as the second parameter, followed by anything else you'd like to pass.

Email.queue(:send_email_method, "[email protected]")

You can pass multiple email addresses to the Email.queue method and mq will automatically generate individual emails for the recipients.

Email.queue(:send_email_method, ["[email protected]", "[email protected]"], ...)

###Delivery of queued email

You can create a cronjob (this on runs every five minutes)

*/5 * * * * cd /path/to/your/app && ./script/runner/Email.deliver_all

###How to Test

Complete Rspec specs are included automatically. Well, complete aside from view specs as you'll just change the damned things anyway.

About the Author

My name is Matt Darby. I’m an IT Manager and pro-web-dev at for Dynamix Engineering and hold a Master’s Degree in Computer Science from Franklin University in sunny Columbus, OH.

Feel free to check out my site or recommend me