readme.txt

=== PeproDev Ultimate Invoice ===
Contributors: peprodev, amirhpcom, blackswanlab
Donate link: https://pepro.dev/donate
Tags: woocommerce invoice, pdf invoice, persian, WooCommerce
Requires at least: 5.0
Tested up to: 6.9
Version: 2.2.6
Stable tag: 2.2.6
Requires PHP: 7.4
WC requires at least: 5.0
WC tested up to: 10.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced WooCommerce invoice plugin: create customizable HTML/PDF invoices, attach to emails, and let customers download styled invoices easily.

== Description ==

### Merry Christmas & Happy New Year 2026! 🎄🎉
Thank you for using and supporting this free plugin! If you have any questions or need assistance, please ask on the WordPress support forum. We're here to help!

**Update to v2.2.3 to get the new Thermal Invoice feature and many more improvements!**

-----------------------

## **Ultimate Invoice plugin for WooCommerce!**

Create customizable PDF/HTML invoices for WooCommerce, attach to Email, Packing Slips, Shipping Labels, Shipping Tracking, Single-shop feature and ...
This plugin lets you to Generate Awesome Invoices for WooCommerce orders and:

-   Download PDF invoices
-   Email Styled Invoices
-   Attach PDF to WC Emails
-   Attach PDF to Invoices Emails
-   Restrict Invoices Options
-   Full Invoice Customizations
-   Make your own Invoice Template
-   Make your own PDF Invoice Template
-   Make your own Inventory Report Template
-   Make your own Packing Slips Template
-   Alter plugins via Action/Filter hooks
-   and .....

### Hot Features since Version 1.4 🔥
- Bulk Download Invoices PDF as ZIP Archive
- Bulk Print Invoices Inventory Reports
- Bulk Print Invoices Shipping Slips
- Export/Import Settings as JSON/PHP!
- Developers 😍 Bundle your PDF/HTML Invoice Template with your Theme/Plugin ([read more](https://github.com/peprodev/ultimate-invoice/wiki/Add-Customized-External-Template-to-Ultimate-Invoice))
- Added: Fully Compatibility with [PeproDev Ultimate Profile Solutions](https://wordpress.org/plugins/peprodev-ups/)
- Added: Fully Compatibility with [WPC Product Bundles by WPClever](https://wpclever.net/downloads/product-bundles)
- Added: Fully Compatibility with [WooCommerce Extra Product Options by ThemeComplete](https://codecanyon.net/item/woocommerce-extra-product-options/7908619)
- Added: Fully Compatibility with *Any Standard* plugins that adds and shows Order item metas
- Added: Added Integration Section in Settings


-----------------------

### Made by Developers for Developers
- [Github Wiki](https://github.com/peprodev/ultimate-invoice/wiki)
- Over 190 Filter Hook
- Over 15 Action Hook
- Fully Translatable
- Nice and Human Readable Variable Names
- Separated Classes for Different purposes
- Templates for HTML Invoice (tpl, css)
- Templates for PDF Invoice (tpl, css)
- Templates for Email Invoice (tpl, css)
- Templates for Inventory Report (tpl, css)
- Templates for Packing Slips(tpl, css)
- Change Email Sending Settings (from, name, and ...)
- Preserve email template style even in **Gmail**!
- and ....

### Invoice Items filtering
- Show / Hide Store National Id
- Show / Hide Store Registration Number
- Show / Hide Store Economical Number
- Show / Hide Customer Address
- Show / Hide Customer Phone
- Show / Hide Customer E-mail
- Show / Hide Order Date
- Show / Hide Payment method
- Show / Hide Shipping method
- Show / Hide Transaction Ref. ID
- Show / Hide Product Image
- Show / Hide Product Purchase note
- Show / Hide Order Items
- Show / Hide Order Total
- Show / Hide Product Weight
- Show / Hide Product Dimensions
- Show / Hide Product SKU
- Show / Hide Order Note
- and ....

### Extras
- Quick Shop Feature ( Purchase all products in one page )
- Visual Composer Widget
- Pre-order Invoices Status
- Built in DARK MODE Support (Auto, Manual)
- Disable WC Modern Dashboard
- Date parsing templates
- Jalali/Shamsi Date formats numbers?
- English, Eastern Arabic and Persian Numbers style
- RTL-ready
- Automated Email sending system
- Fully Woo-commerce integration
- and ...



### How can I report security bugs?

You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities. [Report a security vulnerability.](https://patchstack.com/database/vdp/pepro-ultimate-invoice)


---

#### Made by love in [Pepro Development Center](https://pepro.dev/).

#### *[Pepro Dev](https://pepro.dev/) is a registered trademark of [Pepro Co](https://pepro.co/).*

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins` directory, or install the plugin through the WordPress plugins screen directly.

1. Activate the plugin through the 'Plugins' screen in WordPress

1. Navigate to `yoursite.com/wp-admin/admin.php?page=wc-settings&tab=pepro_ultimate_invoice` to change settings.


== Frequently Asked Questions ==

= How can I report security bugs? =

You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities. [Report a security vulnerability.](https://patchstack.com/database/vdp/pepro-ultimate-invoice)

= How can I show compact total order in PDF invoices? =

Use hook below and add it into your plugin or theme's `function.php`

add_filter( "puiw_return_pdf_total_prices_as_single_price","__return_true");`

= How can I contribute to this plugin? =

You can help us improve our works by committing your changes to our Github repository: [github.com/peprodev/ultimate-invoice](https://github.com/peprodev/ultimate-invoice)


== Screenshots ==

1. Sample PDF Generated by plugin
2. Store Details Setting
3. Store Details Setting in Dark mode
4. Invoices items Setting
5. Invoices items Setting in Dark mode
6. Miscellaneous Setting ( Disable WC New Dashboard and ...)
7. Privacy Setting ( Access Manager )
8. Barcode and QR Setting
9. Inventory Report Setting
10. Invoices template and theming setting
11. WooCommerce Orders → Columns → Ultimate Invoice Options → Popup Toolbox
12. WooCommerce Orders → Columns → Ultimate Invoice Options → Popup Toolbox → Email Invoice to Customer on the fly
13. WooCommerce Orders → Columns → Ultimate Invoice Options → Popup Toolbox → View Invoice on the fly
14. Edit Orders → Metabox → Ultimate Invoice Options


== Upgrade Notice ==

**Merry Christmas & Happy New Year 2026! 🎄🎉**

Upgrade to enjoy the latest features and security improvements.

Thank you for using and supporting this free plugin! If you have any questions or need assistance, please ask on the WordPress support forum. We're here to help!

This update adds full thermal printer support, improves WooCommerce HPOS compatibility, and includes important PDF and performance improvements. Recommended for all users.

For full changelog please view [Github Repo.](https://github.com/peprodev/ultimate-invoice)

== Changelog ==

**Merry Christmas & Happy New Year 2026! 🎄🎉**

Thank you for using and supporting this free plugin! If you have any questions or need assistance, please ask on the WordPress support forum. We're here to help!

For full changelog please view [Github Repo.](https://github.com/peprodev/ultimate-invoice)

= v2.2.6 | 2026-03-08 | 1404-12-17 =
- Security Issue Fixed: Randomized invoice archive filenames and removed files after download

= v2.2.5 | 2025-12-31 | 1404-10-10 =
- Fixed: Error preventing checkout process
- Fixed: Missing fonts added to the plugin

= v2.2.4 | 2025-12-28 | 1404-10-07 =
- Fixed: Thermal Invoice height
- Removed: Extra mPDF fonts (not used widely)
- Improved: Persian translations

= v2.2.3 | 2025-12-27 | 1404-10-06 =
- Added: Option to Print Order Notes on Shipping Slips (RTL-Template Only)
- Added: Option to Set Different PDF Page-size for Invoices and Slips
- Added: Option to Set PDF Margins (Top, Right, Bottom, Left, Header, Footer)
- Fixed: Breaking Order Items table into multiple pages
- Fixed: Icons loaded incorrectly on Admin Orders Screen
- Fixed: Not showing order notes on PDF Invoices

= v2.2.2 | 2025-12-25 | 1404-10-04 =
- Added: New Feature to Support Thermal Printer Labels (80mm / پرینتر حرارتی / فیش پرینتر)
- Added: New Template for Thermal Printer Invoices
- Added: Download POS Invoices PDF as ZIP Archive
- Improvement: Changed *minimum PHP requirement to 7.4* 🙋‍♂️
- Improvement: WooCommerce HPOS Full Compatibility
- Improvement: Compatibility with WP 6.9 and WC 10.4
- Improvement: PDF Zip Archive Comments Formatting
- Improvement: Order Notes (Customer & Shop Manager) Display in PDF Invoices
- Improvement: Options/Setting Page UI/UX Improvements
- Improvement: Default Setting setup for New Installations
- Improvement: Code Optimization and Refactoring
- Improvement: Updated mPDF Library to v8.2.7
- Improvement: Allowed HTML Tags in Address Display method field
- Improvement: Invoice Templates Content & Display styles
- Improvement: Added Built-in mPDF fonts for better PDF Styling
- Fixed: Minor Bug Fixes
- Fixed: Security Issue CVE-2025-54869
- Fixed: Shop Manager note not saving issue
- Fixed: Shipping track number not saving issue
- Fixed: Division by zero error when calculating discounts (thanks to [@isaeedam](https://profiles.wordpress.org/isaeedam/))
- Fixed: Bulk Download Invoices PDF as ZIP Archive option not appearing in bulk actions dropdown
- Fixed: Loading Translation Issues
- Developers: Added New hook `puiw_create_pdf_fit_height` for controlling PDF fit to height option
- Developers: Improvement `puiw_printinvoice_check_user_has_access` hook to control access manager checks

== About Us ==

PEPRO DEV is a premium supplier of quality WordPress plugins, services and support.
Join us at [https://pepro.dev/](https://pepro.dev/) and also don't forget to check our [free offerings](http://profiles.wordpress.org/peprodev/), we hope you enjoy them!