Changelog - WHMCS Custom PDF Invoice Addon

[3.0.1] - 2026-08-09

Added

• Added a persistent per-theme registry for the original pre-module invoicepdf.tpl and quotepdf.tpl backups.
• Added automatic restoration of the exact original invoice and quote templates during module deactivation.
• Added rollback backups before deactivation restoration so a failed copy can be recovered safely.
• Added migration discovery for the oldest valid backups created by earlier PDF Invoice releases.
• Added WHMCS child-theme inheritance support for invoice and quote templates, including nested config: parent: chains.
• Added reversible child overrides: activation creates missing local PDF templates while deactivation removes only unchanged module-created overrides so parent inheritance resumes.
• Added a Delete data on deactivation checkbox to WHMCS Addon Modules configuration.

Changed

• Added persistent and immediate image previews for the round-stamp centre, page background, header artwork, footer artwork, PDF logo, and watermark, including selected files before save and refreshed state after AJAX save or removal.
• Connected page background, header artwork, footer artwork, enable controls, and background opacity to the live invoice/quote document preview in both admin themes.
• Moved legacy signature migration and transparency normalization to activation, upgrades, and authenticated addon administration; customer PDF rendering now resolves signature files read-only.
• Expanded design profiles from a fixed 22-field subset to every customer-facing setting in the current schema, including page format, branding assets, watermark, stamp, status seals, signature, artwork, protection, and document content; internal lifecycle state remains excluded.
• Preserved the active profile when an unrelated inactive profile is deleted; Default is selected only when the deleted profile was active.
• Replaced final-HTML translation substitution with context-aware translation at labels, options, navigation, actions, and PDF output points.
• Localized PDF continuation, page numbering, party-card, proposal, subject, additional-information, and terms labels through the synchronized document language catalogue.
• Added optional vector icons for Additional Information and Remittance, controlled independently from the Content tab.
• Improved round-stamp arc fitting and vertical glyph alignment for clearer company and established text.
• Normalized uploaded and drawn signatures to transparent PNG, including safe lazy conversion of existing white-background signatures.
• Extended signature transparency normalization to indexed PNGs and off-white or light-grey scan backgrounds, with soft anti-aliased edges and automatic migration of existing opaque assets.
• Restored the lightweight in-page invoice/quote design prototype so previewing no longer depends on version-specific WHMCS admin PDF endpoints.
• Converted supported addon-page mutations to progressive AJAX actions, including settings and uploads, profiles, asset removal, template installation, defaults, and license verification, with inline progress, accessible notices, normalized UI synchronization, and standard POST fallback.
• Redesigned the Guilloche seal independently from the Classic seal with a complete security-line field, centred uploaded logo, and fitted company/ESTD arcs in the clear band between the second and third outer circles.
• Matched the Guilloche geometry, logo proportions, arc typography, design switching, and AJAX refresh behavior across the admin SVG preview and generated PDFs.
• Added automatic logo-derived stamp colour as the default plus a validated custom-colour override with live preview and AJAX persistence.
• Added automatic invoice-status seals with status-specific circular, banner, hatch, star, and dotted treatments using the configured Paid, Unpaid, Cancelled, Refunded, and Collections colours.

Addon administration interface

• Replaced the legacy administration layout with a full-width professional interface.
• Added a dedicated Dashboard landing tab linked to the addon module URL with module, license, template, document, branding, signature, stamp, and update summaries plus quick actions.
• Added module-scoped custom controls for text fields, text areas, selects, file inputs, buttons, and colour pickers.
• Added automatic WHMCS light and dark theme support.
• Added aligned SVG icons to navigation, actions, notices, upload/remove controls, and status cards.
• Added an operational dashboard for template, branding, watermark, signature, license, and update status.
• Added a responsive invoice/quote design prototype with document switching, representative content, branding, signing, remittance, and live colour updates without remote PDF loading or a new-tab action.
• Added accessible tab navigation and responsive layouts.
• Added vendor logo branding and a copyright footer.

Designer and content controls

• Added font family, base font size, page margin, section spacing, border width, corner radius, and page-number controls.
• Added named design profiles with create, activate, update, and delete operations.
• Added configurable invoice title, tax identifier, tagline, company phone, and company fax values.
• Moved editable invoice identity values away from the former InvoiceVar.php editing workflow and into addon settings.
• Added configurable header and footer text.
• Added invoice-specific and quote-specific custom content.
• Added optional introductory and closing PDF pages.
• Added safe shortcodes for company, invoice, quote, date, total, and related document data.
• Added conditional content blocks for invoice, quote, paid, unpaid, and status-specific output.
• Added default content and a restore-content-defaults action.
• Corrected spacing around shortcode help and restore controls.

Branding and uploaded artwork

• Added custom PDF logo upload, preview, enable/disable, and removal for invoices and quotes.
• Added drawn or uploaded authorised signatures with preview and removal controls.
• Added styled text signatures with live preview, ten professional font treatments, adjustable sizing, and bold, italic, and underline effects shared by invoices and quotes.
• Added left, centre, and right signature placement; horizontal and vertical fine adjustment; straight and tilted image presets; and solid, dashed, dotted, double, or hidden signature baselines.
• Added optional authority details beneath signatures, including a configurable designation and the current WHMCS company name.
• Updated live and saved signature previews to show the complete PDF signing block, including baseline, signatory label, optional designation, and WHMCS company name.
• Added an optional protected round-stamp upload with adjustable PDF size and left-side signing-area placement.
• Added text and image watermarks with configurable opacity.
• Added page background, header image, and footer image uploads.
• Added image validation using upload state, size, detected format, dimensions, GD decoding, and safe re-encoding.
• Moved uploaded artwork from public addon directories to protected WHMCS attachments storage.
• Added migration and cleanup of recognized legacy public assets.
• Preserved image aspect ratios and corrected signature alignment in both document types.

Invoice and quote PDF design

• Rebuilt invoice and quote templates with a consistent professional visual system.
• Added compact typography, restrained borders, rounded cards, aligned information panels, improved totals, and professional remittance sections.
• Added flow-based layouts that prefer a single page while allowing clean multi-page continuation.
• Prevented one-page footer and “Page 1 of 1” content from being pushed onto an unnecessary second page.
• Added consistent signature, remittance, totals, notes, branding, and footer presentation.
• Removed the “Secure client payment link” text.
• Removed gateway hash/token output that appeared below payment methods.
• Added shared deterministic TCPDF rendering helpers for invoice and quote documents.
• Added background artwork, header/footer artwork, watermarks, additional pages, shortcodes, and RTL behavior to both invoice and quote output.
• Changed invoice and quote watermarks from a final overlay pass to a page-creation underlay, including additional and continuation pages, so document text remains fully readable.
• Improved professional table borders and reduced heavy nested-box styling.

Template installation and backups

• Added automatic detection of the active WHMCS client template.
• Added automatic invoice and quote template installation during activation.
• Added a manual Install latest templates action on the addon page.
• Added unique timestamped and cryptographically random backup names for every installation.
• Preserved earlier backups rather than overwriting a fixed backup file.
• Added path-boundary, source, target, permissions, and rollback checks.
• Added migration of legacy fixed-name template backups.

Localization and RTL

• Added every WHMCS-supported addon language included by the module: Arabic, Azerbaijani, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi, French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Portuguese (Brazil), Portuguese (Portugal), Russian, Spanish, Swedish, Turkish, and Ukrainian.
• Added English as the complete canonical addon and document key catalogue.
• Added automatic per-key English fallback while preserving native translations.
• Added localized notices, errors, buttons, license messages, content controls, and operational status text.
• Added automatic client-language selection and forced-language selection.
• Added automatic and manual LTR/RTL direction support.
• Added module identity placeholders so the product name, vendor, license prefix, and PHP requirement remain authoritative PHP values rather than editable translations.

[v2.1]

Fixed

• Issue with licensing system for WHMCS v8.6

[v2.0]

Added

• Support for WHMCS v8.6
• Support for PHP 7.4 & PHP 8.1
• Requires IonCube Loader v12

[v1.0]

Added

• Support for WHMCS v7.5.x
• Support for PHP 5.6 / 7.0 / 7.1 / 7.2
• Requires IonCube Loader v10.2