Module: SendGrid

Defined in:
lib/sendgrid.rb

Defined Under Namespace

Modules: ClassMethods

Constant Summary collapse

VALID_OPTIONS = 
[
  :opentrack,
  :clicktrack,
  :ganalytics,
  :gravatar,
  :subscriptiontrack,
  :footer,
  :spamcheck,
  :bypass_list_management
]
VALID_GANALYTICS_OPTIONS = 
[
  :utm_source,
  :utm_medium,
  :utm_campaign,
  :utm_term,
  :utm_content
]

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object 



24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
 
# File 'lib/sendgrid.rb', line 24

def self.included(base)
  base.class_eval do
    class << self
      attr_accessor :default_sg_category, :default_sg_options, :default_subscriptiontrack_text,
                    :default_footer_text, :default_spamcheck_score, :default_sg_unique_args
    end
    attr_accessor :sg_category, :sg_options, :sg_disabled_options, :sg_recipients, :sg_substitutions,
                  :subscriptiontrack_text, :footer_text, :spamcheck_score, :sg_unique_args
  end

  # NOTE: This commented-out approach may be a "safer" option for Rails 3, but it
  # would cause the headers to get set during delivery, and not when the message is initialized.
  # If base supports register_interceptor (i.e., Rails 3 ActionMailer), use it...
  # if base.respond_to?(:register_interceptor)
  #   base.register_interceptor(SendgridInterceptor)
  # end

  base.extend(ClassMethods)
end

Instance Method Details

#create!(method_name, *parameters) ⇒ Object

Sets the custom X-SMTPAPI header after creating the email but before delivery NOTE: This override is used for Rails 2 ActionMailer classes.



184
185
186
187
188
189
190
191
192
193
 
# File 'lib/sendgrid.rb', line 184

def create!(method_name, *parameters)
  super
  if @sg_substitutions && !@sg_substitutions.empty?
    @sg_substitutions.each do |find, replace|
      raise ArgumentError.new("Array for #{find} is not the same size as the recipient array") if replace.size != @sg_recipients.size
    end
  end
  puts "SendGrid X-SMTPAPI: #{sendgrid_json_headers(mail)}" if Object.const_defined?("SENDGRID_DEBUG_OUTPUT") && SENDGRID_DEBUG_OUTPUT
  @mail['X-SMTPAPI'] = sendgrid_json_headers(mail)
end

#sendgrid_category(category) ⇒ Object

Call within mailer method to override the default value.



100
101
102
 
# File 'lib/sendgrid.rb', line 100

def sendgrid_category(category)
  @sg_category = category
end

#sendgrid_disable(*options) ⇒ Object

Call within mailer method to remove one of the defaults.



116
117
118
119
 
# File 'lib/sendgrid.rb', line 116

def sendgrid_disable(*options)
  @sg_disabled_options = Array.new unless @sg_disabled_options
  options.each { |option| @sg_disabled_options << option if VALID_OPTIONS.include?(option) }
end

#sendgrid_enable(*options) ⇒ Object

Call within mailer method to add an option not in the defaults.



110
111
112
113
 
# File 'lib/sendgrid.rb', line 110

def sendgrid_enable(*options)
  @sg_options = Array.new unless @sg_options
  options.each { |option| @sg_options << option if VALID_OPTIONS.include?(option) }
end

#sendgrid_footer_text(texts) ⇒ Object

Call within mailer method to override the default value.



141
142
143
 
# File 'lib/sendgrid.rb', line 141

def sendgrid_footer_text(texts)
  @footer_text = texts
end

#sendgrid_ganalytics_options(options) ⇒ Object

Call within mailer method to set custom google analytics options sendgrid.com/documentation/appsGoogleAnalytics



152
153
154
155
 
# File 'lib/sendgrid.rb', line 152

def sendgrid_ganalytics_options(options)
  @ganalytics_options = []
  options.each { |option| @ganalytics_options << option if VALID_GANALYTICS_OPTIONS.include?(option[0].to_sym) }
end

#sendgrid_recipients(emails) ⇒ Object

Call within mailer method to add an array of recipients



122
123
124
125
 
# File 'lib/sendgrid.rb', line 122

def sendgrid_recipients(emails)
  @sg_recipients = Array.new unless @sg_recipients
  @sg_recipients = emails
end

#sendgrid_spamcheck_maxscore(score) ⇒ Object

Call within mailer method to override the default value.



146
147
148
 
# File 'lib/sendgrid.rb', line 146

def sendgrid_spamcheck_maxscore(score)
  @spamcheck_score = score
end

#sendgrid_subscriptiontrack_text(texts) ⇒ Object

Call within mailer method to override the default value.



136
137
138
 
# File 'lib/sendgrid.rb', line 136

def sendgrid_subscriptiontrack_text(texts)
  @subscriptiontrack_text = texts
end

#sendgrid_substitute(placeholder, subs) ⇒ Object

Call within mailer method to add an array of substitions NOTE: you must ensure that the length of the substitions equals the

length of the sendgrid_recipients.



130
131
132
133
 
# File 'lib/sendgrid.rb', line 130

def sendgrid_substitute(placeholder, subs)
  @sg_substitutions = Hash.new unless @sg_substitutions
  @sg_substitutions[placeholder] = subs
end

#sendgrid_unique_args(args) ⇒ Object

Call within mailer method to set unique args for this email.



105
106
107
 
# File 'lib/sendgrid.rb', line 105

def sendgrid_unique_args(unique_args = {})
  @sg_unique_args = unique_args
end