Sha256: 09c446566c2040214db9b28da40f068419a06ddb331ffc4585d5c8be09c95272

Contents?: true

Size: 1.87 KB

Versions: 10

Compression:

Stored size: 1.87 KB

Contents

# frozen_string_literal: true

require 'spree/preferences/persistable'

module Spree
  # Base class for all types of promotion action.
  #
  # PromotionActions perform the necessary tasks when a promotion is activated
  # by an event and determined to be eligible.
  class PromotionAction < Spree::Base
    include Spree::Preferences::Persistable
    include Spree::SoftDeletable

    belongs_to :promotion, class_name: 'Spree::Promotion', inverse_of: :promotion_actions, optional: true

    scope :of_type, ->(type) { where(type: Array.wrap(type).map(&:to_s)) }
    scope :shipping, -> { of_type(Spree::Config.environment.promotions.shipping_actions.to_a) }

    # Updates the state of the order or performs some other action depending on
    # the subclass options will contain the payload from the event that
    # activated the promotion. This will include the key :user which allows
    # user based actions to be performed in addition to actions on the order
    #
    # @note This method should be overriden in subclassses.
    def perform(_options = {})
      raise 'perform should be implemented in a sub-class of PromotionAction'
    end

    # Removes the action from an order
    #
    # @note This method should be overriden in subclassses.
    #
    # @param order [Spree::Order] the order to remove the action from
    # @return [void]
    def remove_from(order)
      Spree::Deprecation.warn("#{self.class.name.inspect} does not define #remove_from. The default behavior may be incorrect and will be removed in a future version of Solidus.", caller)
      [order, *order.line_items, *order.shipments].each do |item|
        item.adjustments.each do |adjustment|
          if adjustment.source == self
            item.adjustments.destroy(adjustment)
          end
        end
      end
    end

    def to_partial_path
      "spree/admin/promotions/actions/#{model_name.element}"
    end
  end
end

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
solidus_core-2.11.17 app/models/spree/promotion_action.rb
solidus_core-2.11.16 app/models/spree/promotion_action.rb
solidus_core-2.11.15 app/models/spree/promotion_action.rb
solidus_core-2.11.14 app/models/spree/promotion_action.rb
solidus_core-2.11.13 app/models/spree/promotion_action.rb
solidus_core-2.11.12 app/models/spree/promotion_action.rb
solidus_core-2.11.11 app/models/spree/promotion_action.rb
solidus_core-2.11.10 app/models/spree/promotion_action.rb
solidus_core-2.11.9 app/models/spree/promotion_action.rb
solidus_core-2.11.8 app/models/spree/promotion_action.rb