=== Orders Delivery Drivers for WooCommerce ===
Contributors: wpsaad, arabianmido, freemius
Tags: delivery drivers, woocommerce delivery, local delivery, delivery, drivers, 
Requires at least: 5.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Plugin URI: https://wpsaad.com/wp-plugins/orders-delivery-drivers-for-woocommerce-pro/
Author URI: https://wpsaad.com/
Author: WPSaad

Assign drivers, track deliveries, and manage WooCommerce orders with a driver dashboard and Google Maps.

== Description ==

**Orders Delivery Drivers for WooCommerce** is a delivery drivers plugin for WooCommerce stores that need local delivery, order assignment, and driver management in one dashboard. Create delivery drivers, assign orders fast, and track delivery status with a clear delivery workflow.

This WooCommerce delivery drivers solution adds a driver dashboard, delivery status tracking, and Google Maps delivery view. It is designed for businesses handling delivery orders, dispatching drivers, and managing last-mile delivery efficiently.

**Free Features**

– **Driver Assignment Panel**: Assign any WordPress user with the `Driver` role to a WooCommerce order.
– **Driver Dashboard (Frontend)**: Drivers can view assigned and completed orders, toggle availability, and update delivery status.
– **Delivery Status Tracking**: Orders support statuses like `Driver Assigned`, `Out for Delivery`, and `Completed`.
– **Live Google Maps Embed**: Show delivery address on a live map in the driver order view (requires Google Maps API key).
– **Mobile Ready**: Frontend views are responsive and optimized for drivers in the field.
– **Driver Ratings**: Customers can rate deliveries (stored on the order).
– **Admin Orders Monitor**: Admin dashboard with filters, tabs, and driver availability table.

== Upgrade to Pro ==
Unlock advanced delivery automation, enhanced notifications, and admin controls.

**Pro Features**

* Auto-assign drivers to new orders (least open deliveries or random).
* Accept driver applications from a public form and approve inside WordPress.
* Multi-provider SMS integration: Twilio, Vonage, MessageBird, Plivo, AWS SNS, SMS Misr (SMS Egypt), and Generic HTTP gateway.
* Enhanced email templates for driver assigned, out for delivery, and completed.
* Additional permissions and security controls for admin workflows.

[Upgrade to Pro](https://wpsaad.com/wp-plugins/orders-delivery-drivers-for-woocommerce-pro/)

**Google Maps Integration**
Each assigned order includes a Google Map with the delivery address marked, letting drivers visualize the route quickly. The map appears on the driverï¿½s order details page in their dashboard.

Example:
Drivers can click `Out for Delivery`, view the address on the map, call the customer or dispatch, and update the status.

**Driver Applications**

Admins can manage driver applications from:
Users -> Driver Applications

The Driver Applications screen provides three tabs:
– Pending — new driver applications awaiting review
– Approved — applications that have been approved and converted into driver accounts
– Rejected — applications that were declined

When an application is approved:
– A WordPress user account is created automatically
– The user is assigned the Driver role
– Driver profile data (vehicle details, phone, images) is saved to user meta

**Use Cases**

Great for any WooCommerce-powered business offering local delivery:
– Grocery and meal prep
– Flowers and gifts
– Local services (cleaning, repair)
– Restaurants and takeout
– Health and wellness providers

**How it Works**

1. Add users with the role `Driver`
2. Assign drivers via the WooCommerce order admin panel
3. Driver receives access to a dedicated dashboard
4. Driver can:
   – View map and order details
   – Change status to **Out for Delivery** or **Completed**
   – Trigger optional customer and admin updates

**Why Use This Plugin**

– Easy to assign and track drivers
– Driver UI is fast and simple
– Maps support included (requires API key)
– No coding or third-party delivery services required
– Built for WooCommerce only

**Getting Started**

1. Install and activate the plugin on your WooCommerce site
2. Create or edit users and assign them the `Driver` role
3. Assign a driver in the order edit screen (meta box on right)
4. Driver will see new orders in their **Driver Dashboard**
5. Driver updates order status as they progress
6. Map and contact buttons are available in each delivery order view

**Driver Dashboard Preview**
Includes:
– Assigned and Completed Orders
– Live Map with Address
– Status Updates
– Call Dispatch / Call Customer buttons
– Availability toggle: "Accepting Deliveries"

**Shortcodes**
– `[oddw_delivery_drivers_dashboard]` — Driver dashboard (My Account endpoint uses this).
– `[oddw_dashboard]` — Backward-compatible alias for driver dashboard.
– `[driver_application_form]` — Public driver application form. (PRO)
– `[delivery-drivers-orders-monitor]` — Admin orders monitor dashboard. (PRO)
– `[oddw_dashboard]` — Backward-compatible alias for driver dashboard.

Each assigned order includes a Google Map with the delivery address marked, letting drivers visualize the route quickly. The map appears on the driver's order details page in their dashboard.

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin through the WordPress admin.
3. Go to **Delivery Drivers -> Settings** to configure the plugin.
4. Create drivers manually (or approve driver applications).
5. Assign drivers to orders (or enable auto-assignment).

== Frequently Asked Questions ==
= What does the Orders Delivery Drivers for WooCommerce plugin do? =
This plugin adds a complete delivery driver management system to WooCommerce, enabling you to assign drivers to orders, track delivery status in real-time, display Google Maps, and provide drivers with a dedicated dashboard to manage their assigned deliveries.

= What are the minimum WordPress and WooCommerce requirements? =
The plugin requires WordPress 5.5 or higher, WooCommerce 5.0 or higher, and PHP 7.4 or later.

= What is the difference between the Free and Pro versions? =
The Free version includes driver assignment, driver dashboard, delivery status tracking, Google Maps integration, mobile responsiveness, driver ratings, and an admin orders monitor. The Pro version adds auto-assignment of drivers to new orders, driver application management, multi-provider SMS notifications, enhanced email templates, and additional security controls.

= What shortcodes are available? =
The plugin provides:
- `[oddw_delivery_drivers_dashboard]` — Driver dashboard (My Account endpoint uses this).
- `[oddw_dashboard]` — Backward-compatible alias for driver dashboard.
- `[driver_application_form]` — Public driver application form. (PRO)
- `[delivery-drivers-orders-monitor]` — Admin orders monitor dashboard. (PRO)


= Is this plugin suitable for my business model? =
This plugin works great for any WooCommerce business offering local delivery, including grocery and meal prep, flowers and gifts, local services (cleaning, repair), restaurants and takeout, and health and wellness providers.

= How do I assign drivers to WooCommerce orders? =
You can assign drivers to orders using the Delivery Driver meta box on the WooCommerce order admin panel. Simply select a driver from the dropdown list for each order. If using the Pro version, you can also enable automatic driver assignment.

= How are drivers created? =
Drivers are created by creating a WordPress user account and assigning them the Driver role. Alternatively, in the Pro version, you can accept driver applications from a public form and approve them within WordPress admin—this automatically creates a user account with the Driver role and saves driver profile data.

= Can drivers have multiple roles in WordPress? =
The plugin assigns users the Driver role, which can work alongside other roles depending on your WordPress configuration. However, the plugin specifically manages the Driver role for driver-related functionality.

= How does automatic driver assignment work? =
Automatic driver assignment (Pro feature) automatically assigns new orders to available drivers when they are created. The assignment algorithm can select the driver with the least open deliveries or choose a driver randomly, depending on your configuration preference.

= Where can I manage driver applications? =
Driver applications are managed in the WordPress admin under Users > Driver Applications, which provides three tabs: Pending (new applications), Approved (converted to driver accounts), and Rejected (declined applications).

= What driver information can be collected from applications? =
When drivers submit applications (Pro feature), you can collect and store vehicle details, phone numbers, and profile images, which are saved to the driver's user meta in WordPress.

= What can drivers see in the Driver Dashboard? =
Drivers can view assigned and completed orders, toggle their availability (Accepting Deliveries on/off), view delivery address on a live Google Map, update order status, and access call buttons to contact dispatch or customers.

= What delivery statuses are available for drivers? =
Orders support delivery statuses including Driver Assigned, Out for Delivery, and Completed. Drivers can update these statuses from the Driver Dashboard.

= Can drivers update order status? =
Yes. Drivers can mark assigned orders as **Out for Delivery** and **Completed** from the Driver Dashboard in My Account.

= Is the Driver Dashboard mobile-friendly? =
Yes. The frontend driver dashboard is fully responsive and optimized for drivers working in the field on mobile devices.

= What shortcode displays the driver dashboard? =
The main driver dashboard shortcode is `[oddw_delivery_drivers_dashboard]`. You can also use `[oddw_dashboard]` as a backward-compatible alias. This shortcode integrates with the My Account page.

= How does Google Maps integration work in the plugin? =
Each assigned order includes a live Google Map with the delivery address marked. Drivers can view this map from the order details page in their dashboard to visualize the route quickly before heading out for delivery.

= Do I need a Google Maps API key? =
Yes, a Google Maps API key is required to display the live map in the driver order view. You configure this in WooCommerce -> Settings -> Delivery Drivers.

= Does the plugin provide turn-by-turn navigation? =
The plugin does not provide turn-by-turn navigation. However, a Google Maps link is generated for directions using the delivery address when the driver views the order details, which they can use to open their preferred navigation app.

= What personal data is sent to Google Maps? =
The delivery address and store address are sent to Google Maps only when a driver opens an order containing the map. This is done to display the location accurately. Review Google's Terms of Service and Privacy Policy for their data handling practices.

= Are SMS notifications required for the plugin to work? =
No. SMS notifications are optional and only sent when an SMS provider is configured. Email notifications work without SMS being set up.

= What SMS providers does the plugin support? =
The Pro version supports multi-provider SMS integration: Twilio, Vonage, MessageBird, Plivo, AWS SNS, SMS Misr (SMS Egypt), and Generic HTTP gateway.

= What types of email notifications are available? =
Email notifications include templates for driver assigned, out for delivery, and completed delivery statuses. Enhanced email templates are available in the Pro version.

= Can I customize notification templates? =
The Pro version includes enhanced and customizable email templates for driver assigned, out for delivery, and completed delivery notifications.

= Can customers rate their delivery experience? =
Yes. Customers can rate deliveries through the Driver Ratings feature. These ratings are stored on the order and help track driver performance.

= What is the Admin Orders Monitor? =
The Admin Orders Monitor is an admin dashboard with filters, tabs, and a driver availability table that lets you monitor all orders and driver availability in one view. Use the shortcode `[delivery-drivers-orders-monitor]` to display it.

= Are there additional security controls in the Pro version? =
Yes. The Pro version includes additional permissions and security controls for admin workflows to provide more granular access management.

= Can customers apply to become drivers? =
Yes (Pro feature). You can display a public driver application form using the `[driver_application_form]` shortcode, allowing interested customers or third parties to apply as drivers.

= What shortcodes are available? =
The plugin provides: `[oddw_delivery_drivers_dashboard]` (driver dashboard), `[driver_application_form]` (public driver application form), `[delivery-drivers-orders-monitor]` (admin orders monitor), and `[oddw_dashboard]` (backward-compatible driver dashboard alias).

= How do I install and activate the plugin? =
Upload the plugin folder to /wp-content/plugins/, then activate it through the WordPress admin. Go to WooCommerce -> Settings -> Delivery Drivers to configure the plugin.

= What is the first step after activating the plugin? =
After activation, view the plugin settings in WooCommerce -> Settings -> Delivery Drivers, then create drivers manually or approve driver applications (Pro feature).

= How do I get started with driver assignment? =
Create WordPress users with the Driver role, assign them to orders using the Delivery Driver meta box during order editing, then drivers will see new orders in their Driver Dashboard and can update status.

= Do I need to add Google Maps integration to use the plugin? =
Google Maps integration is optional but highly recommended. To use it, configure your Google Maps API key in the plugin settings. The plugin functions without it, but the map feature will not be available.

== Screenshots ==

1. Admin view — assign driver and set delivery status
2. Order meta box with `Delivery Driver` select field
3. Frontend driver dashboard with map and actions
4. Order detail with status, product, map, and controls
5. Delivery Drivers Monitor
6. Delivery Drivers General Settings
7. Delivery Drivers SMS API Settings (PRO)
8. Delivery Drivers SMS Tempaltes Settings (PRO)
9. Delivery Drivers Email Tempaltes Settings (PRO)

== Changelog ==
= 1.2.0 =
* Pages settings added.
* default shortcodes pages generation on activation.
= 1.1.0 =
* Added Settings Tabs

= 1.0.0 =
* New: Google Maps integration in driver order view
* Tweak: UI improvements in dashboard templates
* Fix: Compatibility with WooCommerce 6.8

== Need Help? ==
* Get support on the [WordPress.org Support Forum](https://wordpress.org/support/plugin/delivery-drivers-for-woocommerce/)
* Access [Premium Support](https://wpsaad.com/support/)
* [YouTube Channel](https://www.youtube.com/@wpsaad)

== More by WPSaad ==
* [Shipping Manager for WooCommerce](https://wordpress.org/plugins/shipping-manager-for-woocommerce/) — [Pro Version](https://wpsaad.com/wp-plugins/shipping-manager-for-woocommerce/)
* [Custom Product Type for WooCommerce](https://wordpress.org/plugins/custom-product-type-for-woocommerce/) — [Pro Version](https://wpsaad.com/wp-plugins/custom-product-type-for-woocommerce/)
* [WPSaad Addons for Dokan and Elementor](https://wordpress.org/plugins/wpsaad-addons-for-dokan-and-elementor/) — [Pro Version](https://wpsaad.com/wp-plugins/wpsaad-addons-for-dokan-and-elementor/)
* [Bulk Wholesale Dynamic Pricing Buttons](https://wordpress.org/plugins/bulk-wholesale-dynamic-pricing-buttons-for-woocommerce/) — [Pro Version](https://wpsaad.com/wp-plugins/bulk-wholesale-dynamic-pricing-buttons-for-woocommerce/)
* [Product Add-Ons, Custom Fields, Booking and Extra Options](https://wordpress.org/plugins/product-add-ons-custom-fields-booking-extra-options-for-woocommerce/) — [Pro Version](https://wpsaad.com/wp-plugins/product-add-ons-custom-fields-booking-extra-options-for-woocommerce/)
* [Image Alt Text Manager – Bulk & Dynamic Alt Tags](https://wordpress.org/plugins/alt-manager/) — [Pro Version](https://wpsaad.com/wp-plugins/image-alt-text-manager-wordpress-plugin-for-images-seo/)

== Other Services ==
* [WordPress Design and Development Services](https://support.motkhases.com/%d8%a3%d9%81%d8%b6%d9%84-%d8%b4%d8%b1%d9%83%d8%a9-%d8%aa%d8%b5%d9%85%d9%8a%d9%85-%d9%85%d9%88%d8%a7%d9%82%d8%b9-%d9%81%d9%8a-%d9%85%d8%b5%d8%b1-%d9%88%d8%a7%d9%84%d9%88%d8%b7%d9%86-%d8%a7%d9%84%d8%b9/)
* [WordPress Professional Support Services](http://support.motkhases.com/)


== License ==

This plugin is licensed under the GPLv2 or later.

== External Services ==

This plugin uses Google Maps to show delivery directions and maps inside the driver order view.

Data sent and when:
* The delivery address and store address are sent to Google Maps when a driver opens an order that contains the map.
* A Google Maps link is generated for directions using the delivery address when the driver views the order details.

Service provider:
* Google Maps Platform (Google)
* Terms of Service: https://maps.google.com/help/terms_maps/
* Privacy Policy: https://policies.google.com/privacy
