Dispatchr is a complete courier and logistics management system built in PHP. It provides three separate panels — Admin, Client, and Driver — for end-to-end shipment management, from booking to delivery.

Key features:

• Real-time parcel tracking with public tracking page
• 24+ payment gateways (Stripe, PayPal, Paystack, crypto, and more)
• Driver marketplace with delivery offers, commission system, and wallet
• Client portal with shipment creation, wallet top-up, and invoices
• Email, WhatsApp, and SMS notifications with customizable templates
• Multi-language support, barcode generation, and shipping calculator
• Two-factor authentication, KYC verification, and role-based admin access
• Pre-alert system for online shopping consolidation
• Proof of delivery with photo upload
• Bulk actions, reports, and activity logging

Requirements: PHP 7.4+ (8.x recommended), MySQL 5.7+.

ADMIN PANEL

• Interactive dashboard with KPIs, charts, and quick stats
• Parcel management — create, edit, delete, bulk actions, inline status updates
• Client management — view, edit, email, reset password, impersonate login
• Driver management — approve, suspend, assign, view performance
• Employee management with role-based access (manager, agent, accountant, dispatcher, support, super_admin)
• Delivery offers marketplace — review and approve/reject driver bids
• Driver withdrawal requests — approve/reject with admin notes
• Invoices with print and email functionality
• Shipping rate configuration with pricing zones
• Consolidation management for grouped shipments
• Pre-alert system for online shopping packages
• Support ticket system with threaded replies
• Live chat with clients and drivers (real-time messaging)
• Bulk email tool for client communication
• KYC document verification
• Customizable email templates
• WhatsApp message templates with status triggers
• Multi-currency support with exchange rates
• Multi-language system with translation management
• CMS pages — edit About, Privacy, Terms, FAQ, and service pages
• Activity log with full audit trail
• Webhook logs for payment debugging
• Site settings — branding, logo, favicon, contact info, SEO
• System info page with server/database diagnostics
• SMTP configuration with built-in connection tester
• Session timeout with warning modal
• Label printing with Code128 barcodes

CLIENT PANEL

• Dashboard with wallet balance, KPI stats, recent shipments, quick track
• Shipment creation with weight, dimensions, and volumetric calculation
• Shipment tracking with timeline history
• Invoice list with payment status and print view
• Wallet system — balance, top-up via payment gateways, transaction history
• Pre-alert submission for online shopping orders
• Profile management with password change
• Support tickets with file attachments
• Two-factor authentication (email OTP)
• Email verification on registration
• Live chat with admin support

DRIVER PANEL

• Dashboard with delivery stats and earnings overview
• Available delivery offers — browse and accept open parcels
• My deliveries — update status, upload proof of delivery photos
• Commission system — automatic wallet credit on delivery completion
• Wallet with balance, transaction history, and withdrawal requests
• Profile management with vehicle details
• Support tickets
• Two-factor authentication (email OTP)
• Parcel detail drawer with full shipment info

PAYMENT GATEWAYS (14+)

Stripe, PayPal, Paystack, Razorpay, Flutterwave, Mollie, Monnify, PayMongo, Coinbase Commerce, CoinGate, NowPayments, Cryptomus, Binance Pay, BTCPay Server

PUBLIC WEBSITE

• 3 homepage themes (Couriq, Shipify, Swiftly)
• Public tracking page — track by number, receiver name, or ZIP code
• Shipping calculator
• Contact form with reCAPTCHA
• 6 service pages (Air Freight, Sea Freight, Road Transport, Warehousing, Express Delivery, International Shipping)
• About, FAQ, Privacy Policy, Terms of Service pages
• Multi-language frontend with language switcher
• Dark/light theme support
• Fully responsive mobile design

NOTIFICATIONS

• Email via SMTP (Gmail, Outlook, SendGrid, Mailgun, etc.)
• WhatsApp via Meta Cloud API / UltraMSG
• SMS via Twilio or generic API
• In-app notification center for clients and drivers
• Automated status change notifications across all channels

SECURITY

• CSRF protection on all forms
• Prepared statements (zero raw SQL)
• bcrypt password hashing with complexity requirements
• Session security (HttpOnly, Secure, SameSite cookies)
• Two-factor authentication (email OTP)
• Login rate limiting with lockout
• Google reCAPTCHA v2
• XSS prevention with output escaping
• Constant-time webhook signature verification
• SSL/TLS certificate verification on SMTP
• Upload validation with MIME checking
• .htaccess security headers and directory protection

Server Requirements

• PHP 7.4 or higher (8.0+ recommended, 8.2 compatible)
• MySQL 5.7+ or MariaDB 10.3+
• Apache 2.4 with mod_rewrite enabled

Required PHP Extensions

• mysqli
• GD (barcodes and image processing)
• cURL (payment gateways and external APIs)
• mbstring (UTF-8 text handling)
• OpenSSL (SMTP encryption)

Recommended

• 512 MB RAM minimum (1 GB+ recommended)
• 100 MB disk space + storage for uploads
• SSL certificate (HTTPS) for secure sessions and payment webhooks
• SMTP email account (Gmail, Outlook, SendGrid, etc.)
• Cron job access (optional, for scheduled tasks)

Browser Support

• Chrome, Firefox, Safari, Edge (latest versions)
• Fully responsive — mobile, tablet, and desktop

DISPATCHR - INSTALLATION GUIDE
================================

REQUIREMENTS
------------
- PHP 7.4+ (8.0+ recommended, 8.2 compatible)
- MySQL 5.7+ / MariaDB 10.3+
- Apache 2.4 with mod_rewrite enabled
- PHP Extensions: mysqli, GD, cURL, mbstring, OpenSSL

INSTALLATION
------------
1. Create your sql database and set the permissions right

2. Upload the script to your server document root and extract

3. Make sure the files are moved to your main folder. Not inside the dispatchr folder

4. Copy .env.example to .env and fill in your database credentials
5. Download your database from db/DATABASE.sql and upload to your phpmyadmin
6. Open https://yourdomain.com

Admin Login: [email protected] / password

User demo login: [email protected]

Password: Test1234

Driver demo login: [email protected]

Password: Test1234

Change the default password immediately

ENVIRONMENT FILE (.env)
-----------------------
DB_HOST=localhost
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password
DB_NAME=your_db_name

ADMIN CONFIGURATION
-------------------
1. Admin > Site Settings      - Company name, logo, address, contact info
2. Admin > Settings > Email   - SMTP host, port, username, password
3. Admin > Settings > Payment - Payment gateway API keys
4. Admin > Settings > Drivers - Commission rate (e.g. 10%)
5. Admin > Settings > Security - 2FA, reCAPTCHA, login limits
6. Admin > Shipping Rates     - Pricing zones and weight-based rates
7. Admin > Languages          - Enable multi-language support

PAYMENT GATEWAYS
----------------
Webhook URL: https://yourdomain.com/webhook...

Supported: Stripe, PayPal, Paystack, Razorpay, Flutterwave, Mollie,
Monnify, PayMongo, Coinbase Commerce, CoinGate, NowPayments,
Cryptomus, Binance Pay, BTCPay Server

DRIVER COMMISSION
-----------------
1. Set rate in Admin > Settings > Drivers (e.g. 10%)
2. Assign a driver to the parcel
3. Commission auto-credits when parcel marked as Delivered
4. Drivers request withdrawals from their wallet page
5. Admin approves in Admin > Withdrawals