EDD Invoices 1.3.3

EDD Invoices

EDD Invoices  This Invoices extension allows your customers to generate an invoice for their purchase after the

purchase is complete.

These invoices can include complete company details, such as name, address, and tax ID, that customers can

use for accounting and tax purposes.

This Invoices extension allows your customers to generate an invoice for their purchase after the purchase is complete.

These invoices can include complete company details, such as name, address, and tax ID, that customers can use for

accounting and tax purposes.

Customers will be asked to enter the information they wish to appear on the invoice and will then be given a print friendly

version of the invoice that can be downloaded or printed.

asy Digital Downloads – Invoices 1.2 is a huge release, providing significant extensibility while maintaining backwards compatibility.

The CSS has been simplified and updated.

The new invoices will look slightly different, as the overall appearance and font stack has been modernized, but out of the box, the new invoices should be very similar to the old.

Where version 1.2 really shines is that now, store owners can modify the invoice template. The following template files are now available:

• invoice.php: This is the primary template, and consists only of the basic HTML markup, and some new custom hooks.
• invoice-contacts.php: This template outputs the storefront and customer information.
• invoice-table.php: This template outputs the primary “receipt” of the invoice.
• invoice-additional-info.php: This template includes any custom notes added by the customer, as well as custom notes from the storefront (this is a new setting in 1.2).

EDD Invoices  As with any EDD templates, these can be overridden by copying them to a directory called edd_templates in the active theme folder.

In addition to the templates, EDD Invoices now includes multiple hooks in the invoice so that a store owner can add additional information wherever it’s needed:

• edd_invoices_invoice_head: This hook fires in the head of the HTML output for the invoice. One new feature is that the invoice stylesheet is now output using this hook. The same hook can be used to load an additional custom stylesheet.
• edd_invoices_invoice_header: This hook is used to output the invoice logo (if set), the invoice number, and (new in 1.2) the order status and purchase date.
• edd_invoices_invoice_contacts: The invoice-contacts.php template is loaded in this hook.
• edd_invoices_invoice_items_table: The invoice-table.php template is loaded in this hook.
• edd_invoices_invoice_additional_info: The invoice-additional-info.php template is loaded in this hook.
• edd_invoices_invoice_footer: EDD Invoices adds action buttons (print, back) using this hook. These are not included in the printed version of the invoice.

EDD Invoices  Each hook uses either the order object (in EDD 3.0) or the payment object (EDD 2.x).

EDD Invoices  Some invoice content is output directly in the templates, but some of it requires a bit more logic so 1.2 also introduces some helper functions:

• edd_invoices_get_order_items: This function gets the necessary information for each item in the order: the item ID, the price, the product name, and the price ID. The data is returned to the template as an array.
• edd_invoices_get_order_discounts: This function gets the discounts applied to the order. In EDD 2.9/2.10, the discount code is displayed on the invoice. Because much more specific information is available in 3.0, those invoices will include the amount of each discount, and (for percentage discounts) the discount rate.
• edd_invoices_get_custom_order_meta: This function gets the customer’s notes and/or VAT for the order. It works for the metadata in both EDD 2.x and 3.0.
• edd_invoices_get_order_date: This function gets the order date, which is a different property in EDD 3.0, and requires a little more fallback work for renewal payments in 2.x.