=== Shiptastic Rules for WooCommerce ===
Contributors: indianadmin
Tags: woocommerce, shipping, shipment tracking, shipping rules, order tracking
Requires at least: 5.9
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced WooCommerce shipping rules engine with a real-time rule builder and a customer-facing shipment tracking timeline.

== Description ==

**Shiptastic Rules for WooCommerce** gives WooCommerce store owners a powerful, visual rule builder to create smart shipping rates — and a shipment tracking timeline so customers always know where their order is.

= Shipping Rules Engine =

Create unlimited shipping rules using any combination of conditions:

* Cart weight, volume, and quantity
* Product type and shipping class
* Cart subtotal / order value
* Applied coupon codes
* Customer user role
* Product dimensions (length, width, height)

The full-screen rule builder shows a real-time preview so you can verify every rate before saving.

= Shipment Tracking =

* Add tracking events (Order Placed, Packed, In Transit, Out for Delivery, Delivered, and more) from the order edit screen
* Customers see a clean timeline automatically on their My Account → Order details page
* Elementor widget included — drag the tracking timeline anywhere and style it with your theme

= Key Features =

* Full-screen rule builder with real-time preview
* Unlimited shipping rules per zone / method instance
* Custom shipment tracking timeline (admin + customer view)
* "Manage Shipment Tracking" modal in the WooCommerce order edit screen
* Elementor widget for custom placement of the tracking timeline
* WooCommerce HPOS (Custom Order Tables) compatible
* WooCommerce Cart & Checkout Blocks compatible
* Multisite compatible
* Clean uninstall — all plugin data removed on deletion

== Installation ==

= Automatic Installation =

1. Go to **Plugins → Add New** in your WordPress admin.
2. Search for **Shiptastic Rules for WooCommerce**.
3. Click **Install Now**, then **Activate**.

= Manual Installation =

1. Download the plugin zip file.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Upload the zip file and click **Install Now**, then **Activate**.

= After Activation =

1. Make sure WooCommerce is installed and active.
2. Go to **WooCommerce → Settings → Shipping**.
3. Add or edit a shipping zone and click **Add shipping method** → select **Shiptastic Rules for WooCommerce**.
4. Click **Edit** on the method to open the Rule Builder.

= Shipment Tracking Setup =

1. Open any WooCommerce order in the admin.
2. Find the **Shipment Tracking** sidebar box.
3. Click **Manage Shipment Tracking** to add tracking events.
4. Customers will see the timeline automatically on their order details page.

= Elementor Widget =

1. Edit any page or template with Elementor.
2. Search for **IA Shipment Tracking** in the widget panel.
3. Drag it onto your layout — it renders the correct order's tracking timeline for the logged-in customer.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active. The plugin will not activate without it.

= Which versions of WooCommerce are supported? =

WooCommerce 6.0 and above. Tested up to WooCommerce 9.4.

= Is it compatible with WooCommerce HPOS? =

Yes. Full compatibility with WooCommerce High-Performance Order Storage (Custom Order Tables) is declared.

= Does the tracking timeline show automatically on the customer's order page? =

Yes. No configuration is needed — the timeline appears automatically below the order details table on the My Account → Order details page.

= Do I need Elementor Pro for the widget? =

No. The widget works with the free version of Elementor.

= What data is removed when the plugin is deleted? =

All plugin data is permanently removed: the custom database table (`{prefix}ia_shipment_tracking`), all plugin options, and all per-instance shipping rule settings. WooCommerce shipping zone assignments are managed by WooCommerce and are not removed.

= What happens to my data when the plugin is deactivated? =

All data is preserved on deactivation. Rules and tracking events are available again when you reactivate the plugin.

= Is the plugin multisite compatible? =

Yes. Uninstall cleans up data for every sub-site in a multisite network.

== Screenshots ==

1. Full-screen rule builder with real-time preview
2. "Manage Shipment Tracking" modal on the WooCommerce order edit screen
3. Customer-facing shipment tracking timeline on the My Account order details page
4. Elementor widget for custom placement of the tracking timeline

== Changelog ==

= 1.0.0 – 2026-05-05 =
* Initial public release
* Full-screen shipping rule builder with real-time preview
* Shipment tracking timeline (admin modal + automatic customer view)
* Elementor widget for custom tracking timeline placement
* WooCommerce HPOS and Cart/Checkout Blocks compatibility declared
* Multisite-compatible uninstall
* Clean GPLv2 codebase — no tracking, no telemetry, no external calls

== Upgrade Notice ==

= 1.0.0 =
Initial release. No upgrade steps required.
