Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A light wrapper for Sendgrid's SMTP-API
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
spec
.gitignore
Gemfile
Gemfile.lock
History.txt
Manifest.txt
README.markdown
Rakefile

README.markdown

Lattice

WARNING: Lattice is currently under development and is not yet available as a gem. Proceed at your own risk.

Lattice is a small library for interacting with Sendgrid's SMTP API.

Features

The biggest problem that Lattice solves is providing tokens to email templates for per email custom body content. The Sendgrid API allows you to setup an "X-SMTPAPI" email header in the form of a JSON string with tokens and list of substitutions for those tokens along with email recipients and various other keys such as a category for statistics reporting.

About Sendgrid

"SendGrid is a cloud-based email service that delivers email on behalf of companies to increase deliverability and improve customer communications." It is reliable, inexpensive, and it has actionable metrics and statistics that can be viewed through their web console. It is also easy to setup in a rails project.

Installation

Add this to your Gemfile.

gem 'lattice'

Rails 3 Conguration

Add something like this to your environment:

config.action_mailer.default_url_options = { :host => "my-domain.com" }
config.action_mailer.delivery_method = :smtp

credentials = YAML.load_file(Rails.root.join("config", "sendgrid.yml"))

ActionMailer::Base.smtp_settings = {
  :address => "smtp.sendgrid.net",
  :port => '25',
  :domain => "my-domain.com",
  :authentication => :plain,
  :user_name => credentials["user_name"],
  :password => credentials["password"]
}

Usage

In a rails mailer class:

class UserMailer < ActionMailer::Base
  include Lattice

  def welcome(addresses, tokens, ids)
    sendgrid_recipients(addresses)
    sendgrid_category("User Activations")
    sendgrid_substitute(:token).with(tokens).and(:user_id).with(ids)

    mail(:to => "noreply@my-domain.com", "X-SMTPAPI" => x_smtp_api_headers)
  end
end

By including Lattice in your mailer action you have access to the following methods:

  • sendgrid_recipients An array of email addresses

  • sendgrid_category A category string

  • sendgrid_substitute A token name You can also optionally chain additional tokens and substitutions with the "and" method. So you can say substitute any occurance of the token -token- with the values of the given array in order one per email.

  • x_smtp_api_headers

Authors

Robert Pitts (rbxbx) Dave Ott (daveott)

Something went wrong with that request. Please try again.