Changelog
v1
Released October 22nd, 2025
Latest Version
Changelog
v1.0.0 - (21.10.2025)
Initial Release
This is the first stable and feature-rich release of BonusVault, designed to be a comprehensive loyalty and bonus system for WHMCS from day one.
Core Features & Functionality:
-
Dual Bonus Modes: Configure bonuses as a Fixed Amount per threshold (e.g., $10 for every $100) or a Percentage of the total top-up amount.
-
Fully Automated System: The entire lifecycle of a bonus is automated – from granting on payment, reserving on new invoices, to final application.
-
Smart Invoice Integration:
- Automatically applies the bonus as a "Discount" line item on newly created invoices.
- Correctly handles both partial and full payments of invoices with bonus funds.
- Properly manages VAT calculations, ensuring the final invoice total is always accurate.
- Intelligently prioritizes the bonus before the client's standard credit balance is used.
- When an invoice is cancelled, the applied bonus is treated like a one-time coupon and is not refunded, protecting your business logic.
-
Configurable Rules: Set minimum deposit amounts and bonus expiration periods (in days, or unlimited) to fit your marketing strategy.
Administrator Panel:
-
Comprehensive Admin Dashboard: Get a bird's-eye view with global statistics for Active, Reserved, Used, and Expired bonuses.
-
Detailed History & Balances: Browse a complete transaction history and a list of all client bonus balances, both with full pagination for improved performance.
-
Unified Client Display: Client names are displayed consistently across the admin panel, prioritizing the company name for clarity.
-
Manual Control: Instantly add or remove bonus funds for any client via an intuitive modal window, with user-friendly feedback messages.
Client Area & User Experience:
-
Modern Client Dashboard: A dedicated page in the client area with a clean, modern interface for clients to track their bonus statistics (Available, Reserved, Used, Expired) and view their full transaction history.
-
Smart Shopping Cart Notice: A dynamic notification appears directly in the shopping cart, informing the client that their available bonus will be applied. This mechanism is designed for high compatibility with various WHMCS themes.
-
Interactive History: Invoice numbers in the client's bonus history are clickable links, leading directly to the relevant invoice for full transparency.
-
Incentives on "Add Funds" Page: The module clearly displays the current bonus rules on the deposit page, encouraging clients to top-up their accounts.
Technical Features:
-
Multi-Currency Ready: All bonus calculations, balances, and displays automatically handle currency conversions.
-
Multi-Language Support: Fully translatable, with Polish and English language packs included out of the box.
-
Professional & Secure Code: Built using WHMCS best practices, including hooks, the WHMCS API, and a secure licensing system.
