=== Ferdaus Live Rates Connector ===
Contributors: ferdausalom
Tags: shipstation, woocommerce, shipping, shipping-rates, live-rates
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 1.0.3
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Provides real-time, carrier-calculated shipping rates from ShipStation in WooCommerce checkout using your ShipStation carrier accounts.

== Description ==

**ShipStation Dynamic Live Rates for WooCommerce** allows your WooCommerce store to display *real-time, carrier-calculated shipping rates* from your ShipStation account directly at checkout.

This plugin eliminates the need to set up manual shipping rates. Instead, it retrieves accurate rates from carriers you have connected in ShipStation—such as USPS, UPS, FedEx, DHL, and more—based on the customer’s cart contents, destination, package weight, and dimensions.

### Key Features

- **Real-Time Carrier Rates from ShipStation**  
  Fetches shipping options and prices dynamically at checkout.
  
- **Use Your ShipStation Carrier Accounts**  
  Rates are based on your negotiated carrier pricing—not WooCommerce’s built-in rates.

- **Highly Accurate Rates**  
  Calculates costs using product weight, dimensions, shipping address, and ShipStation’s live rate API.

- **Multiple Shipping Services Supported**  
  USPS, UPS, FedEx, DHL, and any other carrier connected to your ShipStation account.

- **Easy Setup**  
  Just enter your ShipStation API Key and Secret—no complicated configuration.

- **Customizable Rate Names & Display Settings**  
  Choose which rates to show, set fallbacks, control handling fees, and more.

- **Works with Any WooCommerce Shop**  
  Compatible with simple and variable products.

### Why Use This Plugin?

WooCommerce’s default shipping methods can be limiting and often require manual rate tables. With ShipStation’s dynamic live rates, you always show **accurate, up-to-date shipping costs**, improving checkout conversions and avoiding under- or over-charging for shipping.

### Requirements

- Active ShipStation account  
- ShipStation API Key & Secret  
- WooCommerce installed and activated  

== Installation ==

1. Download the plugin ZIP file.
2. Go to **Plugins → Add New → Upload Plugin** in your WordPress admin.
3. Upload the ZIP file and click **Install Now**.
4. Activate the plugin.
5. Go to **WooCommerce → Settings → Shipping → ShipStation All Carriers**.
6. Enter your ShipStation API credentials.
7. Enable the shipping method and configure your preferred settings.

== Frequently Asked Questions ==

= Do I need a ShipStation account? =  
Yes. You must have an active ShipStation account with valid API credentials.

= Which carriers are supported? =  
All carriers connected in your ShipStation account, including USPS, UPS, FedEx, DHL, and other supported integrations.

= Are my negotiated rates used? =  
Yes. The plugin fetches your **actual contracted rates** from ShipStation.

= Does this plugin create shipping labels? =  
No. This plugin is for **displaying live shipping rates only**. You can still generate labels in ShipStation as usual.

= Will it work with multi-package shipments? =  
The plugin calculates rates based on WooCommerce cart contents and ShipStation’s API response. Multi-package support depends on your ShipStation configuration.

= Does this replace the official ShipStation plugin? =  
No. It complements the official plugin by adding **dynamic rate calculation**, which the official plugin does not provide.

== Screenshots ==

1. 1-settings.png
2. 2-settings.png
3. checkout-rates.jpg

== Support ==

For support, questions, or feature requests, please use the plugin support forum on WordPress.org.

== Changelog ==

= 1.0.3 =
* Renamed plugin and updated identifiers to comply with WordPress.org guidelines

= 1.0.2 =
* Renamed plugin and updated identifiers to comply with WordPress.org guidelines
* Added explicit WooCommerce dependency declaration

= 1.0.1 =
* Improved input sanitization for POST data

= 1.0.0 =
* Initial release
* Fetch live rates from ShipStation API
* Support for all connected carriers
* Customizable shipping method settings


== Upgrade Notice ==

= 1.0.3 =
Maintenance release with naming, metadata, and compatibility improvements.

= 1.0.2 =
Maintenance release with naming, metadata, and compatibility improvements.

= 1.0.1 =
Security and data sanitization improvements. Recommended update.

= 1.0.0 =
Initial release.

