T Booking ยท Documentation

T Booking

A complete, mobile-first bus ticket booking platform built with Laravel 13 โ€” live seat maps, multi-language, multi-currency, online payments, PDF e-tickets and a full admin panel.

  • Laravel 13
  • PHP 8.3+
  • MySQL / MariaDB
  • 9 languages + RTL
  • 58 currencies
  • Web installer

Thank you for choosing T Booking by Anow Hosting. This guide explains how to install the script on shared hosting (cPanel) or a VPS, how to configure payments, e-mail and other services, and how to use the admin and operator panels.

For travellers

  • Search, filters, compare buses
  • Interactive seat map (8 layouts)
  • Card, PayPal, UPI, bank transfer, wallet
  • PDF e-ticket with QR & barcode
  • Live bus tracking, reviews

For your business

  • Admin panel with 23 modules
  • Operator (bus company) panel
  • Dynamic pricing & coupons
  • Reports with PDF / CSV export
  • Roles & granular permissions

Built to sell worldwide

  • 9 languages incl. Tamil, Sinhala, Hindi, Arabic (RTL)
  • 58 currencies with live rates
  • SEO: sitemaps, hreflang, schema.org
  • PWA, dark mode, REST API

Screenshots

Tap any image to enlarge it.

Home page with the bus-shaped header and search
Home page & search
Search results with filters
Search results & filters
Interactive seat map
Interactive seat selection
Arabic right-to-left layout in dark mode
Arabic (RTL) in dark mode
Admin dashboard
Admin dashboard
Seat layout templates
Seat layout builder
Mobile home page in Tamil
Mobile ยท Tamil
Mobile menu
Mobile menu
Seat map on mobile
Mobile seat map
Admin bookings on mobile
Mobile admin
Installer requirements check
Installer ยท requirements
Installer site and admin step
Installer ยท admin account

Server requirements

RequirementVersion / note
PHP8.3 or newer (8.3, 8.4 and 8.5 are supported)
DatabaseMySQL 5.7+ / 8.x or MariaDB 10.4+
Web serverApache with mod_rewrite (cPanel default), LiteSpeed, or Nginx
PHP extensionspdo_mysql, mbstring, openssl, tokenizer, xml, dom, ctype, json, curl, fileinfo, bcmath, gd, zip ยท intl recommended
CronOne cron job running every minute (see Cron job)
SSLRecommended (required by most payment gateways in live mode)

cPanel tip: open MultiPHP Manager (or Select PHP Version), tick your domain, choose PHP 8.3 or newer and make sure the extensions above are enabled. The web installer checks everything for you and tells you exactly what is missing.

Important: cPanel saves the chosen PHP version as a line inside the .htaccess file of your site. When you upload T Booking, its .htaccess replaces that file and the domain can silently fall back to an older โ€œInheritedโ€ PHP (for example 8.1). After uploading, open MultiPHP Manager and select PHP 8.3 again. If the site shows โ€œPHP 8.3 or newer is requiredโ€, this is the reason.

Package contents

T-Booking/
โ”œโ”€โ”€ documentation/      โ† this guide (open index.html in a browser)
โ”œโ”€โ”€ mobile-apps/        โ† Flutter source of the two apps + codemagic.yaml (not uploaded to hosting)
โ”œโ”€โ”€ sql/                โ† tbooking-demo.sql / tbooking-clean.sql for a manual install (phpMyAdmin)
โ””โ”€โ”€ upload/             โ† upload the CONTENTS of this folder to your hosting
    โ”œโ”€โ”€ .htaccess       โ† serves the site from public/ and protects all other files
    โ”œโ”€โ”€ .env.example    โ† settings template: the installer turns it into .env
    โ”œโ”€โ”€ VERSION         โ† the version of these files (used by the automatic update)
    โ”œโ”€โ”€ app/ bootstrap/ config/ database/ lang/ resources/ routes/ storage/ vendor/
    โ””โ”€โ”€ public/         โ† index.php, compiled CSS/JS (build/), images, installer (install/)

All PHP libraries (vendor/) and compiled assets (public/build/) are included, so you do not need Composer, Node.js or SSH.

cPanel installation (one folder)

The whole application goes into a single folder โ€” usually public_html. The included .htaccess serves every request from the public/ folder, so .env, the source code and your data can never be opened from a browser.

  1. Create a database. In cPanel open MySQLยฎ Databases: create a database (e.g. cpuser_tbooking), create a user with a strong password, then use Add User To Database and tick ALL PRIVILEGES.
  2. Upload the files. Compress the contents of the upload folder into a ZIP on your computer (or use the ZIP you downloaded), open cPanel โ†’ File Manager โ†’ public_html, click Upload, then Extract. Make sure .htaccess, .env.example, app/, public/, vendor/โ€ฆ are now directly inside public_html (enable Settings โ†’ Show Hidden Files to see the dot-files). Remove any old index.html.
  3. Open your website. Visit https://yourdomain.com โ€” you are taken to the installer at /install/ automatically.
  4. Requirements. The installer checks your PHP version, extensions and folder permissions. Fix anything marked Missing (see the tip above), then press Continue.
  5. Database. Keep New installation selected and enter the host (localhost on cPanel), database name, username and password from step 1. The connection is tested before you can continue.
  6. Website & administrator. Enter your site name, confirm the website address (use https:// if you have SSL), and create your administrator account. Tick Import demo data for a complete example site (operators, buses, routes, 14 days of trips, bookings, blog, coupons), or leave it unticked for a clean site.
  7. Install. Tables and data are created in about 10โ€“60 seconds. The installer then locks itself; it cannot be run again unless you unlock it manually.
  8. Add the cron job shown on the last screen (see Cron job) and you are live.
  9. PHP version: if you changed it in MultiPHP Manager, check it once more after uploading (cPanel keeps the setting in .htaccess).
Installer requirements
Requirements
Installer site step
Site & admin
Installer finished
Finished

Demo accounts. When demo data is imported, these accounts are created: admin@tbooking.com / Admin@123456, operator@tbooking.com / Operator@123456, agent@tbooking.com / Agent@123456, customer@tbooking.com / Customer@123456. Delete them or change their passwords in Admin โ†’ Users before going live. Your own administrator account is always created with the e-mail and password you entered.

Manual install (SQL import, no installer)

Prefer phpMyAdmin, or the web installer cannot run on your hosting? Install by hand in five steps. The sql/ folder of the package contains two ready-made databases:

FileContents
sql/tbooking-demo.sqlComplete demo site: operators, buses, routes, schedules, trips, bookings, blog, coupons and the demo accounts
sql/tbooking-clean.sqlClean site: roles, languages, currencies, templates, cities, bus types, seat layout templates, pages, FAQs and one administrator
  1. Create a database and user in cPanel โ†’ MySQLยฎ Databases (ALL PRIVILEGES).
  2. Import the SQL: cPanel โ†’ phpMyAdmin โ†’ select your database โ†’ Import โ†’ choose tbooking-demo.sql or tbooking-clean.sql โ†’ Import.
  3. Upload the files of the upload folder into public_html (see the cPanel installation above) and select PHP 8.3 in MultiPHP Manager.
  4. Open your website. The installer opens. Continue to the Database step, choose โ€œUse my existing databaseโ€, enter the database name, username and password, and click Test connection & continue. The installer writes .env, creates the security key, locks itself and opens your website โ€” nothing is deleted.
  5. Log in at /admin with admin@tbooking.com / Admin@123456. Change this e-mail and password immediately in My profile. Then add the cron job.

Without the installer: rename .env.example to .env, fill in APP_URL, DB_DATABASE, DB_USERNAME, DB_PASSWORD and set APP_INSTALLED=true (leave APP_KEY= empty โ€” it is created on the first visit). Wrap passwords that contain spaces or # in single quotes: DB_PASSWORD='my#pass'. cPanel adds your account prefix to database and user names (e.g. cpuser_).

The demo trips cover the 14 days after the SQL file was created. With the cron job running, new trips are created from the schedules automatically every day; you can also add trips in Admin โ†’ Trips.

Install in a subfolder

To run T Booking at an address such as https://yourdomain.com/booking, create the folder public_html/booking, upload and extract the files there, and open https://yourdomain.com/booking. The installer detects the address automatically, and all links and assets are generated for the subfolder.

Document root on /public (optional, recommended for VPS)

If you can choose the document root of your domain (addon domains, subdomains, VPS), upload the files to a folder such as /home/cpuser/tbooking and point the domain's document root to /home/cpuser/tbooking/public. This is Laravel's standard layout; the root .htaccess is then simply not used. Open the domain and the installer starts as described above.

VPS / manual install (SSH)

Developers who prefer the command line can skip the web installer:

cp .env.example .env          # then set APP_URL and DB_* values
php artisan key:generate
php artisan migrate --seed     # demo data;  or: php artisan migrate && php artisan db:seed --class=InstallSeeder
php artisan storage:link
php artisan config:cache && php artisan route:cache && php artisan view:cache

For a manual install, add APP_INSTALLED=true to .env (or create an empty storage/installed file) so visitors are never sent to the installer. With a clean install (InstallSeeder), create your administrator with php artisan tinker or register and assign the super-admin role.

Nginx

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/tbooking/public;
    index index.php;
    location / { try_files $uri $uri/ /index.php?$query_string; }
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~ /\.(?!well-known).* { deny all; }
}

On Nginx always point root to the public folder โ€” Nginx ignores .htaccess, so the one-folder layout is for Apache/LiteSpeed only.

Cron job & queue

T Booking needs one cron job. In cPanel โ†’ Cron Jobs, choose Once Per Minute (* * * * *) and use (replace the path with yours โ€” the installer shows the exact line):

cd /home/cpuser/public_html && php artisan schedule:run >> /dev/null 2>&1

If php is not found, use the full path, e.g. /usr/local/bin/php or /opt/cpanel/ea-php83/root/usr/bin/php.

TaskFrequencyWhat it does
tbooking:release-seatsevery minuteReleases seats held by unpaid bookings after the hold time
tbooking:exchange-ratesevery 6 hoursUpdates currency exchange rates
tbooking:generate-tripsdailyCreates trips 30 days ahead from recurring schedules
tbooking:trip-remindersregularlyE-mail/SMS reminders 24 h and 2 h before departure
tbooking:complete-tripsregularlyCompletes finished trips and asks travellers for a review
tbooking:price-alertsregularlyNotifies customers when a fare drops below their alert
tbooking:backupdailyDatabase backup (Admin โ†’ System โ†’ Backups)
tbooking:scheduled-reportsweeklyE-mails a performance summary to administrators

Queue: the package uses QUEUE_CONNECTION=sync, so e-mails and webhooks are sent immediately and no queue worker is needed on shared hosting. On a VPS you can switch to database or redis and run php artisan queue:work with Supervisor.

After installation โ€” checklist

  1. Admin โ†’ Settings โ†’ General: site name, contact e-mail/phone, WhatsApp number, address, default language, currency and timezone.
  2. Settings โ†’ Appearance: upload your logo (light and dark), favicon and social image; pick colours and font.
  3. Settings โ†’ Email & SMS: choose SMTP and enter your mail server so customers receive tickets.
  4. Settings โ†’ Payment gateways: enable Stripe, PayPal, Razorpay and/or bank transfer.
  5. Settings โ†’ Booking & pricing: seat hold time, tax, service fee, discounts and cancellation rules.
  6. Add operators, buses, routes and schedules (or edit the demo data).
  7. Review the Pages (Terms, Privacy, Refund policy) and FAQs in Marketing & content.
  8. Enable Force HTTPS in Settings โ†’ Security once SSL is active.

Running a public demo? Add DEMO_MODE=true to .env. Visitors can then log in with the demo accounts (shown on the login page) and try everything, but changes in the admin and operator panels, profile and password changes are not saved. Customers can still search, book and pay with the demo gateway.

Payment gateways

All gateways are configured in Admin โ†’ Settings โ†’ Payment gateways (keys are stored encrypted). You can also put them in .env. Customers pay in their chosen currency where the gateway supports it.

GatewayWhat you needNotes
Stripe (cards, Apple Pay, Google Pay)Publishable key, secret key, webhook signing secretCreate a webhook in the Stripe dashboard for checkout.session.completed pointing to https://yourdomain.com/payments/webhook/stripe
PayPalClient ID, secret, mode (sandbox / live)REST app from developer.paypal.com
Razorpay (UPI, cards, netbanking)Key ID, key secretFor Indian rupee payments
PayHere (Sri Lanka: Visa, Mastercard, Amex, eZ Cash, mCash, Genie, internet banking)Merchant ID, merchant secret, mode (sandbox / live)In PayHere โ†’ Settings โ†’ Domains & Credentials add your domain to get the merchant secret. Payments are confirmed on https://yourdomain.com/payments/webhook/payhere (sent automatically with every payment โ€” your site must be reachable from the internet, not localhost). Charges in LKR, USD, EUR, GBP or AUD. Test with a sandbox account from sandbox.payhere.lk first.
Bank transferYour bank details (text)Customer uploads a reference/receipt; confirm it in Admin โ†’ Bookings
Walletโ€”Refunds, referral bonuses and top-ups; can be combined with other methods
Demo gatewayโ€”For testing only; automatically hidden when APP_ENV=production

Card data is entered on the gateway's own hosted page, so it never touches your server.

Footer logos: upload the logos of the methods you accept under Payment gateways โ†’ Payment logos in the footer (PNG, JPG, WebP or SVG, any size). Each logo is fitted into an equal white tile, so wide, tall and square logos line up neatly on phones and computers. Without uploads, the names of the enabled gateways are shown.

E-mail (SMTP)

In Settings โ†’ Email & SMS set Mail driver to smtp and enter your server. For a cPanel mailbox this is usually host mail.yourdomain.com, port 465 with ssl (or 587 with tls), the full e-mail address as username and its password. For Gmail use an App password. The 19 e-mail templates (booking confirmation with PDF ticket, cancellation, refund, OTP, password reset, remindersโ€ฆ) are editable in Marketing & content โ†’ Email / SMS templates, in every language.

SMS & WhatsApp

SMS gateway options: Twilio (account SID, auth token, from number), Vonage, or a custom HTTP API using the placeholders {to} and {message}. WhatsApp notifications use the official WhatsApp Business Cloud API (token and phone number ID from Meta).

Social login (Google & Facebook)

Enable the providers in Settings โ†’ Integrations and enter the client ID and secret. Use these redirect / callback URLs in the Google Cloud console and Meta for Developers:

https://yourdomain.com/auth/google/callback
https://yourdomain.com/auth/facebook/callback

Customers can also log in with a one-time code (OTP) sent by e-mail or SMS, and every user can enable two-factor authentication (Google Authenticator / Authy).

Maps, analytics, chat & reCAPTCHA

Real-time seats (Pusher, optional)

Seat maps refresh automatically. For instant seat updates create a free app at pusher.com, add the keys to .env and enable Real-time seats in Settings โ†’ Integrations:

BROADCAST_CONNECTION=pusher
PUSHER_APP_ID=...
PUSHER_APP_KEY=...
PUSHER_APP_SECRET=...
PUSHER_APP_CLUSTER=ap2

Branding & appearance

In Settings โ†’ Appearance you can change: logos (header, dark mode, footer), favicon, social share image, seven brand colours, the header colour, font (Google Fonts), corner style, default colour mode (light / dark / system), the header style (bus-shaped header or plain white bar), home page sections and hero texts, plus custom CSS and JavaScript. Themes can be exported and imported as JSON.

Feature list

Search & booking

  • City auto-complete, one-way & round trip
  • Filters: price, time, bus type, operator, amenities, AC
  • Compare up to 3 buses
  • Live seat availability, seat hold timer
  • Boarding & dropping points
  • Add-ons: insurance, meals, extra luggage
  • Guest checkout & PNR lookup
  • Price alerts and sold-out waitlist

Seat layouts

  • Standard 2+2, semi-sleeper, sleeper 2+1
  • Luxury/VIP, double decker, mini bus
  • AC seater + sleeper, multi-axle
  • Drag & drop layout builder
  • Ladies-only, premium, accessible seats
  • Pinch-to-zoom on phones

Payments & money

  • Stripe, PayPal, Razorpay/UPI
  • Bank transfer with receipt upload
  • Wallet & partial wallet payments
  • Refunds to wallet or original method
  • Invoices, transactions, operator payouts

Tickets & notifications

  • PDF e-ticket with QR code & barcode
  • Public QR ticket verification
  • Calendar (.ics / Google) & WhatsApp share
  • E-mail, SMS, WhatsApp, in-app notifications
  • Bulk e-mail/SMS campaigns

Customers

  • E-mail, OTP, Google & Facebook login
  • Two-factor authentication
  • Saved passengers, booking history
  • Loyalty points, refer & earn
  • GDPR data export & account deletion

Global

  • 9 languages, Arabic RTL
  • 58 currencies, IP auto-detection
  • Translation editor with auto-translate
  • Dark mode, PWA, offline page
  • Mobile-first design, bus-shaped header

SEO & marketing

  • XML sitemaps with hreflang
  • Meta, Open Graph, Twitter cards, schema.org
  • 301 redirects & 404 monitor
  • Blog, pages, FAQs, banners, testimonials
  • Coupons (percent / fixed, limits, first booking)

Security

  • CSRF, XSS & SQL-injection protection
  • Rate limiting, reCAPTCHA v3
  • CSP & security headers, force HTTPS
  • IP blacklist, admin IP whitelist
  • Audit log, login activity, encrypted keys

Operations

  • Recurring schedules โ†’ automatic trips
  • Dynamic pricing (early bird, last minute, weekend, demand)
  • Reports with charts; PDF & CSV export
  • Backups, system health, recycle bin
  • REST API & signed webhooks

Admin panel

Open https://yourdomain.com/admin. The panel works on phones too (menu button top-left; tables turn into cards). Main areas:

AreaModules
OverviewDashboard (bookings, revenue, charts, live panel), Reports
OperationsBookings (incl. manual booking), Trips, Recurring schedules, Routes, Cities
FleetBuses, Seat layouts, Bus types, Amenities, Operators
CustomersUsers, Roles & permissions, Reviews, Messages
FinanceTransactions, Payments, Refunds, Operator payouts, Wallets, Coupons
Marketing & contentPages, Blog, Blog categories, FAQs, Banners & popups, Testimonials, Media library, Email/SMS templates, Bulk messages, Notification logs, Subscribers
SEOMeta tags, Redirects, 404 monitor, SEO tools & sitemap
SettingsGeneral, Booking & pricing, Appearance, Payment gateways, Email & SMS, Integrations, Mobile & features, SEO settings, Languages, Currencies, Webhooks
SystemSecurity settings, IP rules, Login activity, Backups, System logs, System health, Activity log, Recycle bin

Roles & permissions

RoleAccess
Super AdminEverything, including settings, roles and system tools
AdminDay-to-day management (configurable)
OperatorOperator panel only โ€” own buses, trips, bookings, reviews and revenue
AgentBookings and customers (e.g. counter staff); no settings or user management
CustomerWebsite and personal account

Create your own roles and tick individual permissions in Customers โ†’ Roles & permissions. Administrators can be required to use two-factor authentication.

Operator panel

Bus companies log in at https://yourdomain.com/operator to manage their fleet and trips, see bookings and passenger lists, reply to reviews and follow their revenue and commission. Create an operator in Fleet โ†’ Operators and link a user account with the operator role.

Buses, seat layouts & trips

  1. Seat layouts: start from one of the 8 templates or build your own with drag & drop (decks, rows, seat types, ladies/premium/accessible seats, blocked seats, driver and door position).
  2. Buses: assign operator, bus type, seat layout, amenities, photos and GPS tracking (each bus has a tracking token for GPS devices or a driver app).
  3. Cities: Admin โ†’ Cities โ†’ Import cities โ€” choose your country (246 countries, e.g. Sri Lanka, India, Nepal, Malaysiaโ€ฆ) and all of its towns and cities are added in a few seconds, with state/province and map position. Tick Remove the cities of all other countries to delete the demo cities of other countries (cities used by a route are kept). Missing a small town or bus stand? Upload a CSV file (name,state,country,latitude,longitude) or add it by hand.
  4. Routes: origin, destination, stops with times and distances. The city fields are searchable โ€” type a few letters to pick from thousands of towns.
  5. Recurring schedules: route + bus + departure time + days of the week + fare + boarding/dropping points. Trips are generated automatically by the cron job (30 days ahead). Single trips can also be added manually.
Import all towns of a country
Admin โ†’ Cities โ†’ Import cities

Pricing, coupons & refunds

Fares are stored in the base currency (USD by default) and converted for each visitor. Settings โ†’ Booking & pricing controls tax, service fee, child/senior/student/group discounts, early-bird and last-minute discounts, weekend and high-demand surcharges, loyalty points and referral bonuses. Coupons (percentage or fixed, minimum amount, maximum discount, usage limits, first-booking-only, route/operator/bus restrictions) are managed in Finance โ†’ Coupons. Cancellations follow the cut-off and charge you set; refunds go to the customer wallet instantly or back to the original payment method.

Languages & RTL

Included: English, Tamil, Sinhala, Hindi, French, Spanish, Arabic (right-to-left), Chinese and Japanese. URLs carry the language (/ta/โ€ฆ, /ar/โ€ฆ); the default language has no prefix. In Settings โ†’ Languages you can enable/disable languages, choose the default, and edit every text in the browser (with optional Google auto-translate). Content such as pages, FAQs, blog posts and e-mail templates can be written per language.

Currencies

58 currencies are included (LKR, INR, NPR, USD, EUR, GBP, AED, SARโ€ฆ). Visitors can pick a currency or have it detected from their location. Rates update automatically every 6 hours; you can set a manual rate per currency and a global markup in Settings โ†’ Currencies.

REST API & mobile apps

A versioned JSON API at /api/v1 covers everything an Android / iOS app (Flutter, React Native, Kotlin, Swift) needs. Users sign in with Laravel Sanctum bearer tokens. Choose the language with Accept-Language and the currency with X-Currency.

EndpointsDescription
GET /config, /meta, /payment-methodsApp start-up: branding, colours, feature switches, app version & store links, support contacts, languages, currencies
GET /cities, /operators, /routes, /popular-routes, /offers, /banners, /faqs, /pages/{slug}Catalog and home-screen content
GET /search, /trips/{id}, /trips/{id}/seatsSearch and live seat map
POST /auth/register, /auth/login, /auth/logout, /auth/forgot-password, GET|PUT|DELETE /auth/me, PUT /auth/passwordAccounts, profile, password, account deletion (required by the app stores)
GET|POST /bookings, GET /bookings/{pnr}, POST /bookings/{pnr}/pay, /cancel, /review, POST /bookings/lookupBook, pay, cancel, review; guests find a booking by PNR
GET|POST|PUT|DELETE /passengersSaved passengers
GET /notifications, POST /notifications/read, POST|DELETE /devicesIn-app notifications and push notification tokens (Firebase / APNs)
GET /walletWallet balance and transactions
GET|POST /tracking/{trip}Live bus position (GPS devices post with X-Tracking-Token)

Payments in the app: the wallet is paid inside the app. For cards, PayHere, PayPal, Razorpay and bank transfer the API returns a signed checkout_url that opens the secure web checkout in the app's browser โ€” no second login needed and no card data in the app. Tickets (ticket_url) are signed links too.

Full request/response examples and the typical app flow are in API.md in the upload folder. Outgoing webhooks (booking.confirmed, booking.cancelled) are signed with X-TBooking-Signature (HMAC-SHA256).

Mobile apps (Android & iPhone)

The mobile-apps folder contains the Flutter source code of two apps that connect to your website. Build them once with your website address and publish them under your own name.

AppForMain screens
T BookingPassengersSearch with recent searches and offers, live seat map, passenger details, secure payment (wallet in the app, other gateways in the app's browser), QR ticket, live bus tracking, find booking by PNR, cancel & refund, reviews, saved passengers, wallet, notifications, Google & Apple sign-in, account deletion
T Booking BusinessAdmins, operators, agentsDashboard with revenue chart, today's trips, trip status (start, delayed, completed, cancel), passenger manifest, QR ticket scanner for boarding, share the bus GPS position, bookings (approve bank transfers, resend, cancel & refund), earnings, users. Each person sees only what their role allows.

Step-by-step setup, signing, store listing answers (Data safety, App Privacy) and the review checklist: mobile-apps/README.md.

Updating

Updates keep your database, settings, uploads and bookings. There is nothing to run by hand.

  1. Back up (recommended): Admin โ†’ System โ†’ Backups, or phpMyAdmin โ†’ Export.
  2. Upload the new version: File Manager โ†’ your site's folder โ†’ Upload the new ZIP (the contents of the upload folder) โ†’ Extract and allow it to overwrite the old files. The package contains no .env, so your settings cannot be overwritten, and files you uploaded (logos, photos) stay where they are.
  3. Open your website. The first visit notices the new version and updates the database automatically (new tables, new permissions, languages, currencies and e-mail templates โ€” anything you changed is kept) and clears the caches. It takes a second or two.
  4. Check Admin โ†’ System โ†’ System health: it shows the version and โ€œDatabase is up to dateโ€. The Run update button there repeats the update if ever needed.

PHP version after an update: cPanel keeps the MultiPHP setting inside .htaccess, which an update replaces. T Booking remembers that setting and puts it back automatically on the next visit. If you ever see โ€œPHP 8.3 or newer is requiredโ€, select PHP 8.3 again in MultiPHP Manager.

With SSH you can also run php artisan migrate --force and php artisan optimize:clear yourself.

Backups & security

Troubleshooting & FAQ

"500 Internal Server Error"

Check storage/logs/ for the error. Make sure PHP 8.3+ is selected, storage/ and bootstrap/cache/ are writable (755/775), and the .env database details are correct.

The installer stops with an error

The installer runs in small steps so it stays within shared-hosting time limits. If a step fails, the message is shown on screen and saved in storage/logs/installer.log. Messages such as Maximum execution time exceeded or Allowed memory size exhausted mean the host's limits are very low โ€” raise max_execution_time (60+) and memory_limit (256M) in cPanel โ†’ Select PHP Version โ†’ Options, then press Start the installation again. Starting again is safe: the database is emptied first, so nothing is duplicated.

"Composer detected issues in your platform"

Your PHP version is too old. Choose PHP 8.3 or newer in cPanel โ†’ Select PHP Version.

The site shows a file list or "Forbidden"

The .htaccess file was not uploaded (hidden file) or mod_rewrite is disabled. Enable Show Hidden Files in File Manager and upload it again.

Pages have no styling

Check that public/build/ was uploaded and that APP_URL in .env matches your address (http vs https, www vs non-www).

Uploaded images do not appear

Make sure storage/app/public is writable. Uploads are served even when the host does not allow the public/storage symlink.

E-mails are not sent

Set the mail driver to SMTP in Settings โ†’ Email & SMS; check Admin โ†’ Notification logs for errors.

Seats stay held / no new trips

The cron job is not running. Check the command and PHP path; Admin โ†’ System โ†’ System health shows whether the scheduler (cron) is running.

Can I use it without demo data?

Yes โ€” leave Import demo data unticked in the installer. Cities, amenities, bus types, seat layout templates, pages and FAQs are still created.

Credits & licenses

T Booking is built on these open-source projects (each under its own license, mostly MIT): Laravel, Laravel Sanctum & Socialite, spatie/laravel-permission, DomPDF (barryvdh/laravel-dompdf), Simple QrCode, Google2FA, Pusher PHP, Tailwind CSS, Alpine.js, Chart.js, Laravel Echo & pusher-js, Quill editor, and Leaflet/OpenStreetMap. City data: GeoNames, licensed under Creative Commons Attribution 4.0. Demo photos are loaded from Unsplash and are for demonstration only.

The T Booking source code is licensed under the terms in the LICENSE file. ยฉ 2024 Anow Hosting. All rights reserved.

Changelog

1.2.0

1.1.0

1.0.0

Support

Need help? Contact us โ€” please include your purchase code and a short description or screenshot of the problem.

ยฉ 2024 Anow Hosting. All rights reserved. ยท Powered by Anow Hosting | anowhosting.com