No commit activity in last 3 years
No release in over 3 years
An ActionMailer courier for Hertz.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 1.0.1
< 6, >= 4.2.0
 Project Readme

Hertz::Email

Build Status Coverage Status Maintainability

This is a Hertz courier for sending email notifications to your users through ActionMailer.

Installation

Add this line to your application's Gemfile:

gem 'hertz-email'

And then execute:

$ bundle

Or install it yourself as:

$ gem install hertz-email

Then, run the installer generator:

$ rails g hertz:email:install

You will also need to expose the hertz_email method in your receiver class. This can be either a single email or an array of emails:

class User < ActiveRecord::Base
  include Hertz::Notifiable

  def hertz_email
    email
  end
end

If #hertz_email returns an empty value (i.e. false, nil, an empty string or an empty array) at the time the job is executed, the notification will not be delivered. This allows you to programmatically enable/disable email notifications for a user:

class User
  include Hertz::Notifiable

  def hertz_email
    email if email_verified?
  end
end

Or even to choose what addresses they can receive emails to:

class User
  include Hertz::Notifiable

  def hertz_email
    emails.select(&:verified?)
  end
end

Usage

In order to use this courier, add :email to #deliver_by in the notification model(s):

class CommentNotification < Hertz::Notification
  deliver_by :email
end

Now, add the #email_subject method in your notification class:

class CommentNotification < Hertz::Notification
  def email_subject
    'You have a new comment!'
  end
end

You may also pass more options to the #mail method of the mailer by defining a #email_options method:

class CommentNotification < Hertz::Notification
  def email_options
    {
      # generate a custom Reply-To address for the receiver
      reply_to: "replies+#{receiver.id}@example.com" 
    }
  end
end

Finally, you should create a template for every notification you send by email. For CommentNotification you'd create a template at app/views/hertz/email/notification_mailer/comment_notification.html.erb:

<p>Hey <%= @notification.receiver.hertz_email %>,</p>
<p>you've got a new comment!</p>

As you can see, templates have access to the @notification instance variable.

NOTE: This courier uses the deliveries API to prevent double deliveries.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/aldesantis/hertz-email.

License

The gem is available as open source under the terms of the MIT License.