Admin Panel Setup

4. Admin Panel Setup (Laravel)

Ensure that your server meets the requirements outlined in the documentation’s Server Requirement section. Upon downloading the code, upload the admin zip file to your server and extract it. The admin panel can be installed on either a domain or a subdomain.

4.1 Connect to FTP and Setup

Follow these instructions to connect to your server using FTP and complete the application setup:

4.1.1. Connect to the server using FTP: Use an FTP client like FileZilla to connect to your server. Enter the server’s IP address, username, and password. Use port 21 for FTP or port 22 for SFTP.

4.1.2. Transfer the ZIP file: Upload your admin panel’s ZIP file to the server’s local path (e.g., /var/www/html).

4.1.3. Unzip the file: Navigate to the file’s location on the server and run the following command to extract the ZIP file: “sudo unzip your-application.zip” or you can do it from cpanel directly.

4.1.4. Update the .env file with your configuration: Modify the database and application settings which are mentioned in the .env file. Below is an example configuration:

4.1.5. Run the following command from the root directory of your admin panel terminal to install Firebase dependency modules required for scheduler functions.

4.1.6. Setup Node Js Path

To get the Node path from the terminal, you typically want to determine the location of Node.js or a specific file related to Node. Here are common ways to do this from the terminal:

To find out where Node.js is installed on your system, you can use the which command (on Linux/macOS):

which node

This will return the full path to the Node.js binary. For example:

/usr/local/bin/node

See this example: In our case, the Node.js path is something like the one below.

Copy this path and update it in your NODE_PATH variable.

4.2. CRON Job Setup

A cron job is a scheduled task in Unix-based operating systems that runs scripts or commands at specified intervals. Here’s how to set up a cron job on a server:

Steps to Set Up a Cron Job:

4.2.1. Log in to cPanel or in your web server
4.2.2. Navigate to the “Cron Jobs” Section
4.2.3. Add a New Cron Job

In the command field, enter the command or the path to the script you want to run.

For example: Run a script every minutes:

* * * * * /usr/local/bin/php /home/username/public_html/artisan schedule:run >> /dev/null 2>&1

For example: Run a script every day at midnight:

0 0 * * * /usr/local/bin/php /home/username/public_html/artisan schedule:run >> /dev/null 2>&1

4.2.4: Save the Cron Job

Please Note:

Ensure the script you’re running has the correct permissions and is executable. You need to specify the correct PHP path (/usr/local/bin/php is common but may vary depending on your server setup) and please use your admin panel path in the CRON JOB command.

4.3 Map Configuration

Please choose your preferred map by navigating to the Admin Panel > General Settings > Map Tracking Options.

Please Note:

Recommended Google Map for accurate location and mapping results.

4.4 Notifications Settings

To work firebase push notification feature functions correctly, please upload your Firebase credentials file in the Admin Panel by navigating to General Settings > Notifications Settings.

Navigate to your Firebase Project Settings > Cloud Messaging. Under Firebase Cloud Messaging API, you will find the Sender ID.

Go to Firebase Project Settings > Service accounts, scroll down and click on the ‘Generate new private key’ button. A JSON file will be downloaded.

Steps to Configure:

To enable real-time push notifications for customers and drivers, you need to connect your application with Firebase Cloud Messaging (FCM).

1.Generate Firebase Credentials File

Go to the Firebase Console.
Select your project.
Navigate to Project Settings > Service Accounts.
Click Generate New Private Key (e.g., firebase-adminsdk-xxxxx.json).
Keep this file safe, as it contains your Firebase API keys and credentials.

2.Upload Firebase Credentials in Admin Panel

Log in to your CabMe Admin Panel
Go to General Settings > Notifications Settings.
Upload the JSON file you downloaded from Firebase

3.Save & Apply Settings

Once uploaded, click Save/Update Settings.
The system will now connect to Firebase for sending push notifications.

4.Verify Push Notifications

Test by creating a new booking from the user app.
The assigned driver should instantly receive a push notification.
Customers will also get updates (ride accepted, driver arriving, ride started, ride completed).

4.5 AI Settings

Please set up your AI settings by navigating to Settings > AI Settings menu

This AI feature enables automatic generation of product information by analyzing the product image along with the provided title and description. It extracts meaningful details and creates structured product data such as enhanced descriptions, specifications, variations and other relevant attributes to help streamline product listing and improve accuracy.