unidom-contact 1.1 → 1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a0388ebeaedab50c13f573c893cd2b2760df9860
-  data.tar.gz: fbec7f5bbbd605149682b1f7aa56a6e5664b8640
+  metadata.gz: e1352769a30dacb2e61ede38eb018a7fb88e9511
+  data.tar.gz: 0ac784280303119e027fa6c95f45ba0f434e60c7
 SHA512:
-  metadata.gz: 484a7df9728f15ee8914fe1765aff14981b01cf684f763d6a99dcb00d51da548fae239bea64c96bb430be5d2bb1ed08fb954b2d801d97152e78b68dee29eb315
-  data.tar.gz: a6a19549b8c82604038a4552375d2a7cfeeabb33014a4bb7e50f8392cb5969eaee7406d01905510a483902c5f9682cf9bbde0d8ca566536fb97f046c98d23bf4
+  metadata.gz: 73d7215db5354e4e43658c0c269e5ef18ac04fbb1aa4a87e8717e7290429d47d94b450719e4247b7c5cbe57f4df6207e190522b422f6f28dce8575076ef2a5bb
+  data.tar.gz: 79d399cbd561687621903b1d341ae4f504039e05e0b5f2790bc5c44d8ca7df45e8e22204a84c730a39892ddcd041e2e856c6113ff87a79c9ec075ae7ffe50524

data/README.md

@@ -45,12 +45,20 @@ Unidom::Contact::EmailAddress.full_address_is('topbit.du@gmail.com').first
 ```ruby
 include Unidom::Contact::Concerns::AsContact
 include Unidom::Contact::Concerns::AsSubscriber
+include Unidom::Contact::Concerns::AsEmailAddressSubscriber
 ```
 
 ### As Contact concern
-The As Contact concern do the following tasks for the includer automatically:
+The As Contact concern do the following tasks for the includer automatically:  
 1. Define the has_many :contact_subscriptions macro as: ``has_many :contact_subscriptions, class_name: 'Unidom::Contact::ContactSubscription', as: :contact``
+2. Define the #subscribe_contact! method as: ``def subscribe_contact!(contact, at: Time.now)``
 
 ### As Subscriber concern
-The As Subscriber concern do the following tasks for the includer automatically:
+The As Subscriber concern do the following tasks for the includer automatically:  
 1. Define the has_many :contact_subscriptions macro as: ``has_many :contact_subscriptions, class_name: 'Unidom::Contact::ContactSubscription', as: :subscriber``
+2. Define the #is_subscribed_as_contact! method as: ``def is_subscribed_as_contact!(by: nil, at: Time.now)``
+
+### As Email Address Subscriber concern
+The As Email Address Subscriber concern do the following tasks for the includer automatically:  
+1. Include the As Subscriber concern
+2. Define the has_many :email_addresses macro as: ``has_many :email_addresses, through: :contact_subscriptions, source: :contact, source_type: 'Unidom::Contact::EmailAddress'``

data/app/models/unidom/contact/concerns/as_contact.rb

@@ -6,6 +6,15 @@ module Unidom::Contact::Concerns::AsContact
 
     has_many :contact_subscriptions, class_name: 'Unidom::Contact::ContactSubscription', as: :contact
 
+    def is_subscribed_as_contact!(by: nil, at: Time.now, name: by.try(:name))
+
+      raise ArgumentError.new('The by argument is required.') if by.blank?
+      raise ArgumentError.new('The at argument is required.') if at.blank?
+
+      contact_subscriptions.create! subscriber: by, opened_at: at, name: name
+
+    end
+
   end
 
 end

data/app/models/unidom/contact/concerns/as_email_address_subscriber.rb

@@ -0,0 +1,13 @@
+module Unidom::Contact::Concerns::AsEmailAddressSubscriber
+
+  extend ActiveSupport::Concern
+
+  include Unidom::Contact::Concerns::AsSubscriber
+
+  included do |includer|
+
+    has_many :email_addresses, through: :contact_subscriptions, source: :contact, source_type: 'Unidom::Contact::EmailAddress'
+
+  end
+
+end

data/app/models/unidom/contact/concerns/as_subscriber.rb

@@ -6,6 +6,15 @@ module Unidom::Contact::Concerns::AsSubscriber
 
     has_many :contact_subscriptions, class_name: 'Unidom::Contact::ContactSubscription', as: :subscriber
 
+    def subscribe_contact!(contact, at: Time.now, name: nil)
+
+      raise ArgumentError.new('The contact argument is required.') if contact.blank?
+      raise ArgumentError.new('The at argument is required.'     ) if at.blank?
+
+      contact_subscriptions.create! contact: contact, opened_at: at, name: name||self.name
+
+    end
+
   end
 
 end

data/lib/unidom/contact/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Contact
-    VERSION = '1.1'.freeze
+    VERSION = '1.2'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-contact
 version: !ruby/object:Gem::Version
-  version: '1.1'
+  version: '1.2'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-14 00:00:00.000000000 Z
+date: 2016-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common
@@ -41,6 +41,7 @@ files:
 - app/controllers/unidom/contact/application_controller.rb
 - app/helpers/unidom/contact/application_helper.rb
 - app/models/unidom/contact/concerns/as_contact.rb
+- app/models/unidom/contact/concerns/as_email_address_subscriber.rb
 - app/models/unidom/contact/concerns/as_subscriber.rb
 - app/models/unidom/contact/contact_subscription.rb
 - app/models/unidom/contact/email_address.rb