The following three PageFragment
components are used to render the Gift with Purchase links on the cart page and the gift selection pop-up. The page fragments are stored in the /DCS-CSR-UI/config/
directory:
atg/commerce/custsvc/ui/fragments/gwp
ChangeGiftListPageFragment
– This fragment renders the Change Gift link next to an item when it contains a gift that has multiple choicesSelectGiftLinkPageFragment
– This fragment renders a gift selection link for any gift that has not yet been added to the order. The fragment uses theGiftWithPurchaseSelectionsDroplet
to obtain theGiftWithPurchaseSelection
objects for the current order. AnyGiftWithPurchaseSelection
that is found with aquantityMissingFromOrder
greater than 0 will have a link rendered for it. If thegiftType
iscategory
orcontentGroup
, a selection link is rendered for each unit that is missing from the order. If thegiftType
issku
orproduct
, a single selection is rendered that adds the entire missing quantity to the cartSelectGiftPopupPageFragment
– TheSelectGiftPopupPageFragment
is used to render the gift selection pop-up. It requires several input parameters for determining the gift choices and initializing theGiftWithPurchaseFormHandler
values:itemId
– Indicates which commerce item references the changed gift selection. The value is optionally provided to theGiftWithPurchaseFormHandler
promotionId
– The ID of the promotion. Required by theGiftWithPurchaseFormHandler
quantity
– Required by theGiftWithPurhcaseFormHandler
, this provides the quantity of the gift selectiongiftHashCode
– Required by theGiftWithPurchaseFormHandler
, this identifies the promotion hash codegiftType
– Identifies the gift type, and is required for theGiftWithPurchaseSelectionChoicesDroplet
giftDetail
– Provides gift detail information and is required for theGiftWithPurchaseSelectionChoicesDroplet
For additional information on the GiftWithPurchaseSelectionChoicesDroplet
, refer to the ATG Commerce Programming Guide.
Should the agent proceed with checkout without first selecting eligible gifts for the order, the postMoveToPutchaseInfo
method in the CSRCartModifierFormHandler
will issue a message to inform the agent that the order qualifies for the gifts that are missing from the order.
The Commerce GWPManager
queries all Gift with Purchase selections for the order. If any of them have a quantityMissingFromOrder
greater than 0, an informational message is posted for the agent, such as “This order qualifies for a free gift that has not yet been selected.”
For additional information on Gift with Purchase configuration, refer to the Extending Objects for Cloning section.