universal-track-manager 0.6.3 → 0.7.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7e8f1a36f7a12f90ea440dfdd54d7797c820ccfdfc47c014832794bdf083426
-  data.tar.gz: cc7cd314a64fa5a6cd3a0fc92bf37014608069f5012cbf2621534ff853c1eb4e
+  metadata.gz: 3d480176796bb905c66f3e4eb2904402232548966be5183768033636b9e50d7b
+  data.tar.gz: 0a7762ea705d448444a4113e254c49ba9e77588a4880197c5244e46388266637
 SHA512:
-  metadata.gz: 90dd0a3aef33513c517df1bf035fc1cdc56664be4ff47d234be8293bf719bed752faa4e24aa0e1501fbf39b8716c051d67132d2b69bd273b29aa9fb0ee0597b4
-  data.tar.gz: f29a7e6975a08d4e8efebe83047f6c01e56e9fe130a3ce9dbc54172e0d7f8a7d39b521d3f0af43619cc8a1ef9625dc3c7c2be56cf23bda65cf04ed3661d9b20e
+  metadata.gz: 99679f236136ab3eed671f2a0319cd01e53ca833589b97fab3e289eaa1fb5647bce188e0d4fbce05c9b5ef9ed0e09f65669e84ac2920c5430fbb1b89f03e0083
+  data.tar.gz: 6997c26bf61ecbcb8e4867a3dfac99158d4b885209248746c364178acd3405698a8e210204d0a619f34c6a0c8fb8ef4badd4f24bb105292a9d5c9dbef47e1bc0

data/lib/generators/templates/create_universal_track_manager_tables.rb

@@ -11,15 +11,11 @@ class CreateUniversalTrackManagerTables < ActiveRecord::Migration<%= migration_v
 
       create_table :campaigns do |t|
         # this table gets automatically populated by inbound traffic
-        t.string :utm_source, limit: 50
-        t.string :utm_medium, limit: 50
-        t.string :utm_campaign, limit: 50
-        t.string :utm_content, limit: 50
-        t.string :utm_term, limit: 50
+#GENERATOR INSERTS CAMPAIGN COLUMNS HERE
         t.timestamps
       end
 
-      add_index :campaigns, [:utm_source, :utm_medium, :utm_campaign, :utm_content, :utm_term], name: "utm_all_combined"
+      #GENERATOR INSERTS CAMPAIGN INDEX HERE
 
       create_table :visits do |t|
         t.datetime :first_pageload

data/lib/generators/templates/universal_track_manager.rb

@@ -2,8 +2,8 @@ UniversalTrackManager.configure do |config|
   config.track_ips = true
   config.track_utms = true
   config.track_user_agent = true
-
+  #GENERATOR INSERTS CAMPAIGN COLUMN CONFIG HERE
 
   # config.track_referrer = false
 
-end
+end

data/lib/generators/universal_track_manager/install_generator.rb

@@ -1,4 +1,7 @@
-require 'rails/generators/active_record'
+
+require 'rails/generators'
+
+require 'byebug'
 
 module UniversalTrackManager
   class InstallGenerator < Rails::Generators::Base
@@ -9,6 +12,7 @@ module UniversalTrackManager
     source_root File.expand_path('../templates', __dir__)
 
     class_option :orm, type: 'boolean'
+    class_option :param_list, type: :string, default: 'utm_source,utm_medium,utm_campaign,utm_content,utm_term'
 
 
     def self.next_migration_number(path)
@@ -17,11 +21,26 @@ module UniversalTrackManager
 
     desc "Creates an initializer for Universal Track Manager and copy files to your application."
     def create_universal_track_manager_migration
-      migration_template "create_universal_track_manager_tables.rb",  "db/migrate/create_universal_track_manager_tables.rb"
+      @params = options['param_list']
+      column_defs = ""
+      @params.split(',').each  do |p|
+        column_defs += "          t.string :#{p}, limit:256\n"
+      end
+
+      index_def = "add_index :campaigns, #{@params.split(',').map{|c| c.to_sym}.to_s}, name: 'utm_all_combined'"
+      copy_file "create_universal_track_manager_tables.rb", "#{self.class.source_root}/create_universal_track_manager_tables.rb-staged"
+      byebug
+      gsub_file "#{self.class.source_root}/create_universal_track_manager_tables.rb-staged", "#GENERATOR INSERTS CAMPAIGN COLUMNS HERE", column_defs
+      byebug
+      gsub_file "#{self.class.source_root}/create_universal_track_manager_tables.rb-staged", "#GENERATOR INSERTS CAMPAIGN INDEX HERE", index_def
+      migration_template "create_universal_track_manager_tables.rb-staged",  "db/migrate/create_universal_track_manager_tables.rb"
     end
 
     def create_universal_track_manager_initializer
-      copy_file 'universal_track_manager.rb', 'config/initializers/universal_track_manager.rb'
+      column_config = "config.campaign_columns = '#{options.param_list}'"
+      copy_file "universal_track_manager.rb", "#{self.class.source_root}/universal_track_manager.rb-staged"
+      gsub_file "#{self.class.source_root}/universal_track_manager.rb-staged", "#GENERATOR INSERTS CAMPAIGN COLUMN CONFIG HERE", column_config
+      copy_file 'universal_track_manager.rb-staged', 'config/initializers/universal_track_manager.rb'
     end
 
     def migration_version

data/lib/universal_track_manager.rb

@@ -4,7 +4,7 @@ module UniversalTrackManager
   require "railtie.rb" if defined?(Rails)
 
   class Settings
-    attr_accessor :track_ips, :track_utms, :track_user_agent, :track_http_referrer
+    attr_accessor :track_ips, :track_utms, :track_user_agent, :track_http_referrer, :campaign_columns
   end
 
   def self.configure(&block)
@@ -13,7 +13,6 @@ module UniversalTrackManager
     block.call(@_settings)
   end
 
-
   def self.track_ips?
     @_settings.track_ips
   end
@@ -29,6 +28,15 @@ module UniversalTrackManager
   def self.track_http_referrer?
     @_settings.track_http_referrer
   end
+
+  def self.campaign_column_names
+    @campaign_column_names ||= @_settings.campaign_columns.split(',')
+  end
+
+    def self.campaign_column_symbols
+    @campaign_column_symbols ||= @_settings.campaign_columns.split(',').map{|c| c.to_sym}
+  end
+
 end
 
 

data/lib/universal_track_manager/controllers/concerns/universal_track_manager_concern.rb

@@ -2,12 +2,21 @@ module UniversalTrackManagerConcern
   extend ActiveSupport::Concern
   attr_accessor :visit_evicted
 
+
+
   included do
     before_action :track_visitor
+
+    UniversalTrackManager.campaign_column_symbols.each do |s|
+      define_method(s) do
+        return nil if ! UniversalTrackManager.track_utms?
+        permitted_utm_params[s]
+      end
+    end
   end
 
   def permitted_utm_params
-    params.permit(:utm_campaign, :utm_source, :utm_term, :utm_content, :utm_medium)
+    params.permit(*(UniversalTrackManager.campaign_column_symbols))
   end
 
 
@@ -21,32 +30,6 @@ module UniversalTrackManagerConcern
     request.user_agent[0..255]
   end
 
-
-  def utm_campaign
-    return nil if ! UniversalTrackManager.track_utms?
-    permitted_utm_params[:utm_campaign]
-  end
-
-  def utm_source
-    return nil if ! UniversalTrackManager.track_utms?
-    permitted_utm_params[:utm_source]
-  end
-
-  def utm_term
-    return nil if ! UniversalTrackManager.track_utms?
-    permitted_utm_params[:utm_term]
-  end
-
-  def utm_content
-    return nil if ! UniversalTrackManager.track_utms?
-    permitted_utm_params[:utm_content]
-  end
-
-  def utm_medium
-    return nil if ! UniversalTrackManager.track_utms?
-    permitted_utm_params[:utm_medium]
-  end
-
   def now
     @now ||= Time.now
   end
@@ -71,11 +54,7 @@ module UniversalTrackManagerConcern
       begin
         existing_visit = UniversalTrackManager::Visit.find(session['visit_id'])
 
-        evict_visit!(existing_visit) if any_utm_params? && !existing_visit.matches_all_utms?({utm_campaign: utm_campaign,
-                                                                        utm_source: utm_source,
-                                                                        utm_term: utm_term,
-                                                                        utm_content: utm_content,
-                                                                        utm_medium: utm_medium})
+        evict_visit!(existing_visit) if any_utm_params? && !existing_visit.matches_all_utms?(permitted_utm_params)
 
         evict_visit!(existing_visit) if existing_visit.ip_v4_address != ip_address
         evict_visit!(existing_visit) if existing_visit.browser && existing_visit.browser.name != user_agent
@@ -92,7 +71,7 @@ module UniversalTrackManagerConcern
 
   def any_utm_params?
     return false if ! UniversalTrackManager.track_utms?
-    [:utm_campaign, :utm_source, :utm_medium, :utm_term, :utm_content].any? do |key|
+    UniversalTrackManager.campaign_column_symbols.any? do |key|
       params[key].present?
     end
   end
@@ -105,11 +84,7 @@ module UniversalTrackManagerConcern
   def find_or_create_campaign_by_current
     return nil if ! UniversalTrackManager.track_utms?
     campaign = UniversalTrackManager::Campaign.find_or_create_by(
-      utm_campaign: utm_campaign,
-      utm_source: utm_source,
-      utm_term: utm_term,
-      utm_content: utm_content,
-      utm_medium: utm_medium
+      *permitted_utm_params
     )
   end
 

data/lib/universal_track_manager/models/visit.rb

@@ -9,16 +9,17 @@ class UniversalTrackManager::Visit < ActiveRecord::Base
     if !campaign
       # this visit has no campaign, which means all UTMs = null
       # if any of the UTMs are present, return false (they don't match null)
-      return ! [:utm_campaign, :utm_source, :utm_medium, :utm_term, :utm_content].any? do |key|
+      return ! UniversalTrackManager.campaign_column_symbols.any? do |key|
         params[key].present?
       end
     end
 
     # note params are allowed to be missing
-    return campaign.utm_campaign == params[:utm_campaign] &&
-      campaign.utm_source == params[:utm_source] &&
-      campaign.utm_medium == params[:utm_medium] &&
-      campaign.utm_term == params[:utm_term] &&
-      campaign.utm_content == params[:utm_content]
+    UniversalTrackManager.campaign_column_symbols.each do |c|
+      if campaign[c] != params[c]
+        return false
+      end
+    end
+    return true
   end
 end

data/lib/version.rb

@@ -1,3 +1,3 @@
 module UniversalTrackManager
-  VERSION = "0.6.3"
+  VERSION = "0.7.0.alpha"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: universal-track-manager
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.7.0.alpha
 platform: ruby
 authors:
 - Jason Fleetwood-Boldt
@@ -28,16 +28,30 @@ dependencies:
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov-rcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: appraisal
   requirement: !ruby/object:Gem::Requirement
@@ -70,11 +84,13 @@ files:
 - lib/universal_track_manager/models/campaign.rb
 - lib/universal_track_manager/models/visit.rb
 - lib/version.rb
-homepage: https://blog.jasonfleetwoodboldt.com/universal-track-manager/
+homepage: https://blog.jasonfleetwoodboldt.com/my-open-source-projects/universal-track-manager/
 licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/jasonfb/universal_track_manager
+  documentation_uri: https://jfb.teachable.com/p/gems-by-jason
+  homepage_uri: https://blog.jasonfleetwoodboldt.com/my-open-source-projects/universal-track-manager/
 post_install_message: |
   ---------------------------------------------
   Welcome to Universal Track Manager
@@ -92,11 +108,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.0.8
+rubygems_version: 3.2.7
 signing_key:
 specification_version: 4
 summary: A gem to track visitors to your website.