What you get#
A complete website and back office for a courier company. It is plain PHP and SQLite, so it runs on ordinary cPanel or DirectAdmin hosting with no build step and no database to create.
| Area | Where | What it does |
|---|---|---|
| Admin | /admin | Dashboard with KPIs, shipments (table and board), dispatch, live map, pickups, incidents and claims, drivers, vehicles, branches, invoices, cash on delivery, zones and rates, reports, customers, activity log, staff roles, backups and email |
| Customer portal | /customer | Passwordless sign-in by email link. Book with an instant quote, track on a map, pay invoices, address book, pickup requests |
| Rider app | /driver | Phone sign-in with a PIN. Today's jobs, call and navigate, pick up, deliver with signature and photo, report a failed attempt, cash held |
| Public site | / | Services, pricing, tracking page with live route map, quote request, contact, blog and careers |
Requirements#
| Item | Needed |
|---|---|
| PHP | 8.1 or newer |
| PHP extensions | pdo_sqlite, sodium, mbstring, curl, fileinfo |
| Database | None to create: SQLite is built in and stored in the data folder |
| Other | HTTPS and one cron job |
Install on cPanel or DirectAdmin#
- Upload and extract
Upload the zip to the folder your domain points at and extract it.
- Open your domain
The installer starts by itself. It checks the server (PHP version, extensions, writable
datafolder and.env), asks for your company name, website address, currency and administrator login, then locks itself. - Add the cron job
Every minute. It sends scheduled emails and runs backups.
php /home/USER/public_html/cron-process-queue.php - Sign in at /admin
Use the administrator you just created. There are no default passwords.
First-time setup#
Make it yours#
Pricing: Zones and rates
The rate card is zone to zone, per service. On top of it you can set surcharges for fuel, insurance, cash on delivery and VAT, and use volumetric weight for bulky parcels. Everything works in naira or any currency you set. Use the Try a quote box on the same page to check a price before customers see it.
- Create your zones
Group your cities, states or areas into zones.
- Fill in the rate card
Set the price from each zone to each other zone, for each service level.
- Set surcharges and tax
Fuel, insurance, COD and VAT.
- Try a quote
Enter an origin, destination and weight, and compare with what you expect.
Company details and maps
Under Company and payments change the company name, currency, address, opening hours and contact details shown across the site. Maps use OpenStreetMap tiles by default; for a busy site add a tile provider address in the same page.
Team and roles
Staff roles are admin, support and finance. Turn on two-factor sign-in for staff, who are signed out after 30 minutes idle.
Import and export
Shipments can be imported and exported as CSV, and acted on in bulk from the table or board view.
Payments#
Customers can pay invoices with Paystack, Stripe or bank transfer. Add the keys and your bank details under Company and payments.
Riders and the phone app#
- Add the rider
Under Drivers, add the person and set their PIN.
- Share the link
Riders open
https://yourdomain.com/driveron their phone and sign in with their number and PIN. Add it to the home screen for an app-like feel. - Assign jobs
Use Dispatch to give parcels to riders, individually or with auto-assign.
- Proof of delivery
Riders pick up, deliver with signature and photo, or report a failed attempt. Proof files are private and shown only to staff, the rider and the customer they belong to.
Activate your licence#
A new install runs free for 14 days. After that pages stay open but changes are refused until a licence key for this domain is entered under Admin, Licence. Copy the key from My licences on Biply Market.
Backups and updates#
Two habits keep a live site safe: backups before every change, and updates from your own dashboard only.
What to back up
Back up the data folder (your SQLite database and uploaded files) and the .env file. Admin, Backups can also create backups for you; download them off the server.
Installing a new version
- Back up first
Copy the files and database as described above. Keep the copy somewhere other than the server.
- Download the new release
Sign in to Biply Market, open My licences and download the latest signed zip. Releases are only available to licence holders.
- Upload and overwrite
Extract the zip over your existing files. Do not delete your data folder or
.envfile: they hold your settings and customers. - Check the release notes
Each release says whether the database changes. If you have no terminal access, email [email protected] and we will apply it for you.
- Open the site and test
Sign in as an administrator and check one normal action before you tell customers.
Security checklist#
Every change is a POST with a token, tracking codes are 10 random characters, public forms and lookups are rate limited and every action is written to the activity log.
Troubleshooting#
| Symptom | Likely cause and fix |
|---|---|
| The installer says a check failed | Enable the missing extension in Select PHP Version, and make the folder and data writable. |
| Customers do not receive sign-in links | Email sending is not configured, or the message went to spam. Set it up and send a test. |
| The map is blank or slow | Add a tile provider address under Company and payments. |
| Scheduled emails or backups never run | Add the cron line the installer showed, with the correct path to PHP. |
| Changes are refused | The 14-day trial ended. Enter your licence key under Admin, Licence. |
| The site stopped after an edit | A protected file was changed. Restore the original from your download. |
Getting help and customisation#
You are never on your own with a Biply script.
After you buy, tell us and we install Sub Delivery on your hosting at no extra cost.
Email [email protected] with your domain and a description or screenshot of the problem.
Need your own features, integrations or branding? Hire Biply Agency for a written quote.