=== ShippingGuard - Advanced Shipping Suite, Weight Based Shipping, Zero Emission & Protection ===
Contributors: Dominopress
Tags: woocommerce shipping, weight based shipping, shipping insurance, zero emission delivery, express shipping
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Transform your WooCommerce logistics with a modular shipping command center. Precise weight logic, automated protection, and eco-friendly delivery solutions in one dashboard.

== Description ==

**ShippingGuard** is the most comprehensive "Logistics Command Center" for WooCommerce, designed to eliminate shipping margin leaks and boost customer trust. Unlike simple shipping plugins, ShippingGuard provides a modular framework where you can toggle exactly the features your store needs to scale.

Whether you're struggling with heavy item surcharges, "where is my order" (WISMO) support tickets, or want to position your brand as eco-conscious, ShippingGuard provides the tools to automate your fulfillment strategy.

### 📦 Deep Multi-Modular Architecture:

#### 1. Advanced Weight & Volumetric (DIM) Engine
Stop losing money on bulky items. ShippingGuard calculates costs based on mass or dimensional weight, ensuring you never undercharge for shipping again.
*   **Tiered Weight Thresholds**: Set a "Free Weight Allowance" (e.g., 5 lbs). Only charge incremental rates after this limit is exceeded.
*   **Custom Charge Logic**: Choose between billing only the *Excess Weight* (Fair pricing) or the *Full Package Weight* once a threshold is crossed (High-tier logistics).
*   **Base vs. Incremental**: Combine a fixed "Handling Fee" with a per-unit weight rate for total pricing granularity.

#### 2. Shipping Protection & Auto-Claims
Empower your customers to "Insure" their own delivery. 
*   **Customer-Funded Protection**: Add a small fee (Fixed or Percentage) at checkout that covers lost, damaged, or stolen items.
*   **Integrated Claims Portal**: Manage claims directly from your WordPress dashboard. Approve or reject with a single click, keeping your records crystal clear.
*   **Revenue Optimization**: Turn shipping headaches into a small auxiliary revenue stream while removing the financial risk from the merchant.

#### 3. Eco-Delivery & Carbon Offsets
Position your store as a leader in sustainability.
*   **Green Checkouts**: Allow customers to opt-in for a carbon-neutral shipping surcharge.
*   **Eco-Restriction Rules**: Auto-exclude heavy or high-emission products from green delivery methods to maintain ecological integrity.
*   **Carbon Savings Analytics**: Show your customers (and yourself) how much CO2 your store has saved through the Eco-Delivery module.

#### 4. Delivery & Service Levels (EDD)
Set clear expectations and fulfill orders faster.
*   **Standard vs. Express Priority**: Build tiered shipping lanes.
*   **Express Surcharge Logic**: Instead of static pricing, set an "Express Add-on" (e.g., +$15.00). The system automatically calculates: `Standard Shipping + Surcharge`.
*   **Estimated Delivery Windows**: Display clear "Usually arrives in 2-4 days" notices at checkout to reduce pre-order anxiety and improve conversion.

#### 5. Condition Engine & Smart Overrides
Take control at the product level.
*   **Fixed Handling Fees**: Add a mandatory surcharge for specific fragile or heavy items (e.g., +$10 for "Large TV").
*   **Free Shipping Overrides**: High-margin products can trigger global free shipping for the entire cart with a single checkbox.
*   **Global Exclusions**: Prevent ShippingGuard logic from firing on specific categories or products.

### 🚀 Exclusive "Pro" Capabilities
For enterprise-level stores, the **ShippingGuard Pro Addon** unlocks:
*   **3D Box Packing Inventory**: Automate your packing logic by defining physical box dimensions. No more "Shipping Air."
*   **Complex Table Rates**: Multi-condition rules based on User Roles (Wholesale vs. Retail), Subtotals, and Category weights.
*   **Conversion Snackbars**: Real-time "Shipping Goal" bars to push customers toward higher cart values.

== Installation ==

1. Upload the `shippingguard` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Access the **ShippingGuard** menu in your sidebar to initialize the "Logistics Command Center."
4. Toggle on the modules you need (Weight, Protection, Eco, etc.) and save your settings.

== Frequently Asked Questions ==

= Does it sync with WooCommerce units? =
Yes! ShippingGuard automatically detects if your store uses **LBS, KG, OZ, or G** and updates all UI labels and calculations in real-time.

= Can I use it alongside other shipping plugins? =
Absolutely. ShippingGuard can act as your primary shipping method or as an auxiliary "Fulfillment Guard" providing specific surcharges and protection tools alongside your existing carriers.

= How do I customize the design? =
ShippingGuard uses standard WooCommerce fee and shipping hooks. You can style the checkout output using your theme's CSS or use our built-in UI for basic labeling.

== Screenshots ==

1. **Logistics Dashboard**: The central hub for all fulfillment modules.
2. **Weight Settings**: Illustrating the tiered threshold and charge logic.
3. **Product-Level Overrides**: Showing the "Fulfillment Strategy" tab in the product editor.
4. **Claims Center**: The interface for managing customer protection requests.

== Changelog ==

= 2.2.0 =
* NEW: Advanced Tiered Weight Logic with Free Allowances.
* NEW: Dynamic Express Surcharge model (Standard + Add-on).
* IMPROVED: Real-time Weight Unit Synchronization (LBS/KG).
* NEW: Product-Level Fixed Fees and Free Shipping Overrides.
* NEW: "Feature & Bug" community feedback hub.