Fancier Invoice and Packing Slip V 2.1 for CE Phoenix Cart
==========================================================

Designed for CE Phoenix Cart 1.1.0.6 and PHP 8.2.

What it does
------------

Replaces the standard admin Invoice and Packing Slip displays with matching,
print-friendly versions. No Phoenix core files are edited.

The invoice includes addresses, contact information, product attributes,
tax-exclusive and tax-inclusive prices, totals and a screen-only admin order
history. The packing slip uses the same visual style but contains no prices,
tax totals or payment information.

The invoice screen also provides a watermark selector for PDF documents. Choose
Quotation, Pro-Forma, Payment Due, Paid, Copy or Draft, or enter custom text,
then use Print invoice and select Save as PDF in the browser. The watermark is
placed diagonally near the vertical centre of the invoice, while the selector
itself is never included in the PDF.

Selecting Quotation, Pro-Forma or Draft hides the grey Invoice heading box when
printing and adds a restrained note beneath the header. Quotations display
"This quotation is not a VAT invoice." Pro-Forma and Draft documents display
"This is not a VAT invoice." Their document type is shown by the diagonal
watermark. Payment Due, Paid, Copy, custom and standard invoices retain the
grey Invoice heading box and do not display the non-VAT note.

New installation
----------------

1. Upload the contents of the admin folder to your admin directory,
   preserving the directory structure.

2. Upload the contents of the supplied "catalog" folder to the root of your
   catalog, preserving the directory structure.

3. In the Phoenix admin, open an order and select Invoice or Packing Slip.
   The corresponding fancy document will open automatically.

There is no SQL to run and no existing file needs to be modified.

Upgrading from V2 to V2.1
-------------------------

If Fancier Invoice and Packing Slip V2 is already installed, replace only:

admin/invoice_fancy.php
admin/includes/fancy_document.css
admin/includes/languages/english/invoice_fancy.php

No SQL is required. The packing slip and redirect hook are unchanged.

Upgrading from Fancier Invoice V 1
-----------------------------------

1. Replace admin/invoice_fancy.php with the new version.

2. Upload the new packing slip, language, stylesheet and redirect-hook files.

3. Remove the old hook file:
   catalog/includes/hooks/admin/sitewide/redirectInvoice.php

4. The old V1 installation asked you to append invoice CSS to:
   catalog/templates/override/static/user.css

   Remove everything between these two comments from that file:

   /* --- Invoice Paper Styling Start --- */
   /* --- Invoice Paper Styling Finish --- */

   V 2 uses its own admin/includes/fancy_document.css stylesheet, so the
   catalog user.css file is no longer changed.

Customising the appearance
--------------------------

Edit admin/includes/fancy_document.css. The colour used for the store name and
Print button is #556b2f. All document styles are isolated from the storefront.

Language
--------

All visible text is held in:

admin/includes/languages/english/invoice_fancy.php
admin/includes/languages/english/packingslip_fancy.php

To add another language, copy both files to the corresponding admin language
folder and translate the text on the right-hand side of each constant.

Notes
-----

The invoice number uses the two-digit year from the original order date followed
by the order ID. It therefore remains unchanged when an older invoice is
reprinted.

The customer telephone and countries are read from the historical order record,
not the current customer or countries tables.

The admin order history shown on the invoice is deliberately excluded from
printing so private admin comments cannot accidentally be handed to a customer.

The watermark choice applies only to the invoice currently open in the browser.
It is not stored against the order and returns to None when another invoice is
opened. This prevents a label selected for one customer from being reused by
mistake on a later invoice.

Released under the GNU General Public License.
