# Zibad Smart Notifier Documentation (Free Version)

## 1. Installation
1. Download the plugin zip file.
2. Go to **WordPress Admin → Plugins → Add New**.
3. Upload the ZIP file and activate it.
4. **Requirement:** Ensure WooCommerce 6.0+ is installed and active.
5. **Requirement:** A Twilio account is required for SMS delivery in the Free version.

## 2. Initial Setup
Navigate to **Zibad Smart Notifier → Settings** to configure:
- **Default Country Code:** For phone number normalization.
- **Twilio Gateway:** Enter your Account SID and Auth Token.
- **Default Gateway:** Set this to Twilio (primary for Free version).

## 3. Message Templates
In the Free version, you can create **1 active message template**. 
You can customize your message using dynamic placeholders:
- `{customer_name}`: Buyer's full name.
- `{order_id}`: The WooCommerce order number.
- `{order_total}`: Total amount of the order.
- `{order_status}`: Current status (e.g., Processing, Completed).
- `{order_date}`: Date the order was placed.

## 4. Workflows & Automation
The Free version supports **1 automated workflow**.
- **Trigger:** Choose a WooCommerce event (e.g., Order Processing).
- **Template:** Link your created template to this trigger.
- **Gateway:** Twilio is the default delivery channel.

## 5. Logging & Monitoring
Access **Smart Notifier → Logs** to view:
- **Delivery Status:** Sent, Failed, or Queued.
- **History:** The Free version tracks the **last 50 messages**.
- **Provider IDs:** Reference IDs for Twilio troubleshooting.

## 6. Developer Notes
- **Modular OOP:** Built for extensibility.
- **Action Hooks:** Developers can use `zimsn_registered_gateways` to add custom logic.
- **Security:** Built-in nonce validation and capability checks.

## 7. Performance
- **Queue System:** Messages are processed in the background to ensure your store remains fast.
- **Optimization:** Minimal database footprint with optimized queries.