spree中的促销用于为订单折扣,以及在不为商品增加额外花费情况下为商品增加额外的功能。促销是spree中最复杂的功能模块之一,因为有大量活动组件需要考虑。虽然本指南将从开发人员的角度说明促销活动,但如果您不熟悉此区域,您可以在后台管理的Admin > Promotions中了解很多,您可以在其中设置新的促销活动,修改规则和操作等。
激活促销的三种方式:
- 当用户将商品添加入购物车
- 用户在购物流程中输入一个促销码
- 用户访问一个页面
这这三种方式一经检查符合条件,就会通过他们相应的PromotionHandler class激活。
Promotions主要设计actions和rules两个组件。当激活促销时,会执行促销的actions,并将来自触发激活器的fire_event调用的payload传递给actions。Rules用来决定一个促销是否符合使用的标准。(
在Spree2.1以及更早的版本中,你需要明确将一个促销关联到一个事件上例如:订单商品改变,购物流程中输入优惠码等。在Spree2.2以后这个不在是必须的event_name列已经被删除了。)
在促销中设置了code或者path的特殊情况,促销仅仅在payload中的code或者path与促销相匹配时才会激活。code属性用于促销码,path属性用于用户访问特定路径才会享受该促销。
一个促销也能够设置最大使用次数。
注意:
基于Path的促销只有Spree::PromotionHandler::Page在spree_frontend的Spree::ContentController中被使用促销才会生效。
Actions
spree提供了四种actions
- An order-level adjustment
- An item-level adjustment
- Create line items
- Create line items
Creating an Adjustment
当一个CreateAdjustment action执行的时候,一个adjustment会自动应用到订单上,除非这个促销已经被使用过。
一旦adjustment被用在订单上,每当订单保存的时候它的合法性都会通过Promotion#eligible? 方法重新检查,其依据是通过Promotion#eligible_rules方法来判断这个促销根据它的规则是否依旧合法。
一个来自促销的应用到订单上的Adjustment依赖calculators。
Creating an item adjustment
当一个CreateItemAdjustments action执行的时候,一个adjustment会自动关联到这个订单范围内相应得商品上,除非已经使用过。
购物车商品更新的时候合法性会重新校验。
Free Shipping
当FreeShipping action 执行的时候,该订单的shipments的价格都将失效(当做0处理)。shipment改变的时候合法性重新校验。
Create Line Items
当一个CreateLineItem action 执行的时候,一系列或许会改变订单金额的line items会自动添加到订单上。具有添加订单项操作的促销还可以有添加adjustment以抵消添加商品增加订单金额的操作。