Download the PHP package susheelbhai/laraship without Composer
On this page you can find all versions of the php package susheelbhai/laraship. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download susheelbhai/laraship
More information about susheelbhai/laraship
Files in susheelbhai/laraship
Package laraship
Short Description Multi-provider shipping integration for Laravel e-commerce applications
License MIT
Informations about the package laraship
Laraship - Laravel Multi-Provider Shipping Integration
A comprehensive Laravel package for integrating multiple shipping providers with full CRUD UI and order integration.
Features
- 25 shipping provider adapters (Indian and International)
- Pickup address management per provider (API-based, no .env required)
- Rate calculation and comparison
- Automated shipment booking
- Real-time tracking
- Webhook support for status updates
- Admin UI for provider management
- User-facing tracking interface
- Queue support for async operations
- Event-driven architecture
Installation
Local Development (Symlink)
If you have the package source locally (e.g. as a git submodule or cloned alongside your project), use a path repository with symlink for instant changes:
Then require it:
Quick Install (Recommended - Automated)
The package includes an automated installer that handles all file modifications:
The installer will:
- ✅ Publish all assets (config, migrations, controllers, routes, components)
- ✅ Run migrations and seeders
- ✅ Automatically modify 12 project files
- ✅ Prompt you to confirm each change
See AUTOMATED_INSTALLATION.md for complete automated installation guide.
Manual Installation
If you prefer manual control, see the sections below.
Publishing Assets
1. Publish Configuration
2. Publish Migrations
3. Publish Controllers
This publishes:
app/Http/Controllers/Admin/ShippingProviderController.phpapp/Http/Controllers/Admin/OrderShipmentController.php
4. Publish Form Requests
This publishes:
app/Http/Requests/ShippingProviderRequest.php
5. Publish React Components
This publishes:
- Admin CRUD pages:
resources/js/pages/admin/resources/shipping_provider/ - Shipping components:
resources/js/components/shipping/
6. Publish Routes
Admin Routes
This publishes routes/admin/laraship.php
Include in your routes/web.php:
User Routes
This publishes routes/user/laraship.php
Include in your routes/user/web.php:
Webhook Routes (Public)
This publishes routes/admin/laraship_webhook.php
Include in your routes/web.php:
⚠️ IMPORTANT: Webhook routes MUST be publicly accessible. Shipping providers (Delhivery, FedEx, etc.) cannot authenticate to your application. If you put these routes behind authentication, webhooks will fail.
Security is handled through:
- Signature verification (cryptographic signatures)
- Rate limiting (60 requests/minute)
- Webhook logging (audit trail)
Publish All Routes at Once
7. Publish Seeders (Optional)
8. Publish Notifications (Optional)
This publishes notification classes to app/Notifications/Laraship/ for customization.
See NOTIFICATION_CUSTOMIZATION_GUIDE.md for details.
Quick Install (All at once)
Configuration
Environment Variables
Model Setup
Add traits to your models:
Product Model:
Order Model:
Supported Providers
Indian Providers (21)
- Mock Provider (Testing)
- Delhivery
- DTDC
- Bluedart
- Shiprocket
- India Post
- Ecom Express
- Xpressbees
- Shadowfax
- Dunzo
- Ekart (Flipkart)
- Amazon Transport
- Gati
- Shyplite
- Pickrr
- iThink Logistics
- Vamaship
- Professional Couriers
- Trackon
- VRL Logistics
- TCI Express
International Providers (4)
- FedEx
- DHL
- Aramex
- UPS
Usage
Wallet Management
For detailed information on checking balances and recharging wallets, see WALLET_MANAGEMENT.md.
Quick example:
Admin Panel
- Navigate to
/admin/shipping_providerto manage providers - Add provider credentials
- Enable/disable providers
- Set priority for rate calculation
Manual Webhook Testing (Mock Provider)
For testing webhooks without real provider APIs:
- Navigate to
/admin/manual-webhook - Select a Mock provider shipment
- Choose new status and details
- Send webhook to test the flow
See MANUAL_WEBHOOK_TESTING_GUIDE.md for details.
Order Integration
The package automatically integrates with your order show pages:
Admin Order Page:
User Order Page:
Programmatic Usage
Wallet Management
Check wallet balance and recharge for providers that support it (e.g., Shiprocket):
Using with ShippingProvider Model:
Controller Example:
Events
ShipmentStatusUpdated- Fired when shipment status changesShipmentBooked- Fired when shipment is successfully booked
Notifications
ShipmentStatusNotification- Sent to customers on status updatesShipmentBookedNotification- Sent when shipment is bookedShipmentDeliveredNotification- Sent when shipment is delivered
Queue Jobs
ProcessShipmentBooking- Async shipment bookingUpdateShipmentStatus- Async status updatesSyncTrackingInfo- Periodic tracking sync
License
MIT
Support
For issues and feature requests, please use the GitHub issue tracker.