=== OrderSeq: Sequential Order Numbers for WooCommerce ===
Contributors: adrightly
Tags: custom order numbers, sequential orders, order numbers, invoice, consecutive orders
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 8.0
WC requires at least: 7.0
WC tested up to: 9.5
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Consecutive sequential order numbers for WooCommerce with custom prefixes, date macros, zero padding, and 1-click backfill. HPOS ready.

== Description ==

By default, WooCommerce assigns order numbers using WordPress internal post IDs. If you receive Order #100, then write a draft blog post or upload three product photos, your next customer receives Order #104.

For accounting, tax compliance, and professional store branding, invoices and receipts must follow unbroken, consecutive order numbers with professional custom prefixes.

**OrderSeq: Sequential Order Numbers for WooCommerce** provides complete control over your store's order numbers:

### Key Features

* **Custom Starting Number:** Begin your order sequence at any number (e.g. 1001, 50000).
* **Custom Prefixes & Suffixes:** Add custom text and dynamic date macros such as `{YYYY}`, `{YY}`, `{MM}`, and `{DD}` (e.g. `ORD-2026-1001`).
* **Leading-Zero Number Padding:** Pad order numbers to a fixed digit length (e.g. `00042` with 5-digit padding).
* **1-Click Historical Backfill:** Detect and assign sequential numbers to orders created prior to activation or while deactivated.
* **1-Click Legacy Migration:** Automatically detect and import order sequences from SkyVerge or other legacy sequential order plugins in one click.
* **Customer Order Tracking Resolution:** Customers can look up shipments on the WooCommerce Order Tracking page using their custom formatted sequential number.
* **100% WooCommerce HPOS Native:** Official declared compatibility with High-Performance Order Storage (`custom_order_tables`).
* **PHP 8.1, 8.2 & 8.3 Ready:** Strict type definitions with zero deprecated notices or runtime crashes.
* **Fast Admin Search:** Search orders by formatted or raw sequence number directly in the WooCommerce Orders admin screen.
* **Zero External Dependencies:** 100% self-contained code. No external cloud APIs, zero recurring server costs.

### Dynamic Date Macros

You can include real-time date macros in your prefix and suffix fields:
* `{YYYY}` - 4-digit current year (e.g. 2026)
* `{YY}` - 2-digit current year (e.g. 26)
* `{MM}` - 2-digit month with leading zero (01 through 12)
* `{DD}` - 2-digit day with leading zero (01 through 31)

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/orderseq-sequential-order-numbers` directory, or install directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to **WooCommerce** -> **Settings** -> **Sequential Numbers** to configure your starting number and formatting rules.

== Frequently Asked Questions ==

= Does this plugin work with WooCommerce High-Performance Order Storage (HPOS)? =
Yes. The plugin is built specifically for WooCommerce HPOS and declares official compatibility with custom order tables.

= What happens if I have orders created before installing the plugin? =
The plugin includes a **1-Click Historical Backfill** tool. When active, it alerts you if any unassigned orders exist and assigns sequential numbers in chronological order with one click.

= Can customers track their order using the custom sequential number? =
Yes. The plugin integrates with the standard WooCommerce `[woocommerce_order_tracking]` shortcode, allowing buyers to look up orders using their formatted order number.

= Will this conflict with my payment gateways or invoice plugins? =
No. The plugin integrates via standard WooCommerce order filters (`woocommerce_order_number`), ensuring invoices, packing slips, and payment confirmation emails display the formatted sequential number seamlessly.

== Screenshots ==

1. Settings panel inside WooCommerce Settings with live order preview card.
2. Real-time preview updating as you type prefixes and date macros.
3. Order list table displaying clean sequential numbers.
4. 1-Click Backfill tool for unassigned orders.

== Changelog ==

= 1.1.0 =
* Added: 1-Click Historical Backfill engine for unassigned orders.
* Added: Customer Order Tracking shortcode resolution ([woocommerce_order_tracking]).
* Added: Modern vector icon and high-resolution banner assets.
* Enhanced: Native wp_date timezone evaluation for dynamic date macros.
* Enhanced: Clean uninstall.php database options hygiene.
* Confirmed: WordPress 6.8+ and WooCommerce 9.5+ HPOS compatibility.

= 1.0.0 =
* Initial release.
* Full WooCommerce HPOS compatibility.
* Support for custom prefixes, suffixes, padding, and date macros.
* Integrated 1-Click Legacy Migration engine.
