=== CitiSprint Shipping ===
Contributors: legato
Tags: woocommerce, shipping, south-africa, logistics, courier
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 9.0
Stable tag: 1.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce plugin for CitiSprint shipping integration with live rates, auto-fulfillment, and shipment tracking.

== Description ==

CitiSprint Shipping integrates your WooCommerce store with CitiSprint courier services in South Africa, providing real-time shipping rates, automatic fulfillment, and comprehensive shipment management.

= Key Features =

* **Live Shipping Rates** - Display real-time CitiSprint shipping rates at checkout
* **Auto-Fulfillment** - Automatically create shipping waybills when orders are placed
* **Shipment Tracking** - Track shipments directly from your WooCommerce admin
* **Bulk Shipment Creation** - Create multiple shipments at once
* **South African Address Support** - Optimized for South African addressing including suburbs
* **HPOS Compatible** - Fully compatible with WooCommerce High-Performance Order Storage
* **Cart & Checkout Blocks** - Works with WooCommerce block-based checkout

= Requirements =

* WooCommerce 7.0 or higher
* PHP 7.4 or higher
* WordPress 6.0 or higher
* Valid CitiSprint/ShipLogic API credentials

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/citisprint-shipping-plugin` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to WooCommerce > CitiSprint to configure the plugin.
4. Enter your ShipLogic API credentials (API Key and API Password).
5. Configure your sender details and shipping preferences.
6. Enable the shipping method in WooCommerce shipping zones.

= Configuration =

After activation:
1. Go to **WooCommerce > CitiSprint > API Settings**
2. Enter your ShipLogic API credentials
3. Configure sender information in the **Sender Details** tab
4. Set up auto-fulfillment preferences in the **Settings** tab
5. Add CitiSprint as a shipping method in your shipping zones

== Frequently Asked Questions ==

= How do I get API credentials? =

Contact CitiSprint or ShipLogic to obtain your API credentials for integration.

= Does this plugin work with the new WooCommerce checkout blocks? =

Yes, the plugin is fully compatible with WooCommerce Cart and Checkout blocks.

= Can I disable auto-fulfillment? =

Yes, auto-fulfillment can be enabled or disabled from the plugin settings. You can also configure which order status triggers automatic waybill creation.

= Is this plugin compatible with HPOS? =

Yes, the plugin fully supports WooCommerce High-Performance Order Storage (HPOS).

== Screenshots ==

1. API configuration screen
2. Sender details setup
3. Shipments management interface
4. Live rates at checkout
5. Auto-fulfillment settings

== Changelog ==

= 1.2.2 =
* Added "Hide Delivery Dates on Rates" setting to suppress estimated delivery dates next to shipping rates at checkout

= 1.1.0 =
* Added HPOS compatibility
* Added Cart & Checkout blocks support
* Improved auto-fulfillment functionality
* Enhanced shipment tracking features
* Added bulk shipment creation
* Performance optimizations

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.1.0 =
This version adds full HPOS compatibility and support for WooCommerce block-based checkout. Update recommended for all users.

== Privacy Policy ==

This plugin connects to the ShipLogic API service to:
* Retrieve real-time shipping rates
* Create shipping waybills
* Track shipment status

The following data is sent to ShipLogic:
* Customer shipping address
* Order details (items, weight, dimensions)
* Sender information

No personal data is stored externally beyond what is required for shipping services. All API communications are secured via HTTPS.