=== Send24 Logistics ===
Contributors: send24app
Tags: woocommerce, shipping, logistics, delivery
Tested up to: 6.7
Stable tag: 1.0.8

License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html


# Send24 Logistics Plugin for WooCommerce

The **Send24 Logistics Plugin** integrates Send24's delivery services into your WooCommerce store. It allows customers to choose between **Hub Delivery** and **Door Delivery** directly from the WooCommerce checkout page.



## Installation

1. Download the plugin from the GitHub repository.
2. Upload the plugin to your WooCommerce site via **Plugins > Add New** or extract the ZIP file and upload the `send24-shipping` folder to the `/wp-content/plugins/` directory.
3. Activate the plugin through the **Plugins** menu in WordPress.
4. Go to **WooCommerce > Settings > Shipping > Send24 Logistics** to configure your API keys and other settings.

### Table of Contents

- [Configuration](#configuration)
  - [API Keys](#api-keys)
  - [Mode (Test/Live)](#mode-testlive)
- [Usage](#usage)
  - [Add the Shipping Method](#add-the-shipping-method)
- [Settings Screenshots](#settings-screenshots)
  - [Set Up Delivery Options](#set-up-delivery-options)
- [Order Creation Flow](#order-creation-flow)
- [Order Screenshots](#order-screenshots)
- [Send24 Dashboard](#send24-dashboard)
  - [API Keys](#api-keys)
  - [Wallet Top-Up](#wallet-top-up)

---

### Configuration

#### API Keys

1. Log in to the **Send24 Dashboard**.
2. Navigate to the **API Keys** section.
3. Generate an API key for your WooCommerce store.
4. Copy and paste the API key into the **Send24 Logistics Settings** in WooCommerce.

#### Mode (Test/Live)

- Switch between **Test Mode** and **Live Mode** in the plugin settings.
- Test Mode allows you to simulate delivery options without affecting real orders.

---

### Usage

#### Add the Shipping Method

1. Navigate to **WooCommerce > Settings > Shipping**.
2. Select a shipping zone, or create a new one.
3. Add the **Send24 Logistics** shipping method to the selected zone.
4. Save changes.

---

### Settings Screenshots

1. **Store Address (screenshot5)**
   ![Store Address](.screenshot-5.png)

2. **Shipping Method Setting (screenshot6)**
   ![Shipping Method](.screenshot-6.png)

3. **API Keys Setting (screenshot7)**
   ![API Keys](.screenshot-7.png)

#### Set Up Delivery Options

1. Navigate to **WooCommerce > Settings > Shipping > Send24 Logistics**.
2. Configure:
   - Default Hub for Pickup
   - Pricing Settings (Hub-to-Hub, Hub-to-Door)
   - Fragility and Size-Based Delivery Options
3. Save changes and test the setup using a sample order.

---

### Order Creation Flow

1. When a customer places an order with Send24 as the selected shipping method, the plugin will:
   - Automatically calculate the shipping cost based on the customer's address and selected delivery option.
   - Create an order in Send24 using the configured API key.
2. The Send24 order details, including tracking information, will be added to the WooCommerce order notes.

---

### Order Screenshots

Screenshots of the Send24 integration during checkout and order processing.

1. **Send24 Shipping Option (Cart) (screenshot1)**
   ![Send24 Shipping Option (Cart)](.screenshot-1.png)

2. **Send24 Shipping Option (Checkout) (screenshot2)**
   ![Send24 Shipping Option (Checkout)](.screenshot-2.png)

3. **Modal with Door Delivery Selected (screenshot3)**
   ![Delivery Options Modal](.screenshot-3.png)

4. **Modal with Hub Delivery Selected (screenshot4)**
   ![Hub Selection](.screenshot-4.png)


---

### Send24 Dashboard

#### API Keys

- Generate and manage API keys for your integration.
- Navigate to **Signup/Signin > Dashboard > Account Settings > API Keys**.

1. **Signup (screenshot14 & screenshot15)**
   ![Signup1](.screenshot-14.png)
   ![Signup2](.screenshot-15.png)

2. **Signin (screenshot16)**
   ![Signin](.screenshot-16.png)

3. **Dashboard (screenshot17)**
   ![Dashboard](.screenshot-17.png)

4. **API Keys Setting (screenshot18)**
   ![API Keys](.screenshot-18.png)

#### Wallet Top-Up

1. **Top-Up Wallet (screenshot8)**
   ![Top-Up Wallet](.screenshot-8.JPG)


2. **Choose a Payment Method**

   - **Bank Transfer (screenshot9 & screenshot10)**
   - **PayStack (screenshot10 & screenshot11)**
     ![Bank Transfer Option](.screenshot-9.JPG)
     ![Bank Transfer Option2](.screenshot-10.JPG)
     ![PayStack Option](.screenshot-11.JPG)
     ![PayStack Option2](.screenshot-12.JPG)
     ![Clear Accrued Balance](.screenshot-13.JPG)

---

## Debugging

- **Enable Debug Logs**: Navigate to **WooCommerce > Settings > Send24 Logistics** and enable the "Enable Debug Logs" option.
- Logs will be saved to the `wp-content/debug.log` file. Logs will include API requests, responses, and any errors encountered.
- Common errors include network timeouts, incorrect API keys, or invalid shipping data.

---

## Changelog

**Version 1.0.8**:
- Initial release with Hub Delivery and Door Delivery options.
- Integration with Send24 API for shipping order creation.

---

## License

This plugin is licensed under the GNU General Public License v2.0 (or later). Learn more at https://www.gnu.org/licenses/gpl-2.0.html.