Markus Michalski FAQ

Extended Voucher Rules - OXID eShop 7 Module

Extended voucher rules for OXID eShop 7: payment method, delivery method, first order, time windows, combination blocks and minimum order values per payment and delivery method, with automatic activation at checkout.

Deutsche Version

All OXID 7 Plugins

OXID
PHP

Extended Voucher Rules

Extended voucher rules for OXID eShop 7: voucher series can be bound to payment method, delivery method, first order, weekday and time of day, as well as combination rules and minimum order values per payment and delivery method.

Live Demo: Try this and other plugins live — no installation, no risk: demo.markus-michalski.net

Overview

The Extended Voucher Rules module (module ID mmd_voucherrules, Composer package mmd/oxid7-voucherrules) adds further redemption rules to the voucher series of OXID eShop 7. The rules are maintained on the voucher series in the admin and are checked when a voucher is redeemed in the basket and during checkout.

Vouchers that are bound to a payment method, a delivery method or a payment/delivery-specific minimum order value are not rejected right away. They are kept as "reserved" in the session and applied automatically as soon as the condition is met.

graph TD
    A[Customer enters voucher code] --> B{Payment restriction present?}
    B -->|No| C[Check further rules]
    B -->|Yes| D{Payment selected and allowed?}
    D -->|Yes| C
    D -->|No| E[Voucher reserved and hint shown at checkout]
    C -->|All passed| F[Voucher active, discount applied]
    C -->|Rule violated| G[Error message, voucher rejected]

Rule types

Rule Description
Payment restriction Voucher valid only for selected payment methods
Delivery restriction Voucher valid only for selected delivery methods
First order only Voucher valid only for customers without a previous, non-cancelled order
Time window Validity bound to weekdays and times of day, several windows per series possible
Combinations Block list of voucher series that must not be redeemed together
Max. combinable Limits how many distinct other voucher series may already be applied before a voucher of this series is rejected
Minimum order value per payment method Own minimum order value per payment method
Minimum order value per delivery method Own minimum order value per delivery method

Documentation

Page Content
Installation Requirements, Composer installation, activation, update
Configuration The four tabs on the voucher series, practical examples
Storefront Reserved vouchers, hint box, message texts
Troubleshooting Common problems, known limitations, FAQ
Technical Check order, extended shop classes, database tables

Requirements

Requirement Version Notes
OXID eShop oxid-esales/oxideshop-ce ^7.0 Community Edition as base, Composer installation
PHP >= 8.2
License required Access via Packeton

License

Proprietary - all rights reserved. The license is available at markus-michalski.net.

Support

For questions or issues: support@markus-michalski.net