spree -- 促销

spree中的促销用于为订单折扣，以及在不为商品增加额外花费情况下为商品增加额外的功能。促销是spree中最复杂的功能模块之一，因为有大量活动组件需要考虑。虽然本指南将从开发人员的角度说明促销活动，但如果您不熟悉此区域，您可以在后台管理的Admin > Promotions中了解很多，您可以在其中设置新的促销活动，修改规则和操作等。

激活促销的三种方式:

1. 当用户将商品添加入购物车
2. 用户在购物流程中输入一个促销码
3. 用户访问一个页面

这这三种方式一经检查符合条件，就会通过他们相应的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以抵消添加商品增加订单金额的操作。