=== PDFDraft PDF Invoices for WooCommerce ===
Contributors: WPEverest
Tags: woocommerce, pdf, invoice, order, pdf invoice
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4.0
Stable tag: 1.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Automatically generate and attach customizable PDF invoices to WooCommerce orders using the PDFDraft visual editor.

== Description ==

**PDFDraft PDF Invoices for WooCommerce** extends PDFDraft with WooCommerce invoice generation. Design your invoice template visually using a drag-and-drop PDF builder. No HTML. No CSS. No coding of any kind.

Start from a blank canvas or pick a ready-made template. Add your elements, map in live order data, and save. Every new order gets a PDF invoice attached to the customer email automatically.

**Automatic Invoice Generation and Attachment:**

A PDF invoice is generated every time a new order is placed. It gets attached to the order notification email sent to your customer. No manual steps. No extra setup. It works out of the box.

**Ready-Made Invoice Templates:**

Start with one of four pre-designed templates. Or build from a blank canvas if you prefer full control.

* **Olive** — clean layout with an earthy tone
* **Ivory** — minimal, neutral design
* **Navy** — bold, professional look
* **Pebble** — soft, modern style

**Visual Invoice Editor:**

The editor works like Canva. Drag elements onto your canvas, position them freely, and style everything visually.

* Drag-and-drop canvas with free element positioning
* Snap guides — alignment lines appear as you drag to help line things up
* Pixel indicators — see live distances from the canvas edge to your element
* Layers panel — view and reorder all elements on your canvas
* Pages panel — add pages and preview your full invoice layout
* Zoom slider for close-up editing
* Portrait and landscape orientation support
* Preset paper sizes: Letter, Legal, Tabloid, Executive, Folio, A0–A6, B4, B5
* Custom canvas dimensions

**Available Elements:**

Use any of these elements to build your invoice:

* **Text** — headings, labels, or static copy
* **Image** — store logo or any image
* **Date** — current date or order date
* **Divider** — visual separator between sections
* **Table** — custom static table
* **Shape** — rectangles, lines, and other shapes
* **WP Data Fields** — dynamic WordPress data
* **Data Field** *(WooCommerce)* — dynamic order values via merge tags
* **Order Totals** *(WooCommerce)* — formatted totals table with toggleable rows
* **Product Table** *(WooCommerce)* — order line-item table with toggleable columns

**WooCommerce Fields — Data Field:**

Add a Data Field element to your canvas. Type `/` to browse and insert any order value.

*Order Info:* Order ID, Order Number, Invoice Number, Order Date, Order Status, Transaction ID, Payment Method, Shipping Method, Currency Code

*Billing:* First Name, Last Name, Company, Email, Phone, Address Line 1, Address Line 2, City, State, Postal Code, Country, Full Billing Address

*Shipping:* First Name, Last Name, Company, Address Line 1, Address Line 2, City, State, Postal Code, Country, Full Shipping Address

*Customer:* User ID, Customer Note

*Financials:* Subtotal, Total Tax, Shipping Total, Total Discount, Grand Total, Refunded Amount, Total Due

*Store:* Store Name, Store Address, Store Phone, Store Email, Store Logo

**WooCommerce Fields — Order Totals:**

A formatted totals table. Toggle rows on or off: Subtotal, Discount, Tax, Total. Style options: font, font weight, text color, alignment.

**WooCommerce Fields — Product Table:**

A line-item table of all products in the order. Toggle columns on or off: Product Name, Quantity, Price (Unit Price), Total (Line Total), SKU, Thumbnail.

Header style options: background color, font color, row style (Minimal, Classic, Compact, Invoice Bold, Modern). Body style options: font, font weight, text color, alignment.

**Requirements:**

PDFDraft and WooCommerce must both be installed and active.

== Installation ==

1. Make sure **PDFDraft** and **WooCommerce** are installed and active
2. Upload the `pdfdraft-pdf-invoices-for-woocommerce` folder to `/wp-content/plugins/`
3. Activate the plugin through the **Plugins** menu in WordPress
4. Go to **PDFDraft > Woo Invoices** to open the invoice template editor
5. Start from a blank canvas or choose a ready-made template
6. Design your invoice using the drag-and-drop editor and save

== Frequently Asked Questions ==

= Do I need to know how to code? =

No. The editor is fully visual. You design your invoice by dragging and dropping elements. No HTML or CSS needed.

= Does it come with ready-made invoice templates? =

Yes. Four templates are included: Olive, Ivory, Navy, and Pebble. You can also start from a blank canvas and build from scratch.

= How do I create a WooCommerce invoice template? =

Go to **PDFDraft > Woo Invoices**. Start from a blank canvas or pick a starter template. Design your invoice and save. It applies to all new orders automatically.

= How do I add dynamic order data to my invoice? =

Add a **Data Field** element to your canvas. Type `/` to open the merge tag browser. Select any field to insert it — billing details, shipping address, order totals, store info, and more.

= What paper sizes are supported? =

Letter, Legal, Tabloid, Executive, Folio, A0 through A6, B4, and B5 — in portrait or landscape. Custom dimensions are also supported.

= When are PDF invoices generated? =

A PDF invoice is generated automatically when an order is placed. It attaches to the WooCommerce order notification email.

= Can I use multiple invoice templates? =

Not currently. One invoice template is supported per store.

= Does this work without PDFDraft? =

No. PDFDraft and WooCommerce must both be installed and active.

== Screenshots ==

1. My Templates - List of all created templates.
2. New Template - Template Selection Screen for Woocommerce related Templates.
2. Invoice Editor - Invoice Editor screen showing woocommerce related fields.
2. Settings - PDFDraft Woocomerce Settings page.

== Changelog ==

= 1.0 - 06/04/2026=
* Feature - Initial release

== Upgrade Notice ==

= 0.1.0 =
Initial release.
