Module: ActsAsPurchasable

Extended by:
ActiveSupport::Concern
Defined in:
app/models/concerns/acts_as_purchasable.rb

Defined Under Namespace

Modules: ActiveRecord, ClassMethods

Instance Method Summary collapse

Instance Method Details

#declined!(order = nil, order_item = nil) ⇒ Object



123
124
125
126
# File 'app/models/concerns/acts_as_purchasable.rb', line 123

def declined!(order = nil, order_item = nil)
  after_decline(order, order_item) if self.respond_to?(:after_decline)
  self.save!
end

#is_effectively_purchasable?Boolean

Regular instance methods

Returns:

  • (Boolean)


44
45
46
# File 'app/models/concerns/acts_as_purchasable.rb', line 44

def is_effectively_purchasable?
  true
end

#priceObject



48
49
50
# File 'app/models/concerns/acts_as_purchasable.rb', line 48

def price
  self[:price] || 0
end

#price=(value) ⇒ Object

If I have a column type of Integer, and I’m passed a non-Integer, convert it here



53
54
55
56
57
58
59
60
61
62
63
64
65
# File 'app/models/concerns/acts_as_purchasable.rb', line 53

def price=(value)
  integer_column = ((column_for_attribute('price').try(:type) rescue nil) == :integer) # Rails built in method to lookup datatype

  if integer_column == false
    super
  elsif value.kind_of?(Integer)
    super
  elsif value.kind_of?(String) && !value.include?('.') # Looks like an integer
    super
  else # Could be Float, BigDecimal, or String like 9.99
    super((value.to_f * 100.0).to_i)
  end
end

#purchased!(order = nil, order_item = nil) ⇒ Object



113
114
115
116
117
118
119
120
121
# File 'app/models/concerns/acts_as_purchasable.rb', line 113

def purchased!(order = nil, order_item = nil)
  # begin
  #   self.quantity_purchased = (self.quantity_purchased + 1)
  # rescue
  # end

  after_purchase(order, order_item) if self.respond_to?(:after_purchase)
  self.save!
end

#purchased?Boolean

Returns:

  • (Boolean)


89
90
91
# File 'app/models/concerns/acts_as_purchasable.rb', line 89

def purchased?
  @is_purchased ||= orders.any? { |order| order.purchased? }
end

#purchased_by?(user) ⇒ Boolean

Returns:

  • (Boolean)


93
94
95
# File 'app/models/concerns/acts_as_purchasable.rb', line 93

def purchased_by?(user)
  orders.any? { |order| order.purchased? && order.user_id == user.id }
end

#purchased_download_urlObject

Override me if this is a digital purchase.



129
130
131
# File 'app/models/concerns/acts_as_purchasable.rb', line 129

def purchased_download_url
  false
end

#purchased_ordersObject



97
98
99
# File 'app/models/concerns/acts_as_purchasable.rb', line 97

def purchased_orders
  orders.select { |order| order.purchased? }
end

#quantity_enabled?Boolean

Returns:

  • (Boolean)


101
102
103
# File 'app/models/concerns/acts_as_purchasable.rb', line 101

def quantity_enabled?
  self.respond_to?(:quantity_enabled) ? quantity_enabled == true : false
end

#quantity_remainingObject



105
106
107
# File 'app/models/concerns/acts_as_purchasable.rb', line 105

def quantity_remaining
  (quantity_max - quantity_purchased) rescue 0
end

#sellerObject



83
84
85
86
87
# File 'app/models/concerns/acts_as_purchasable.rb', line 83

def seller
  if EffectiveOrders.stripe_connect_enabled
    raise 'acts_as_purchasable object requires the seller be defined to return the User selling this item.  This is only a requirement when using StripeConnect.'
  end
end

#sold_out?Boolean

Returns:

  • (Boolean)


109
110
111
# File 'app/models/concerns/acts_as_purchasable.rb', line 109

def sold_out?
  quantity_enabled? ? (quantity_remaining == 0) : false
end

#tax_exemptObject



71
72
73
# File 'app/models/concerns/acts_as_purchasable.rb', line 71

def tax_exempt
  self[:tax_exempt] || false
end

#tax_rateObject



75
76
77
78
79
80
81
# File 'app/models/concerns/acts_as_purchasable.rb', line 75

def tax_rate
  @tax_rate ||= (
    self.instance_exec(self, &EffectiveOrders.tax_rate_method).to_f.tap do |rate|
      raise ArgumentError.new("expected EffectiveOrders.tax_rate_method to return a value between 0 and 1. Received #{rate}. Please return 0.05 for 5% tax.") if (rate > 1.0 || rate < 0.0)
    end
  )
end

#titleObject



67
68
69
# File 'app/models/concerns/acts_as_purchasable.rb', line 67

def title
  self[:title] || 'ActsAsPurchasable'
end