=== Ni WooCommerce Invoice - PDF Invoices for WooCommerce Orders ===
Contributors: anzia
Tags: pdf invoice, woocommerce invoice, invoice, order invoice, invoice number
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
WC requires at least: 5.0
WC tested up to: 11.2
Stable tag: 1.6.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Create professional PDF invoices for WooCommerce orders with your logo, signature, brand color, sequential invoice numbers and order filters.

== Description ==

**Ni WooCommerce Invoice** creates clean, professional **PDF invoices for WooCommerce orders** in one click. Open the order list, find the order and click the PDF icon to download its invoice.

Add your **store logo**, an **authorised signature** and your **brand color**, choose **sequential invoice numbers** with a prefix and suffix such as INV-0001/2026, and add footer notes like bank details, a thank-you message or your GST / VAT number. Every invoice shows billing and shipping addresses, products with SKU and variation details, discounts, fees, shipping, tax, refunds and the order total.

The plugin is free, works with **WooCommerce High-Performance Order Storage (HPOS)** and runs on PHP 7.4 to 8.2.

= Who is it for? =

* Stores that need a **printable PDF invoice** for every WooCommerce order, for customers, accounts or tax records.
* Businesses that need **sequential invoice numbers** with no gaps, a year in the number, or their own prefix.
* B2B, wholesale and **GST / VAT registered** stores that print a tax number, bank details and an authorised signature on each invoice.

= PDF invoice features =

* **One-click PDF invoice download** – a PDF button on every order in the order list.
* **Modern invoice design** – header with logo and store name, a Paid / Due badge, Bill To and Ship To blocks and a highlighted total.
* **Store logo and signature** – both optional, chosen from the Media Library, with an editable signature caption such as "Authorised Signatory".
* **Invoice color** – 9 preset colors or any custom color to match your brand.
* **Sequential invoice numbers** – use the WooCommerce order number or an automatic sequence (1, 2, 3...), with prefix, suffix, minimum digits and date tags {Y} {y} {m} {d}.
* **Fixed invoice number and date** – saved on the order the first time, so re-downloading always shows the same invoice.
* **Complete order totals** – line items with SKU and variations, coupons, fees, shipping, every tax rate, refunds and net total.
* **Paper sizes** – Letter, A4, Legal and A5.
* **All currencies** – prints symbols such as ₹, €, £ and ¥ correctly.
* **Footer notes** – thank-you message, bank details, return policy or tax number, with basic HTML.
* **Store address** – taken from your WooCommerce settings.
* **Preview invoice** – check your design from the settings page before sending.

= WooCommerce order list features =

* **Summary cards** – number of orders, total sales and average order value for the selected filters.
* **Filters** – order number, customer name, email or phone, order status and date range.
* **Date ranges** – today, yesterday, last 7 days, last 30 days, this month, last month, this year, all time or a custom range.
* **Sorting and pagination** – sort by order or date and show 10, 20, 50 or 100 orders per page.
* **Status badges** in WooCommerce colors and a quick link to edit each order.

= Compatibility =

* WooCommerce **HPOS (custom order tables)** and legacy order storage.
* WordPress 5.0 to 7.1, WooCommerce 5.0 to 11.2, PHP 7.4 to 8.2.
* Uses the WooCommerce order API and the dompdf library, so no external service is needed and your order data stays on your site.

= Support, feedback and customization =

Need help, found a bug or want a new feature? Use the plugin's support forum or email support@naziinfotech.com. We also build custom WooCommerce plugins and can customize this invoice for your store.

== Installation ==

1. In your WordPress admin go to **Plugins > Add New**, search for **Ni WooCommerce Invoice**, then click **Install Now** and **Activate**. You can also upload the plugin folder to `/wp-content/plugins/`.
2. Make sure WooCommerce is installed and active.
3. Go to **Ni Invoice > Settings** to add your store name, logo, signature, invoice color, invoice number format and footer notes.
4. Go to **Ni Invoice > Order List** and click the PDF icon next to an order to download its invoice.

== Frequently Asked Questions ==

= How do I create a PDF invoice for a WooCommerce order? =

Go to **Ni Invoice > Order List**, find the order with the filters and click the red PDF icon. The invoice downloads as a PDF file.

= Can I add my logo and signature to the invoice? =

Yes. Go to **Ni Invoice > Settings** and choose a logo and a signature from the Media Library. Both are optional. PNG, JPG and GIF are supported, and a PNG with a transparent background looks best.

= Can I use sequential invoice numbers like INV-0001? =

Yes. In **Settings > Invoice number** choose **Automatic sequential number**, set the next number, a prefix such as `INV-`, a suffix such as `/{Y}` and the minimum digits. The WooCommerce order number is not changed.

= Will the invoice number change if I download the invoice again? =

No. The invoice number and invoice date are saved on the order the first time its invoice is created, so every download shows the same values. The Preview invoice button does not use up a number.

= Can I change the invoice color? =

Yes. Pick one of 9 preset colors or any custom color in **Settings > Invoice color**.

= Can I show my GST, VAT or bank details on the invoice? =

Yes. Add them to **Footer notes** in the settings. Line breaks are kept and basic HTML such as bold text is allowed.

= Does it support A4 paper? =

Yes. Choose Letter, A4, Legal or A5 in the order list before downloading.

= Is the plugin compatible with WooCommerce HPOS? =

Yes. It is declared compatible with High-Performance Order Storage and also works with legacy order storage.

= Why is the Rupee or another currency symbol missing? =

The invoice uses a Unicode font, so symbols like ₹, €, £ and ¥ print correctly from version 1.6.0. Please update to the latest version.

= Can you customize this plugin for my store? =

Yes. Email support@naziinfotech.com with your requirements.

== Screenshots ==

1. Order list with summary cards, filters, status badges and the PDF invoice button.
2. PDF invoice with logo, invoice number, Paid badge, addresses, items, totals and signature.
3. Invoice settings: store details and invoice number with prefix, suffix and sequential numbering.
4. Invoice settings: logo, signature, invoice color and footer notes.
5. Ni Plugins page with Pro and Free plugins.

== Changelog ==

= version 1.6.0 - 16-October-2026 =
* Fixed: Invoice PDF download crashed with a critical error on PHP 8.1 and newer
* Added: Compatible with WooCommerce High-Performance Order Storage (HPOS)
* Added: Redesigned order list with summary cards (orders, sales, average order), status badges and a PDF download button
* Added: Filters for order number, customer (name, email or phone), order status, this month, last month, all time and custom date range
* Added: Pagination, rows per page, sorting by order and date, and invoice paper size (Letter, A4, Legal, A5)
* Added: Optional store logo and signature (with caption) on the PDF invoice, chosen from the Media Library
* Improved: Redesigned settings page with a Preview invoice button
* Improved: New modern PDF invoice design: accent color header, paid/due badge, Bill To / Ship To blocks, numbered items with SKU and variation details, totals box, customer note, page footer
* Added: Invoice color setting with 9 preset swatches or any custom color; backgrounds and borders are tinted to match
* Added: Invoice number settings: use the order number or an automatic sequential number, with optional prefix, suffix ({Y} {y} {m} {d} date tags) and minimum digits
* Added: Invoice number and invoice date are saved on the order the first time its invoice is created, so re-downloads show the same values
* Added: Saved invoice number shown under the order number in the order list
* Improved: Redesigned Addons page with Pro and Free tabs, all free plugins listed with search and one-click Install / Activate
* Added: Store address from WooCommerce settings on the invoice
* Improved: Order list and invoice read orders through the WooCommerce order API instead of direct database queries
* Updated: Bundled dompdf library updated to 3.1.6 (PHP 8 support and security fixes)
* Fixed: Shipping Details on the invoice showed the billing address
* Fixed: Currency symbols such as the Indian Rupee sign were not printed in the PDF
* Fixed: Invoice totals now include fees, all tax rates, every coupon and refunds
* Fixed: PHP warnings when the invoice settings were not saved yet
* Security: Added nonce and capability checks to the order list and invoice download, and escaped all output
* Tested: Compatible With WooCommerce 11.2
* Tested: Compatible With WordPress 7.1
* Tested: Compatible With PHP 7.4 to PHP 8.2
* Tested: HPOS and legacy order storage

= version  1.5.7 -13-February-2023 =
* Tested: Compatible With WooCommerce 7.3.0 
* Tested: Compatible With WordPress 6.1.1

= version 1.5.6 -07-August-2022 =
* Tested: Compatible With WooCommerce 6.7.0
* Tested: Compatible With WordPress 6.0.1


= version 1.5.5 -08-July-2021 =
* Tested: Compatible With WooCommerce 5.4.1
* Tested: Compatible With WordPress 5.7.2

= version 1.5.4 -16-August-2020 =
* Tested: Compatible With WooCommerce 4.3.3
* Tested: Compatible With WordPress 5.5


= version 1.5.3 -03-May-2020 =
* Tested: Compatible With WooCommerce 4.0.1
* Tested: Compatible With WordPress  5.4.1

= version 1.5.2 -12-March-2019 =
* Tested: Compatible With WooCommerce 3.5.6
* Tested: Compatible With WordPress 5.1


= version 1.5 -15-July-2018 =
* Tested: Compatible With WooCommerce 3.4.3
* Tested: Compatible With WordPress 4.9.7

= version 1.4 - 16-March -2018 =
* Tested: Compatible With WordPress 4.8.3
* Tested: Compatible With WooCommerce  3.2.3
* BugFix: Some bugfix

= version 1.3 - 12-November -2017 =
* Tested: Compatible With WordPress 4.8.3
* Tested: Compatible With WooCommerce  3.2.3

= version 1.2 - 07-April -2017 =
* Tested: Compatible With WordPress 4.7.3
* Tested: Compatible With Woocommerce  3.0.0


= version 1.1 - 04-September -2016 =
* Tested: Compatible With WordPress 4.6
* Tested: Compatible With Woocommerce 2.6.4
* BugFix: Some internal bug fix
* Improve: PDF Format

= version 1.0 =
* Initial release

== Upgrade Notice ==

= 1.6.0 =
Fixes the PDF download error on PHP 8.1+, adds HPOS support, a new invoice design, logo, signature, invoice color, sequential invoice numbers and a redesigned order list. Recommended for all users.

== Disclaimer ==

It is not responsible for any harm or wrong doing this Plugin may cause. Users are fully responsible for their own use. This Plugin is to be used WITHOUT warranty.