=== Velocentra AI Logistics ===
Contributors: bedebanks
Tags: logistics, delivery, dispatch, rider management, tracking
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.8.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered logistics and delivery management system with dispatching, rider management, tracking, notifications, and analytics.

== Description ==

Velocentra AI Logistics is a modern logistics and delivery management plugin for WordPress. It helps delivery businesses, dispatch teams, courier companies, and local service providers manage pickup requests, riders, customers, delivery statuses, tracking, notifications, and operational activity from one organized dashboard.

The plugin is designed for businesses that need a practical logistics workflow inside WordPress without depending on complex external software. It brings together request intake, rider coordination, customer tracking, delivery updates, proof of delivery workflows, analytics, and settings in a clean admin experience.

Velocentra AI Logistics is useful for courier services, last-mile delivery providers, dispatch startups, retail delivery teams, pharmacy delivery services, grocery delivery businesses, internal logistics teams, and growing service companies that need better visibility over delivery operations.

= What You Can Do With Velocentra AI Logistics =

* Receive pickup and delivery requests from the frontend.
* Manage pickup requests from the WordPress dashboard.
* Assign and monitor riders.
* Track delivery statuses.
* Provide customers with a tracking page.
* Manage riders, customers, branches, and zones.
* View delivery analytics and operational summaries.
* Send delivery workflow notifications.
* Manage proof of delivery information.
* Configure pricing, payment modes, appearance, notifications, and tracking options.
* Display frontend portals through shortcodes.
* Automatically create required frontend pages during activation.

= Frontend Delivery Pages =

Velocentra AI Logistics can automatically create the essential frontend pages required for customer and rider workflows. These pages help site visitors submit pickup requests, track deliveries, access customer delivery information, and allow riders to interact with assigned delivery workflows.

The plugin checks for required pages during activation and avoids duplicate page creation by detecting existing pages and shortcodes before creating missing pages again.

= Delivery Request Management =

The request dashboard helps administrators review pickup requests, customer details, delivery addresses, package details, payment mode, request status, rider assignment, and operational notes.

This gives delivery teams a central place to process new requests and follow deliveries from submission to completion.

= Rider Management =

Velocentra AI Logistics includes rider management tools for keeping rider records organized. Administrators can manage rider information, availability, assignment workflows, and delivery activity from the dashboard.

= Customer Tracking =

Customers can track deliveries using a tracking code. The tracking page provides a simple delivery visibility experience so customers can follow delivery progress without contacting support for every update.

= Analytics and Reporting =

The analytics dashboard provides useful operational visibility into request activity, delivery performance, rider activity, and logistics trends. This helps administrators understand how delivery operations are performing and identify areas that need attention.

= Settings and Configuration =

The settings area includes options for pricing, payment modes, rider settings, tracking settings, appearance settings, AI assistant settings, notifications, and frontend shortcode visibility. The settings are designed to be practical, organized, and easy to understand.

= Shortcodes =

Velocentra AI Logistics includes frontend shortcodes for adding logistics functionality to WordPress pages. A Shortcodes section inside the settings area displays the available shortcodes in neat cards with copy options.

= WordPress.org Package =

This WordPress.org package is a standalone logistics and delivery management plugin. It is fully functional as distributed and does not require a license key, trial period, quota unlock, or paid activation to use its included features.

= About Velocentra Logistics Pro =

A separate Pro plugin is available outside WordPress.org for businesses that need additional advanced logistics tools.

Pro features may include:

* WooCommerce delivery integration.
* Advanced dispatch automation.
* Delivery scheduling and checkout delivery preferences.
* Advanced analytics and operational intelligence.
* GPS rider intelligence.
* Smart rider suggestions.
* Advanced customer communication workflows.
* Branch-aware request flows.
* Enhanced proof of delivery tools.
* Enterprise workflow controls.

The Pro plugin is separate from this WordPress.org package. The free plugin remains fully functional and does not include locked local features.

Learn more about the separate Pro plugin:
https://plugins.entitude.com/plugins/velocentra-ai-logistics

= External Services =

This plugin may optionally connect to third-party services only when the related settings are configured by the site administrator.

Google Maps APIs may be used for address-related features, places search, maps, distance calculations, and delivery location assistance when a Google Maps API key is configured.

Google Maps Platform is provided by Google.
Terms: https://cloud.google.com/maps-platform/terms
Privacy: https://policies.google.com/privacy

Paystack checkout scripts may be loaded when Paystack payment settings are configured and enabled by the site administrator.

Paystack is provided by Paystack.
Terms: https://paystack.com/terms
Privacy: https://paystack.com/privacy/merchant

Flutterwave checkout scripts may be loaded when Flutterwave payment settings are configured and enabled by the site administrator.

Flutterwave is provided by Flutterwave.
Terms: https://flutterwave.com/us/terms
Privacy: https://flutterwave.com/us/privacy-policy

Stripe checkout scripts may be loaded when Stripe payment settings are configured and enabled by the site administrator.

Stripe is provided by Stripe.
Terms: https://stripe.com/legal
Privacy: https://stripe.com/privacy

Entitude plugin information links may be used for product documentation, policy pages, and optional Pro plugin information.

Entitude is provided by Entitude.
Terms: https://entitude.com/policies/terms
Privacy: https://entitude.com/policies/privacy

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/velocentra-ai-logistics` directory, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Open Velocentra AI Logistics from the WordPress admin menu.
4. Review the automatically created frontend pages.
5. Configure pricing, riders, tracking, notifications, appearance, and other available settings.
6. Add or review shortcodes from the Shortcodes section inside Settings.

== Frequently Asked Questions ==

= Is Velocentra AI Logistics free to use? =

Yes. The WordPress.org package is fully functional as distributed and does not require a license key, paid activation, trial unlock, or quota unlock to use the included features.

= Does the plugin create frontend pages automatically? =

Yes. During activation, the plugin can create the required frontend pages for pickup requests, delivery tracking, customer access, and rider access. It checks for existing pages before creating new ones to avoid duplicates.

= Can customers submit pickup requests from the frontend? =

Yes. The plugin includes frontend request functionality that allows customers to submit pickup and delivery request information.

= Can customers track deliveries? =

Yes. Customers can use a tracking code to view delivery progress through the tracking page.

= Can I manage riders? =

Yes. The plugin includes rider management tools in the WordPress dashboard.

= Does Velocentra AI Logistics include analytics? =

Yes. The dashboard includes analytics and operational summaries to help administrators understand request activity, rider activity, and delivery workflow performance.

= Does the plugin support shortcodes? =

Yes. The plugin includes shortcodes for frontend logistics pages. You can view the available shortcodes from the Shortcodes section inside Settings.

= Does this plugin work with WooCommerce? =

WooCommerce delivery integration is available through a separate Pro plugin. The WordPress.org package remains fully functional without WooCommerce integration.

= Is there a Pro plugin? =

Yes. A separate Pro plugin is available for advanced logistics needs such as WooCommerce integration, advanced analytics, delivery scheduling, GPS rider intelligence, and expanded automation.

= Will the free plugin stop working if I do not use Pro? =

No. The WordPress.org package is standalone and remains fully functional for the features included in it.

= Is the plugin translation ready? =

Yes. The plugin uses WordPress internationalization functions and includes a text domain for translation support.

= What PHP version is required? =

The plugin requires PHP 7.4 or higher.

= Is the plugin compatible with WordPress 7.0? =

Yes. The plugin metadata declares compatibility with WordPress 7.0.

== Screenshots ==

1. Admin dashboard overview showing logistics activity, request statistics, and operational summaries.
2. Dashboard pickup requests page for managing submitted delivery and pickup requests.
3. Dashboard riders page for organizing rider records and delivery team activity.
4. Dashboard analytics page showing delivery activity, operational metrics, and request insights.
5. Dashboard settings page for configuring pricing, tracking, appearance, notifications, and plugin behavior.
6. Frontend pickup request page where customers can submit delivery request details.
7. Rider portal page for rider-facing delivery workflow access.
8. Track delivery page where customers can check delivery progress using a tracking code.

== Changelog ==

= 2.8.4 =
* Expanded and improved the WordPress.org readme.txt file with a professional long description.
* Added clearer value proposition and SEO-friendly logistics, delivery, dispatch, tracking, and rider management wording.
* Added detailed FAQ entries for installation, frontend pages, tracking, riders, analytics, shortcodes, WooCommerce, and Pro information.
* Added screenshot descriptions for admin dashboard, requests, riders, analytics, settings, pickup request page, rider portal, and tracking page.
* Added a WordPress.org-compliant Pro features overview that references a separate Pro plugin without locking included functionality.
* Added clearer external service disclosures and policy links.
* Updated version references to 2.8.4.

= 2.8.3 =
* Added a full-width Velocentra Logistics Pro informational banner to the Dashboard and Analytics pages in the WordPress.org package.
* Added six colorful Pro feature cards and a Get Velocentra Logistics Pro CTA linking to the separate Pro product page.
* Preserved the existing dashboard and analytics layouts without changing core functionality.

= 2.8.2 =
* Updated plugin version references.
* Revalidated URLs referenced in readme.txt.
* Confirmed Author URI, Terms of Service URL, and Privacy Policy URL.

== Upgrade Notice ==

= 2.8.4 =
This release improves the WordPress.org readme, plugin description, FAQ, screenshot documentation, Pro feature information, and repository metadata.
