WiseInvoiceManager for WHMCS

[1.5.4] - 2025-10-29

Fixed

• Critical: Fixed blank page bug on reload/navigation caused by multiple cascading issues
  • Root cause 1: Null user property access when invoices reference deleted/missing users
  • Root cause 2: Flaky license check causing incomplete page rendering
  • Root cause 3: Empty base URL from WebHelper when license validation fails
  • Root cause 4: JavaScript timing issues and missing DOM elements
• Added null checks for user lookups - displays "Unknown User" gracefully instead of crashing
• Fixed admin username retrieval from adminid session and tbladmins table
• Added adminUsernameData hidden input to pass admin username to JavaScript for backend API calls
• Fixed JavaScript initialization timing by wrapping variable initialization in DOMContentLoaded event
• Added null check for mergeAllButton to prevent errors on pages where it doesn't exist
• Implemented base URL fallback: constructs from https server and http_host server when WebHelper returns empty
• Removed debug error display (display_errors=1) that was corrupting HTML mid-stream

[1.5.3] - 2025-10-29

• Removed redundant CI/CD variables from the pipeline

[1.5.2] - 2025-10-26

• Migrated Sentry integration from wiseinvoicemanager to wshlib for reusability across all WHMCS plugins
• Updated release format to follow Sentry best practices: wiseinvoicemanager@version
• Simplified Sentry initialization to single SentryManager::initialize() call
• Improved CI/CD workflow with dedicated justfile commands for local dev vs CI/CD
• Added use-remote-ci command for automated CI/CD builds with GitLab registry authentication

[1.5.1] - 2025-10-26

• Updated wshlib to include Sentry integration with multi-plugin support
• Added Hub-based architecture for separate DSN routing per plugin
• Maintained full automatic context capture (HTTP, packages, browser, OS, runtime)

[1.5.0] - 2025-10-25

• Converted wshlib from git subtree to Composer path repository dependency, now maintained in separate repository
• Updated logger initialization to use Composer autoloader
• Added initial justfile for streamlined dev workflow

[1.4.2] - 2025-10-24

• Implemented client identification in Sentry error tracking to help identify which admin encountered errors
• Added opt-out setting for user identification in error reports, includes prominent warning about reduced support capabilities to respect user privacy preferences while warning about debugging limitations
• Streamlined version number management to reduce chance of version mismatch between module and error tracking

[1.4.1] - 2025-10-24

• Excluded Smarty related errors from Sentry reporting to reduce noise (Those are WHMCS warnings and are not related to this module)
• Add better error tracking and reporting context to Sentry

[1.4.0] - 2025-10-24

Added

• Added dependency management with Composer
• Added composer.json for dependency definition
• Added composer.lock for version locking
• Integrated Sentry SDK v3.22.1 for error tracking
  • Automatic capture of uncaught exceptions and fatal errors
  • Manual exception capture support via \Sentry\captureException()
  • Environment tagging (staging/production)
  • Release version tracking
  • Web server detection (Apache, nginx, LiteSpeed, etc.)
  • Custom context support with helper functions
• Updated GitLab CI pipeline
  • Automatic Composer dependency installation during build
  • Exclusion of vendor/ directory from IonCube encoding
  • Unencoded vendor/ directory included in final packages
  • Composer files (composer.json, composer.lock) included for reference

Changed

• Build Process modified to support Composer dependencies
• IonCube encoding excludes Composer files and vendor directory
• Final packages include both encoded code and unencoded dependencies

[1.3.2] - 2025-10-11

• Temporarily removed old low quality debug logging from TransferWise API integration

[1.3.1] - 2025-10-10

• Reorganized the codebase to improve maintainability
• Removed redundant files
• Added CHANGELOG.md and populated it with approximately reconstructed version history
• Added README.md with installation and usage instructions
• Bumped version to 1.3.1 to reflect those changes
• Fixed file path for licensing verification in license_lib.php
• Added some logging for license checks and API interactions in Wise Invoice Manager

Note: The changelog below this note (in previous versions) represents an approximation of historical changes based on code analysis. The original project used an X.Y versioning format, but we have transitioned to semantic versioning (X.Y.Z) going forward. Previous versions have been retroactively labeled with ".0" to align with SemVer standards.

[1.3.0] - 2023-10-17

Core Functionality

• Implemented database storage for transfer data
• Added integration with WHMCS DailyCronJob hook
• Implemented manual data refresh via form submission
• Added partial payment processing with custom amounts
• Improved file path handling with dynamic resolution
• Added administrator-triggered manual synchronization
• Implemented PHP version and license status display
• Enhanced API integration with profile type selection
• Added database schema creation on first run

Data Management

• Created dedicated tbl_transferwise_data table for transfer records
• Implemented automatic schema creation if table doesn't exist
• Added unique constraint on transfer_id field to prevent duplicates
• Added bulk data retrieval from API (limit 200 transfers)
• Implemented transfer record storage with multiple fields
• Added database table truncation on settings update
• Implemented profile detection and selection for API access
• Enhanced data storage with account holder information

Performance Improvements

• Implemented database caching system for transfer data
• Optimized API requests with batch processing (limit 200)
• Added record deduplication to prevent duplicate entries
• Combined database storage with browser localStorage
• Added manual data synchronization via form submission
• Implemented redirect-based page refresh for data updates

User Interface

• Added manual refresh button with Font Awesome sync icon
• Added diagnostic footer with system information and license status
• Enhanced empty state handling with standardized SVG graphics
• Added visualization for invoice and transfer matching
• Implemented structured debug information display
• Added empty state detection with custom messaging
• Added visual indicators for various data states
• Improved error handling with user-friendly messages

Architecture

• Implemented database persistence layer for transfer data
• Added integration with WHMCS hook system
• Implemented variable payment amount support via mergeManual.php
• Added POST-based action triggers with redirect pattern
• Improved code organization with separate include files
• Implemented tab-based interface with localStorage persistence
• Added data synchronization via DailyCronJob hook
• Enhanced module configuration with version tracking

[1.2.0] - 2023-10-06

Core Functionality

• Migration from sandbox API to live Wise API
• Enhanced merge functionality with batch and bulk processing
• Improved file permissions handling and validation
• Debug mode with detailed error reporting
• Robust licensing system with validation and local key storage
• Profile type selection (Personal vs Business)
• Version tracking in module configuration

Data Management

• Migrated API endpoints from sandbox to production environment
• Implemented Capsule database queries for configuration storage
• Created configuration table for API settings
• Added profile type selection and detection logic
• Added API response handling for transfer records
• Added transfer account data retrieval functionality

User Interface

• "Merge All" button for bulk operations
• Dynamic page calculation for advanced pagination
• Tab persistence across page reloads
• Hide transfer functionality for workspace customization
• Enhanced payment status visualization
• Context-sensitive bulk action capabilities

JavaScript and Frontend

• Implemented form-based data submission for transactions
• Added pagination with configurable display limits
• Added localStorage persistence for tab selection and hidden items
• Integrated date handling for transfer records
• Added independent search filters for different data sections

[1.1.0] - 2023-09-02

Core Functionality

• Initial version with sandbox Wise API integration
• Tab-based interface with settings, transfers, and matching views
• Comprehensive transfer data handling and display
• Automatic and manual invoice-transfer matching system
• Merge and cancel-merge functionality for invoice payments
• Reference number intelligent parsing and matching
• Multi-currency support with client currency detection
• Configurable API settings with validation

Data Management

• Transaction data retrieval and storage
• Balance information tracking and display
• Transfer state monitoring and status indicators
• Database integration for payment tracking
• Local storage for user preferences and session state
• Data persistence using file-based configuration

Search and Filter

• Text search across transfer and invoice records
• Date-based filtering with daterangepicker integration
• Simple date range selection with format customization
• Separate filters for different data views
• Filter reset functionality when clearing input fields

User Interface

• Tab-based navigation with persistent selection
• Modern styling with Bootstrap integration
• Interactive elements with hover effects
• Empty state handling with SVG graphics
• Basic pagination system for data lists
• Visual connectors between matched transfers and invoices
• Currency display for financial amounts
• Selection highlighting for interactive elements
• Debug information display for administrators
• SVG icons for visual enhancements
• Search filters for different data sections
• Date picker for filtering data by date ranges
• Popup buttons for merge actions
• Styled transaction blocks for different states