Module: Roda::RodaPlugins::Mailer

Defined in:

lib/roda/plugins/mailer.rb

Overview

The mailer plugin allows your Roda application to send emails easily.

class App < Roda
  plugin :render
  plugin :mailer

  route do |r|
    r.on "albums" do
      r.mail "added" do |album|
        @album = album
        from 'from@example.com'
        to 'to@example.com'
        cc 'cc@example.com'
        bcc 'bcc@example.com'
        subject 'Album Added'
        add_file "path/to/album_added_img.jpg"
        render(:albums_added_email) # body
      end
    end
  end
end

The default method for sending a mail is sendmail:

App.sendmail("/albums/added", Album[1])

If you want to return the Mail::Message instance for further modification, you can just use the mail method:

mail = App.mail("/albums/added", Album[1])
mail.from 'from2@example.com'
mail.deliver

The mailer plugin uses the mail gem, so if you want to configure how email is sent, you can use Mail.defaults (see the mail gem documentation for more details):

Mail.defaults do
  delivery_method :smtp, :address=>'smtp.example.com', :port=>587
end

You can support multipart emails using text_part and html_part:

r.mail "added" do |album_added|
  from 'from@example.com'
  to 'to@example.com'
  subject 'Album Added'
  text_part render('album_added.txt')  # views/album_added.txt.erb
  html_part render('album_added.html') # views/album_added.html.erb
end

In addition to allowing you to use Roda’s render plugin for rendering email bodies, you can use all of Roda’s usual routing tree features to DRY up your code:

r.on "albums/:d" do |album_id|
  @album = Album[album_id.to_i]
  from 'from@example.com'
  to 'to@example.com'

  r.mail "added" do
    subject 'Album Added'
    render(:albums_added_email)
  end

  r.mail "deleted" do
    subject 'Album Deleted'
    render(:albums_deleted_email)
  end
end

When sending a mail via mail or sendmail, a RodaError will be raised if the mail object does not have a body. This is similar to the 404 status that Roda uses by default for web requests that don’t have a body. If you want to specifically send an email with an empty body, you can use the explicit empty string:

r.mail do
  from 'from@example.com'
  to 'to@example.com'
  subject 'No Body Here'
  ""
end

If while preparing the email you figure out you don’t want to send an email, call no_mail!:

r.mail '/welcome/:d' do |id| 
  no_mail! unless user = User[id]
  # ...
end

By default, the mailer uses text/plain as the Content-Type for emails. You can override the default by specifying a :content_type option when loading the plugin:

plugin :mailer, :content_type=>'text/html'

The mailer plugin does support being used inside a Roda application that is handling web requests, where the routing block for mails and web requests is shared. However, it’s recommended that you create a separate Roda application for emails. This can be a subclass of your main Roda application if you want your helper methods to automatically be available in your email views.

Defined Under Namespace

Modules: ClassMethods, InstanceMethods, RequestMethods, ResponseMethods Classes: Error

Constant Summary

REQUEST_METHOD =

"REQUEST_METHOD".freeze

PATH_INFO =

"PATH_INFO".freeze

SCRIPT_NAME =

'SCRIPT_NAME'.freeze

EMPTY_STRING =

''.freeze

RACK_INPUT =

'rack.input'.freeze

RODA_MAIL =

'roda.mail'.freeze

RODA_MAIL_ARGS =

'roda.mail_args'.freeze

MAIL =

"MAIL".freeze

CONTENT_TYPE =

'Content-Type'.freeze

TEXT_PLAIN =

"text/plain".freeze

OPTS =

{}.freeze

Class Method Summary

• .configure(app, opts = OPTS) ⇒ Object

  Set the options for the mailer.

Class Method Details

.configure(app, opts = OPTS) ⇒ Object

Set the options for the mailer. Options:

:content_type

The default content type for emails (default: text/plain)

# File 'lib/roda/plugins/mailer.rb', line 131

def self.configure(app, opts=OPTS)
  app.opts[:mailer] = (app.opts[:mailer]||{}).merge(opts).freeze
end