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
]

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object 



16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
 
# File 'lib/sendgrid.rb', line 16

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
    end
    attr_accessor :sg_category, :sg_options, :sg_disabled_options, :sg_recipients, :sg_substitutions, :subscriptiontrack_text, :footer_text, :spamcheck_score
  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.



164
165
166
167
168
169
170
171
172
173
 
# File 'lib/sendgrid.rb', line 164

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.



89
90
91
92
93
94
 
# File 'lib/sendgrid.rb', line 89

def sendgrid_category(category)
  if category.length > 0 && (!@sg_category || @sg_category.length < 1)
    @sg_category = []
  end
  @sg_category.push(category)
end

#sendgrid_disable(*options) ⇒ Object

Call within mailer method to remove one of the defaults.



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

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.



97
98
99
100
 
# File 'lib/sendgrid.rb', line 97

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.



128
129
130
 
# File 'lib/sendgrid.rb', line 128

def sendgrid_footer_text(texts)
  @footer_text = texts
end

#sendgrid_recipients(emails) ⇒ Object

Call within mailer method to add an array of recipients



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

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.



133
134
135
 
# File 'lib/sendgrid.rb', line 133

def sendgrid_spamcheck_maxscore(score)
  @spamcheck_score = score
end

#sendgrid_subscriptiontrack_text(texts) ⇒ Object

Call within mailer method to override the default value.



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

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.



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

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.



138
139
140
 
# File 'lib/sendgrid.rb', line 138

def sendgrid_unique_args(args)
  @sg_unique_args = args
end