Mandatory setup

How to Set Up Laravel Cron Jobs in cPanel #

Add the Cron Jobs #

Go to:
cPanel → Advanced → Cron Jobs

1. Common Settings: Choose “Once Per Minute” (* * * * *)
2. Command (replace paths accordingly):

A. To automatically cancel trip requests when the customer’s active request time has expired:

/usr/local/bin/php /home/your_cpanel_username/public_html/artisan trip-request:cancel >> /dev/null 2>&1

/usr/local/bin/php /home/your_cpanel_username/public_html/artisan trip-request:cancel >> /dev/null 2>&1

B. To notify drivers about upcoming scheduled trips:

/usr/local/bin/php /home/your_cpanel_username/public_html/artisan app:process-scheduled-trips >> /dev/null 2>&1

/usr/local/bin/php /home/your_cpanel_username/public_html/artisan app:process-scheduled-trips >> /dev/null 2>&1

C. Notify drivers of a late penalty when they fail to return a parcel on time while the Parcel Return Setup is active.:

/usr/local/bin/php /home/your_cpanel_username/public_html/artisan app:process-late-return-penalty-notifications >> /dev/null 2>&1

/usr/local/bin/php /home/your_cpanel_username/public_html/artisan app:process-late-return-penalty-notifications >> /dev/null 2>&1

Replace:

• php with your PHP version
• /home/your_cpanel_username/public_html with your correct project path

Avoiding Duplicate Jobs #

If you add a job with the exact same command and timing again, cPanel will not automatically block duplicates. So:

• Make sure to only add each command once.
• If unsure, check the Current Cron Jobs table before adding.

Map Configuration​ #

Client should buy Map API from Google for enabling the maps into the panels. Without buying those APIs client cannot load Google map into the panels for selecting zones. You can watch the video attached below for generating a map API key. Now go to the Third Party APIs menu from the admin panel. Here you will find two inputs for – the map API key client and map API key server.

You can restrict the client with admin panel domain and the server key with your server ip address. If you don’t want any restriction then you can use single api key for both field.

Zone Setup #

Once the map is configured, proceed to the Zone Setup section to create different zones. These zones are crucial, as they determine how the system categorizes drivers, customers, and their trips based on location.

User Management #

In the User Management section, you can manage Drivers, Customers, Withdrawal Information, and Employees. While drivers and customers typically register through their respective applications, the Admin also has the option to manually add them to the system from this section.

Parcel Management #

Add Parcel Categories and Weights here, which will be used later for setting up Parcel Delivery Fare.

Vehicle Management #

Configure Vehicle Attributes that will be displayed to drivers during registration or when updating their vehicle information. In this section, the Admin can also add vehicles and assign ownership, such as Admin-owned or Driver-owned vehicles.

Fare Management #

In this section, you can configure fare rules for both trips and parcel deliveries within a specific zone. The setup includes options such as Base Fare, Fare per distance, Cancellation Fee, Minimum Cancellation Fee, Idle Fee, Trip Delay Fee, and Return Fee. You can also enable Category-wise Fare to define separate rates for different vehicle types.

Business Setup​ #

In the admin panel we have a menu called Business Setup where you can set your logo, timezone, country, time format, location, currency and many more things.

Mail Configuration​ #

Mail Configurations part admin can set his Mailer name, host, driver, user name, Email Id and his own encryption method and password for this SMTP Mail setup.

Firebase Configuration (for notification)​ #

The Firebase Push Notification will send messages for lots of activities. Without configure push notification, data will not update on the screen of apps. To set up firebase notification go to the admin panel Notification Settings menu.

Before that download the JavaScript file firebase-messaging-sw.js from this following link: https://drive.google.com/file/d/1C4TpwYD6P5kkd8FA7xC333lXv10pO3hz/view?usp=sharing

In the JavaScript file “firebase-messaging-sw.js” replace your firebase credential ( apiKey, authDomain, projectId, storageBucket, messagingSenderId, appId ):

firebase.initializeApp({

   apiKey: "YOUR_API_KEY",

   authDomain: "YOUR_AUTH_DOMAIN",

   projectId: "YOUR_PROJECT_ID",

   storageBucket: "YOUR_STORAGE_BUCKET",

   messagingSenderId: "YOUR_MESSAGING_SENDER_ID",

   appId: "YOUR_APP_ID",

   databaseURL: "...",

});

firebase.initializeApp({

   apiKey: "YOUR_API_KEY",

   authDomain: "YOUR_AUTH_DOMAIN",

   projectId: "YOUR_PROJECT_ID",

   storageBucket: "YOUR_STORAGE_BUCKET",

   messagingSenderId: "YOUR_MESSAGING_SENDER_ID",

   appId: "YOUR_APP_ID",

   databaseURL: "...",

});

Payment Configuration​ #

In this part Admin will be introduced with the payment gateways. Cash payment, Digital Payment like SSLCOMMERZ, Razor pay, Paypal, Stripe, Paystack, Senang Pay, Flutterwave, MercadoPago, Payment accept are available for payment gateways. Admin can make the necessary setup of making the status active and inactive of those payment gateways as well.

SMS Module Configuration​ #

SMS Module is used for SMS Gateways for OTP sending in the simplest way of user verification. Customers will get OTP when they create their own account and for password recovery.