Extended Voucher Rules: Configuration
Configure Extended Voucher Rules: the four tabs Extended Rules, Time Windows, Combinations and Min Order Value on the voucher series, with practical examples.
Extended Voucher Rules: Configuration
Live Demo: Try this and other plugins live — no installation, no risk: demo.markus-michalski.net
The module has no module settings of its own. All rules are maintained per voucher series. After activation, every voucher series under Shop Settings > Voucher Series shows four additional tabs: Extended Rules, Time Windows, Combinations and Min Order Value. The tabs are only usable after the series has been saved; for a new series they just show the note to select a voucher series.
A series without configured rules behaves exactly like standard OXID. The module's rules apply in addition to the series' standard rules (validity, user group, minimum order value and so on).
Tab "Extended Rules"
The tab is titled "Extended Voucher Rules" and contains three groups.
| Group / field | Input | Effect |
|---|---|---|
| Payment Restriction / Allowed Payments | Multi-select (Ctrl+click) | Voucher is valid only with the selected payment methods. No selection = all payment methods allowed. |
| Delivery Restriction / Allowed Delivery Methods | Multi-select (Ctrl+click) | Voucher is valid only with the selected delivery methods. No selection = all delivery methods allowed. |
| Additional Rules / First Order Only | Checkbox | Voucher is valid only for customers without a previous, non-cancelled order in this shop. |
| Additional Rules / Max. combinable | Number 0 to 99 | Limits the number of combinable vouchers per order (details below). 0 = unlimited. |
Only active payment methods and active delivery methods are offered. An empty selection removes the restriction, so new payment methods are never locked out by accident.
"Max. combinable" applies to the series of the voucher that is being redeemed. What is counted are the distinct series of the other vouchers already applied, excluding the voucher itself. Several other vouchers of the same series therefore count as one, and reserved vouchers are not counted. The voucher is rejected as soon as this number reaches the limit. With a value of 2, a voucher of this series is rejected if two other series are already applied. The setting of the vouchers already applied is not checked.
Tab "Time Windows"
Title: "Time Window Restriction". The tab lists the existing time windows and offers "Add Time Window".
| Field | Input | Effect |
|---|---|---|
| Weekdays | Checkboxes Monday to Sunday | Days on which the window applies |
| From | Time | Start of the window |
| To | Time | End of the window |
| Active | Checkbox | Switch the window on or off |
If the series has no active time window, there is no time restriction. With at least one active window, the voucher is only valid if the current weekday and time of day match at least one active window. Start and end are part of the window. Existing windows can be deleted in the interface but not edited: to change one, delete it and create it again.
A window whose end is before its start (for example 22:00 to 02:00) never matches. For a period across midnight, create two windows, one until 23:59 and one from 00:00 on the following day. Note: when entered as HH:MM, the window ends at exactly 23:59:00, so the time from 23:59:01 to 23:59:59 is not covered.
Tab "Combinations"
Title: "Combination Rules". Groups: "Blocked Combinations" (existing entries with "Delete") and "Block Combination" (dropdown "Voucher Series" with all other series of the shop).
A blocked combination applies in both directions: if you block series B on series A, B cannot be combined with A either. The entry appears on both series.
The block list only takes effect if the option "Valid with different Series" is set to "Yes" on the series' standard OXID tab. If it is "No", OXID already blocks all combinations. The tab shows this note as well.
Tab "Min Order Value"
Title: "Min Order Value per Payment/Delivery". The tab has two sections, each with the list of existing values, delete and a form to add one.
| Section | Fields |
|---|---|
| Min Order Value per Payment | Payment Method, Min Order Value |
| Min Order Value per Delivery | Delivery Method, Min Order Value |
The values supplement the series' standard minimum order value. A value must be greater than 0, otherwise it is not saved. Saving again for the same payment or delivery method overwrites the existing value. Payment or delivery methods without an entry have no additional minimum order value; however, as soon as at least one entry exists, the voucher stays reserved until a payment or delivery method is selected.
Practical examples
PayPal voucher
Goal: discount only when paying with PayPal.
- Create and save the voucher series.
- Tab Extended Rules: select only the PayPal payment method under "Allowed Payments" and save.
Customer experience: when the customer enters the code in the basket, the voucher is reserved and a hint box appears. As soon as they select PayPal, the discount is applied. If they select another payment method, the voucher stays reserved and the box names the wrong payment method.
Friday happy hour
Goal: discount only on Fridays between 18:00 and 22:00.
- Create and save the voucher series.
- Tab Time Windows: under "Add Time Window" tick only "Friday", From 18:00, To 22:00, tick Active and save.
Outside the window the shop rejects the voucher with the message "This voucher is currently not valid (outside valid time window)."
Stacking protection
Goal: vouchers of different series may only be redeemed together to a limited extent, and the series "SOMMER24" and "WINTER24" must not be redeemed together.
- In both series, enter 2 under "Max. combinable" on the Extended Rules tab. A voucher is then rejected if two other series are already applied.
- In series "SOMMER24", block series "WINTER24" on the Combinations tab.
- In OXID, set "Valid with different Series" to "Yes" on both series.