Changelog

Mikrotik VPN module WHMCS

Order now | Download | Community

v4.1.0 — 2026-09-30

• Resilient Daily Cron & Usage Synchronization. Usage updates and traffic metric collection during WHMCS automation runs are now completely isolated per account with comprehensive diagnostic logging. A temporary connection hiccup or offline router will never interrupt the billing run for your other customers.
• Strict PHP 8.2+ Compatibility & Type Hardening. Resolved typed property assignment issues across package speed and bandwidth configurations, ensuring seamless and crash-free execution on modern PHP 8.1, 8.2, and 8.3 environments.
• Zero-Touch Configuration Auto-Migration. Existing products configured on previous versions automatically upgrade their parameters into the modern unified settings format directly in the database upon editing, eliminating manual reconfiguration.
• Enhanced WHMCS 9 Admin Experience. Refined dynamic module settings detection for Select2 interfaces, providing instant and responsive controls in the WHMCS 9 administrator panel.
• Clean Module Logging. Excluded local database license verification checks (License_Verification (db)) from the WHMCS Module Log, recording exclusively online verification calls to keep diagnostic logs clean.

v4.0.0 — 2026-09-22

• Atomic traffic statistics collection. Replaced read-modify-write logic with atomic SQL increments (Capsule::raw) in StatisticsSaveTraffic(), eliminating race conditions and traffic data loss during concurrent WHMCS cron jobs and metric queries.
• WHMCS Usage Billing MetricProvider fix. Resolved zero-traffic reporting so that Usage(0.0) is reliably returned when usage is 0 GB, preventing "No usage data" statuses in WHMCS.
• Unified interface reset action. Removed redundant resetConnection action and button, standardizing on a single, clean Reset VPN Interface button across admin and client interfaces.
• Admin API connection timeout. Enforced a strict 15-second timeout on router status checks with offline circuit breaker, eliminating admin panel hangs on unreachable Mikrotik routers.
• Guzzle HTTP Client integration. Migrated all external API and license verification requests from legacy cURL to \GuzzleHttp\Client with exponential backoff and retry mechanism.
• ionCube 15 & PHP 8.2+ architectural upgrade. Transitioned hooks.php to an unencoded lightweight bootstrap delegating logic to lib/puqMikrotikVPNHooks.php for seamless ionCube 15 compatibility.
• Automated usage cleanup on termination. Local usage statistics in puqMikrotikVPN_statistics are now automatically purged when a service is terminated.
• Enhanced Client Area UI. Integrated standard PUQ client area UI toolkit with header.tpl, dynamic copy-to-clipboard buttons, toast notifications, CSRF protection, and streamlined responsive layout.
• Legacy configuration fallback. Added transparent backward compatibility for products migrating from older configuration slots (configoption2..11).
• Comprehensive localization. Standardized translation strings across all 26 supported languages with safe typographic apostrophes and full Ukrainian language support.

v3.1.1 (02-06-2026)

• Full support for the latest RouterOS 7.21.4. The module has been verified end-to-end against the newest Mikrotik firmware, so you can confidently run your VPN services on up-to-date, secure routers.
• Rock-solid router communication. Connections to your Mikrotik devices are now even more reliable — requests that could previously stall on certain firmware versions complete instantly, keeping provisioning and management fast and dependable.
• Stay current with peace of mind. Whether you are deploying brand-new routers or upgrading existing ones to the latest RouterOS, your VPN automation keeps working smoothly out of the box.
• PHP 7.4 support is back. The module runs flawlessly on PHP 7.4 once again, so customers on established hosting stacks can keep their proven setup without rushing a server upgrade. We will continue to support PHP 7.4 for as long as it remains technically possible.

v3.1 (20-04-2026)

• Improved stability across the WHMCS admin area. Rare page-loading errors that could appear on some admin screens (for example when opening a support ticket on installations with non-standard file layouts, symlinks or custom hosting paths) have been eliminated. The admin panel now loads smoothly in every environment.
• Greater compatibility with complex hosting setups. The module is now fully resilient to WHMCS installations using symlinked directories, multi-domain hosting and custom include paths.
• Smoother day-to-day operation for administrators. Fewer interruptions, no unexpected "Oops!" pages, and a more predictable experience when working with tickets, clients and services — so your team can focus on customers, not on troubleshooting.

v3.0 (01-02-2026)

• Support for WHMCS 9+
• Redesigned product module settings
• Updated client area interface design
• Remote ability to have traffic-based packages has been removed; instead, a post-paid traffic billing model has been implemented using standard WHMCS metrics

Note: Product reconfiguration is required after update.

v2.2 (23-01-2025)

• The product configuration method has been redesigned
• Added a configuration option in the product settings to display custom HTML in the client panel based on the VPN protocol

Important: After the update, all products using this module must be completely reconfigured.

v2.0 (23-09-2024)

• Module coded with ionCube v13
• Supported PHP versions: 7.4, 8.1, 8.2
• Compatible with WHMCS 8.11.0+
• Client area more adapted for mobile
• Copy-to-clipboard buttons added for login and password

v1.3.5 (11-10-2023)

• Support for WHMCS v8.8.0
• Translations added/updated: Arabic, Azerbaijani, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi, French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Polish, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian

v1.3 (04-02-2023)

• Redesigned client side with intuitive icons
• Improved PHP 8.1 compatibility
• Bug fix: "Attempt to assign property bytes_upload on string" in puqMikrotikVPN.php

v1.2 (04-01-2023)

• Support for WHMCS v8.6
• Support for IonCube PHP Loader v12
• PHP 8.1 support
• Template improvements
• Added configurable frequency for traffic statistics collection (daily cron and per cron)
• Traffic counters on Mikrotik are reset to zero after each statistics collection
• Email template selection changed from text input to dropdown menu

v1.1 (28-10-2022)

• Client area design improvements
• Ukrainian and Persian translations added
• PPP secret profile selection in product settings changed from text input to dropdown

v1.0 (01-08-2022)

• First release