ahoy_email 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d6c59b97a0029bef3d6070fc62b01b4c6f79b476
-  data.tar.gz: 6cbc7dec76e337280204d5cb420e71a0b20b6a19
+  metadata.gz: 784f96fb14f9b6b23c849aa435ffbbf3acdac543
+  data.tar.gz: 6cc58343026c75ad6536665617838a5b593669ad
 SHA512:
-  metadata.gz: 346a685b5fc9f4a3e743b845eb1d74faf69993e7a04c01ab01a971d4d7045f621c0699f311603f8b0f7d9704ca834cd6d20ecb249d71b55c93079886a96d7e9e
-  data.tar.gz: 4261c2b50159e022b7ec6875b27cfc37006702385771329446664be6cf17c5ba4ae1c9c7e2869b33b5127b76c81957a069c411b9207fd21072efd2a2123ce0ca
+  metadata.gz: a19c3241eeaa13893da620b0eea2d35dda95948a5603591e33067de0805e0daad208929da1d6d6f86b26b1a6c93598e2c51536888d1a0215b93c9d6957651c84
+  data.tar.gz: cc06e0550beaff17574a3f57108cd444584c5d17eb7a91bc7efa8b81f7f2f42fe3cc8937c97110f8b1c09fa4a010cf60977d86c210d83730d7fbcc603c806d2f

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.2.4
+
+- Added `extra` option for extra attributes
+
 ## 0.2.3
 
 - Save utm parameters

data/README.md

@@ -114,6 +114,14 @@ Use `track utm_params: false` to skip tagging, or skip specific links with:
 <a data-skip-utm-params="true" href="...">Break it down</a>
 ```
 
+### Extra Attributes
+
+Create a migration to add extra attributes to the `ahoy_messages` table and use:
+
+```ruby
+track extra: {campaign_id: 1}
+```
+
 ## Customize
 
 ### Tracking
@@ -218,6 +226,12 @@ Use a different model
 AhoyEmail.message_model = UserMessage
 ```
 
+## Upgrading
+
+### 0.2.3
+
+Optionally, you can store UTM parameters by adding `utm_source`, `utm_medium`, and `utm_campaign` columns to your message model.
+
 ## History
 
 View the [changelog](https://github.com/ankane/ahoy_email/blob/master/CHANGELOG.md)

data/lib/ahoy_email/processor.rb

@@ -2,6 +2,8 @@ module AhoyEmail
   class Processor
     attr_reader :message, :mailer, :ahoy_message
 
+    UTM_PARAMETERS = %w(utm_source utm_medium utm_term utm_content utm_campaign)
+
     def initialize(message, mailer = nil)
       @message = message
       @mailer = mailer
@@ -18,13 +20,16 @@ module AhoyEmail
         track_open if options[:open]
         track_links if options[:utm_params] || options[:click]
 
-        ahoy_message.utm_source = options[:utm_source] if ahoy_message.respond_to?(:utm_source=)
-        ahoy_message.utm_medium = options[:utm_medium] if ahoy_message.respond_to?(:utm_medium=)
-        ahoy_message.utm_campaign = options[:utm_campaign] if ahoy_message.respond_to?(:utm_campaign=)
         ahoy_message.mailer = options[:mailer] if ahoy_message.respond_to?(:mailer=)
         ahoy_message.subject = message.subject if ahoy_message.respond_to?(:subject=)
         ahoy_message.content = message.to_s if ahoy_message.respond_to?(:content=)
 
+        UTM_PARAMETERS.each do |k|
+          ahoy_message.send("#{k}=", options[k.to_sym]) if ahoy_message.respond_to?("#{k}=")
+        end
+
+        ahoy_message.assign_attributes(options[:extra] || {})
+
         ahoy_message.save
         message["Ahoy-Message-Id"] = ahoy_message.id.to_s
       end
@@ -98,7 +103,7 @@ module AhoyEmail
           if options[:utm_params] && !skip_attribute?(link, "utm-params")
             uri = Addressable::URI.parse(link["href"])
             params = uri.query_values || {}
-            %w(utm_source utm_medium utm_term utm_content utm_campaign).each do |key|
+            UTM_PARAMETERS.each do |key|
               params[key] ||= options[key.to_sym] if options[key.to_sym]
             end
             uri.query_values = params

data/lib/ahoy_email/version.rb

@@ -1,3 +1,3 @@
 module AhoyEmail
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 end

data/lib/generators/ahoy_email/templates/install.rb

@@ -8,14 +8,17 @@ class <%= migration_class_name %> < ActiveRecord::Migration
       t.integer :user_id
       t.string :user_type
 
-      # optional
-      # feel free to remove
+      # optional - feel free to remove
       t.string :mailer
       t.text :subject
       t.text :content
-      t.string :utm_source
-      t.string :utm_medium
-      t.string :utm_campaign
+
+      # optional
+      # t.string :utm_source
+      # t.string :utm_medium
+      # t.string :utm_term
+      # t.string :utm_content
+      # t.string :utm_campaign
 
       # timestamps
       t.timestamp :sent_at

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ahoy_email
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Andrew Kane
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-23 00:00:00.000000000 Z
+date: 2015-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails