The Buy X Items - Get 1 Free module gives the shopper a discount based
on a predetermined qualifying number of items.
In Merchant admin, the
store owner sets the number of items it requires in order for the lowest
priced item to be free. For every increment of that trigger number, an item's value
reduces the total sale. For example, if the number is 5 and the customer
buys 5, the lowest priced item is free. If the customer buys 10, the lowest
two items are free.
When the customer views their basket, the free item discount appears as a separate line item. If they view the basket prior to reaching the trigger level by one, there is a message telling the customer to add one more and the lowest priced item will be free.
In the compiled version you can change the percentage discount from 100% (free)
to a lesser discount of the lowest priced items. You also can change the
message in the basket from the admin configuration panel.
The compiled version of this module can use OpenTokens
instead of hook points within OpenObjects. The
OpenDesigner screen lists the OpenObjects which can
replace all or some screens within the OpenUI user
interface. The OpenObjects provide a template screen
which contains the existing hook points (backward
compatibility), OpenToken capability, and the ability to
move output around within the OpenObject screen. Since
the tokens in this module conform to OpenToken
functionality, they may be used in other template type
screens.