sendgrid 0.0.4 → 0.1.0

data/README.textile

@@ -100,6 +100,22 @@ Here are a list of supported options for sendgrid_enable and sendgrid_disable:
   
 For further explanation see "SendGrid's wiki page on filters.":http://wiki.sendgrid.com/doku.php?id=filters
 
+h3. Delivering to multiple recipients
+
+There is a per-mailer-method setting that can be used to deliver campaigns to multiple recipients at once. You should still set the "recipients" to an address per the normal ActionMailer usage, but it will not be used.
+
+<pre>
+  sendgrid_recipients ["email1@blah.com", "email2@blah.com", "email2@blah.com", ...]
+</pre>
+
+One issue that arises when delivering multiple emails at once is custom content. Luckily, there is also a per-mailer-method setting that can be used to substitute custom content.
+
+<pre>
+  sendgrid_substitue "<subme>", ["sub text for 1st recipient", "sub text for 2nd recipient", "sub text for 3rd recipient", ...]
+</pre>
+
+In this example, if "<subme>" is in the body of your email SendGrid will automatically substitute it for the string corresponding the recipient being delivered to. NOTE: You should ensure that the length of the substitution array is equal to the length of the recipients array.
+
 h3. TODO
 
 * Test coverage (I would appreciate help writing tests).

data/VERSION

@@ -1 +1 @@
-0.0.4
+0.1.0

data/lib/sendgrid.rb

@@ -18,7 +18,7 @@ module SendGrid
         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, :subscriptiontrack_text, :footer_text, :spamcheck_score
+      attr_accessor :sg_category, :sg_options, :sg_disabled_options, :sg_recipients, :sg_substitutions, :subscriptiontrack_text, :footer_text, :spamcheck_score
     end
     base.extend(ClassMethods)
   end
@@ -87,6 +87,20 @@ module SendGrid
     options.each { |option| @sg_disabled_options << option if VALID_OPTIONS.include?(option) }
   end
 
+  # Call within mailer method to add an array of recipients
+  def sendgrid_recipients(emails)
+    @sg_recipients = Array.new unless @sg_recipients
+    @sg_recipients = emails
+  end
+  
+  # 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.
+  def sendgrid_substitute(placeholder, subs)
+    @sg_substitutions = Hash.new unless @sg_substitutions
+    @sg_substitutions[placeholder] = subs
+  end
+
   # Call within mailer method to override the default value.
   def sendgrid_subscriptiontrack_text(texts)
     @subscriptiontrack_text = texts
@@ -125,6 +139,16 @@ module SendGrid
     elsif self.class.default_sg_category
       header_opts[:category] = self.class.default_sg_category
     end
+    
+    # Set multi-recipients
+    if @sg_recipients && !@sg_recipients.empty?
+      header_opts[:to] = @sg_recipients
+    end
+    
+    # Set custom substitions
+    if @sg_substitutions && !@sg_substitutions.empty?
+      header_opts[:sub] = @sg_substitutions
+    end
 
     # Set enables/disables
     header_opts[:filters] = {} unless header_opts.has_key?(:filters)
@@ -140,7 +164,7 @@ module SendGrid
     if !enabled_opts.empty? || (@sg_disabled_options && !@sg_disabled_options.empty?)
       header_opts[:filters] = filters_hash_from_options(enabled_opts, @sg_disabled_options)
     end
-
+    
     header_opts.to_json
   end
   

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: sendgrid
 version: !ruby/object:Gem::Version 
-  version: 0.0.4
+  version: 0.1.0
 platform: ruby
 authors: 
 - Stephen Blankenship
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-10 00:00:00 -07:00
+date: 2009-11-26 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency