refer 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e93783086c4e2c9c226868f818915d002d13258e4a1dc024759921b75763fa5e
-  data.tar.gz: 0477c633957d41edad55c6da672b2ca3fcca1b9a87ea2414e65cf0c6309a458a
+  metadata.gz: c2b67d5a90aba044db91c58de5ba63120d31b89e4826545e3589388eae68922a
+  data.tar.gz: bccf49ec61313f94f7cf842920249d0af40bda63dd632fef70694701912b1e63
 SHA512:
-  metadata.gz: 6149724a00b0600711afc17d9a035c3f048134b41873f0b44d036cfdd4fbd787182e31f607397034f2b65279eb6130e9c5702677fa0987e32a98bd284d26c32b
-  data.tar.gz: '0562961b931e111932027ba64bbce8f598ad2a85098ac308a874ec5429549d5e6bfdbfca1c8df00d16a7e9d08e154a8043d4d11ccf1b32ea1920e0b0f2376c4e'
+  metadata.gz: d96dbd8d446574bf29433a558f9b342e385a0af450d2885d37db182960ef3cb1a1fe38d7be0f9eeac7ace6eeb77b7d7117c30f606eb220726764ed6b95ea7b45
+  data.tar.gz: 597c07e84d93b9b6ad2d487a61ad456c20f0b4e687a8fe5b2b6e5184327e11ae79b68b7426acb7d266d047b2b6259d4c9d8f3e583e6f4e97e17ea6ca630028b7

data/README.md

@@ -1,6 +1,6 @@
 # Refer
 
-Referral codes for Ruby on Rails applications.
+Referral codes and affiliate links for Ruby on Rails applications.
 
 ## 📦 Installation
 Add this line to your application's Gemfile:
@@ -14,9 +14,15 @@ And then execute:
 $ bundle
 ```
 
+Add Refer to your controllers to store referral cookies:
+```bash
+bin/rails generate refer:install
+```
+
 And add Refer to your model:
 ```bash
 bin/rails generate refer:model User
+bin/rails db:migrate
 ```
 
 ## 🧑‍💻 Usage
@@ -42,7 +48,7 @@ user.referral_codes.create(code: "chris")
 To customize the referral code generator:
 
 ```ruby
-Refer.code_generator = ->(referrer) { [id, SecureRandom.alphanumeric(8).join("-") }
+Refer.code_generator = ->(referrer) { [id, SecureRandom.alphanumeric(8)].join("-") }
 #=> generates codes like "1-7frb5fUw"
 ```
 
@@ -54,7 +60,15 @@ To track users, we need to stash the referral code in a cookie when present. By
 
 ```ruby
 class ApplicationController < ActionController::Base
-  before_action :set_refer_cookie
+  set_referral_cookie
+end
+```
+
+Move `set_referral_cookie` to specific controllers if you'd only like cookies set in certain areas like marketing pages for example.
+
+```ruby
+class MarketingController < ActionController::Base
+  set_referral_cookie except: [:about_us]
 end
 ```
 

data/app/controllers/concerns/refer/controller.rb

@@ -2,14 +2,22 @@ module Refer
   module Controller
     extend ActiveSupport::Concern
 
-    def set_refer_cookie
-      if (code = params[Refer.param_name])
-        cookies[Refer.cookie_name] = Refer.cookie(code)
+    class_methods do
+      def set_referral_cookie(param_name: Refer.param_name, cookie_name: Refer.cookie_name, **options)
+        before_action -> { set_refer_cookie(param_name: param_name, cookie_name: cookie_name) }, **options
       end
     end
 
-    def refer(referee)
-      Refer.refer(code: cookies[Refer.cookie_name], referee: referee)
+    def refer(referee, cookie_name: Refer.cookie_name)
+      Refer.refer(code: cookies[cookie_name], referee: referee)
+    end
+
+    private
+
+    def set_refer_cookie(param_name: Refer.param_name, cookie_name: Refer.cookie_name)
+      if (code = params[param_name])
+        cookies[cookie_name] = Refer.cookie(code)
+      end
     end
   end
 end

data/db/migrate/20240611180738_create_refer_referrals.rb

@@ -1,4 +1,4 @@
-class CreateReferReferrals < ActiveRecord::Migration[7.2]
+class CreateReferReferrals < ActiveRecord::Migration[6.1]
   def change
     create_table :refer_referrals do |t|
       t.belongs_to :referrer, polymorphic: true, null: false

data/db/migrate/20240611183349_create_refer_referral_codes.rb

@@ -1,4 +1,4 @@
-class CreateReferReferralCodes < ActiveRecord::Migration[7.2]
+class CreateReferReferralCodes < ActiveRecord::Migration[6.1]
   def change
     create_table :refer_referral_codes do |t|
       t.belongs_to :referrer, polymorphic: true, null: false

data/lib/generators/refer/install/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Adds Refer to ApplicationController to set referral cookies
+
+Example:
+    bin/rails generate refer:install
+
+    This will add `sets_refer_cookie` to the ApplicationController class.
+

data/lib/generators/refer/install/install_generator.rb

@@ -0,0 +1,7 @@
+class Refer::InstallGenerator < Rails::Generators::Base
+  source_root File.expand_path("templates", __dir__)
+
+  def add_refer
+    inject_into_class File.join("app", "controllers", "application_controller.rb"), "ApplicationController", "  set_referral_cookie\n"
+  end
+end

data/lib/generators/refer/model/USAGE

@@ -1,8 +1,7 @@
 Description:
-    Explain the generator
+    Adds Refer associations to a model
 
 Example:
-    bin/rails generate model Thing
+    bin/rails generate refer:model User
 
-    This will create:
-        what/will/it/create
+    This will add `has_referrals` to the User class.

data/lib/refer/version.rb

@@ -1,3 +1,3 @@
 module Refer
-  VERSION = "0.1.1"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: refer
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - Chris Oliver
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-12 00:00:00.000000000 Z
+date: 2024-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -24,7 +24,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 6.1.0
-description: Referral codes for Ruby on Rails apps
+description: Referral codes & affiliate links for Ruby on Rails apps
 email:
 - excid3@gmail.com
 executables: []
@@ -43,6 +43,8 @@ files:
 - config/routes.rb
 - db/migrate/20240611180738_create_refer_referrals.rb
 - db/migrate/20240611183349_create_refer_referral_codes.rb
+- lib/generators/refer/install/USAGE
+- lib/generators/refer/install/install_generator.rb
 - lib/generators/refer/model/USAGE
 - lib/generators/refer/model/model_generator.rb
 - lib/refer.rb
@@ -71,8 +73,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.13
 signing_key:
 specification_version: 4
-summary: Referral codes for Ruby on Rails apps
+summary: Referral codes & affiliate links for Ruby on Rails apps
 test_files: []