SHOZI PROFESSIONAL WHMCS PDF INVOICE v2.0.0
================================================

THIS PACKAGE CHANGES THE DOWNLOADED/EMAILED PDF INVOICE ONLY.
It does not contain or modify viewinvoice.tpl, client-area pages, payment buttons,
or gateway behaviour.

FILES
-----
invoicepdf.tpl         Professional WHMCS TCPDF invoice template
invoicepdfheader.tpl   Blank compatibility header (removes old custom header)
invoicepdffooter.tpl   Blank compatibility footer (removes old custom footer)
preview.pdf            Visual example of the intended layout
README.txt             Installation and rollback instructions

INSTALLATION
------------
1. Find the active WHMCS system theme:
   WHMCS Admin > Configuration > System Settings > General Settings > General

2. Back up these current files when they exist:
   /path/to/whmcs/templates/YOUR-ACTIVE-THEME/invoicepdf.tpl
   /path/to/whmcs/templates/YOUR-ACTIVE-THEME/invoicepdfheader.tpl
   /path/to/whmcs/templates/YOUR-ACTIVE-THEME/invoicepdffooter.tpl

3. Upload all three .tpl files from this package to:
   /path/to/whmcs/templates/YOUR-ACTIVE-THEME/

   Uploading the blank header/footer files is important when replacing an older
   custom PDF design, because WHMCS automatically loads those files if present.

4. Make sure the file owner and permissions match the other theme files.
   Typical permissions: 0644

5. Clear the WHMCS template cache:
   Utilities > System > System Cleanup > Empty Template Cache

6. Open an invoice and click Download PDF. Test at least:
   - Paid invoice
   - Unpaid invoice
   - Invoice with tax/credit
   - Invoice with several line items
   - Invoice with a long customer address

LOGO AND COMPANY INFORMATION
----------------------------
The template automatically uses WHMCS data:
- Company name from WHMCS configuration
- Company/Pay To address supplied to invoicepdf.tpl
- Client billing details
- Invoice dates, status, payment method, totals and balance
- Transactions and transaction references
- WHMCS System URL and /submitticket.php support URL

For the PDF logo, WHMCS uses one of these files:
/assets/img/logo.png
/assets/img/logo.jpg
/assets/img/logo.jpeg

Use a transparent PNG for the best result. A wide logo normally works best.
If no logo exists, the configured WHMCS company name is displayed as text.

COLOUR CUSTOMISATION
--------------------
The first section of invoicepdf.tpl contains easy RGB colour variables:
$accentColor, $accentDark, $navyColor, $textColor, $mutedColor,
$lineColor, $softColor, $successBg and $dangerBg.

ROLLBACK
--------
Restore all backed-up invoice PDF template files and clear the WHMCS template cache again.

COMPATIBILITY NOTES
-------------------
- Uses WHMCS's native TCPDF PDF generator.
- Does not require wkhtmltopdf, Chromium, an addon module or a hook.
- Designed for current self-hosted WHMCS installations and standard invoice data.
- Uses fallbacks for old/new transaction reference array keys.
- Does not perform custom invoice database queries.

The included preview is illustrative. Actual content, logo, addresses, line items,
currency, taxes, status and payment transactions come from each WHMCS invoice.
