=== OrderFlow PDF Documents ===
Contributors: digitallychee
Tags: woocommerce, pdf, packing slip, orders, documents
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.3
Stable tag: 1.0.7
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Text Domain: dl-orderflow-pdf-documents
Generates simple PDF packing slips for WooCommerce orders with admin download links.

== Description ==

OrderFlow PDF Documents (free) adds a simple, logo-ready **PDF packing slip** to your WooCommerce store.

Store admins can download a packing slip directly from the order screen (and optionally show it in the customer account area).  
PDFs are generated using a robust FPDI-based engine and stored inside the WordPress uploads folder.

Looking for invoices, credit notes, email attachments, and more advanced options?  
Upgrade to **OrderFlow PDF Documents Pro** for a full suite of professional documents.

### ✅ What the free version includes

* **PDF packing slip** document type
* Download button in the **WooCommerce admin order screen**
* Optional customer download button in the **My Account → Orders** screen
* Optional store logo on documents (with configurable width)
* Store/site address block (name, tagline, URL)
* Multi-line, wrapped product table:
	* Product name
	* Quantity
* PDFs stored in `/wp-content/uploads/orderflow-pdf-documents/`
* Automatic page numbering footer
* HPOS (High-Performance Order Storage) compatible

### 🚫 Free version limitations (available in Pro)

The free version is intentionally focused on a single, simple document:

* Only **Packing Slip** is enabled
* **Invoice** and **Credit Note** are shown as locked (Pro-only)
* **Document labels can’t be renamed** in the free version
* **No email attachments** (admin or customer)
* No test email system

To unlock these, upgrade to **OrderFlow PDF Documents Pro**.

**Get Pro**
Purchase a licence here:
[Buy an Orderflow PDF Documents Pro licence](https://woocommerce.com/products/dl-orderflow-pdf-documents-pro)

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/dl-orderflow-pdf-documents/`
2. Activate the plugin via **Plugins → Installed Plugins**
3. Go to **WooCommerce → OrderFlow PDF Documents** to configure:
	* Set your logo (optional)
	* Confirm packing slip options (columns, visibility, totals)
4. Open an order in WooCommerce admin and use the **Download Packing Slip (PDF)** button in the meta box

== Frequently Asked Questions ==

= Does this plugin support invoices or credit notes? =  
Not in the free version. The **Invoice** and **Credit Note** document types are visible as locked and can’t be enabled.  
For full invoice and credit note support, use **OrderFlow PDF Documents Pro**.

= Can I attach PDFs to WooCommerce emails? =  
No. Email attachments are a Pro-only feature and are disabled in the free version.

= Can customers download the packing slip? =  
Yes — if you enable **Show in customer account** for the Packing Slip, customers will see a button on their order details page.

= Where are PDFs stored? =  
All PDFs are stored inside `/wp-content/uploads/orderflow-pdf-documents/`.

= Does this plugin work with HPOS (High-Performance Order Storage)? =  
Yes, compatibility is declared using WooCommerce’s FeaturesUtil API.

= Can I change the document labels? =  
Not in the free version. Labels like “Packing Slip” are fixed to prevent misuse.  
In Pro, you can fully customise document labels.

= Do I need Composer? =  
The plugin ships with FPDI/FPDF via Composer. You should not need to run Composer yourself unless you’re developing/customising the plugin.

== Screenshots ==

1. Global settings with logo options  
2. Packing slip document settings (invoice and credit note shown as Pro-only)  
3. Download button in WooCommerce order admin  
4. Example generated packing slip

== Changelog ==

= 1.0.7 =
* Minor internal clean-ups and code formatting improvements.
* Upgraded for compatibility with WordPress 7.0.

= 1.0.6 =
* Fix: Resolved issue where PDF downloads could fail with "Invalid document path" error.
* Fix: Corrected settings saving logic to ensure all checkboxes (including document columns and options) persist correctly.
* Improvement: Center-aligned text in document download buttons for improved UI consistency.
* Improvement: Minor code refactoring for consistency in upload directory handling.

= 1.0.5 =
* Minor internal code refactoring.
* Clearer upgrade path to the pro version of the plugin.

= 1.0.4 =
* Simplified the settings screen to focus on the features available in the free version.
* Improved clarity between free and Pro functionality, with a clearer upgrade message.
* Streamlined internal handling of PDF storage and cleanup paths.
* Minor internal refactoring and text consistency improvements.

= 1.0.3 =
* Updated bundled PDF libraries to current stable versions.
* Removed deprecated dependency packages.
* Improved character encoding handling for PDF output.
* Internal refactoring and maintenance improvements.

= 1.0.2 =
* Moved plugin settings into a dedicated WooCommerce → Settings tab for better compatibility with WooCommerce standards.
* Updated settings UI to align with the Pro version for a consistent upgrade path.
* Minor code clean-up and internal improvements (no breaking changes).

= 1.0.1 =
* Minor code cleanup and improved handling of deactivation of the free plugin, when the pro version is activated.

= 1.0.0 =
* Initial public release of free version.
* PDF packing slip with logo and address.
* Admin order meta box download button.
* Optional customer download button.
* HPOS compatibility.
* FPDI-based PDF engine with wrapped tables and page numbers.

== Upgrade Notice ==

= 1.0.7 =
Upgraded for compatibility with WordPress 7.0.