LotteryBox
LotteryBox - Complete Powerball Lottery & Raffle Draw Management System with Admin Panel PHP Laravel Script
This documentation is last updated on 10 March 2025
Thank you for purchasing LotteryBox.
Introduction
Table of Contents
Welcome to LotteryBox
LotteryBox is a complete lottery and raffle management system built with latest tachnologies like Laravel 12 and PHP 8.4. It is designed to help you effortlessly manage Powerball lotteries, raffle draws, and ticket sales with advanced features like manual & auto-draw, multi-language support, multiple payment gateways, and a centralized admin panel. Whether you're running a small lottery or a large-scale raffle platform, LotteryBox provides all the tools you need to succeed.
When you purchase LotteryBox from CodeCanyon, you’re not just buying a script – you’re investing in a complete lottery and raffle management solution designed to simplify your operations and maximize your revenue. You’ll receive the full source code built with Laravel 12, ensuring a secure, scalable, and developer-friendly foundation for your platform. Along with lifetime free updates, you’ll also get 6 months of free support, so you can launch and grow your lottery business with confidence.
LotteryBox awesome features:-
- Modern Dashboard with Real-time Statistics
- One-time and multiple-time lotteries
- Advanced lottery draw date creation and winning setup
- Manual & Auto Draw System with full admin control
- Auto-winning prize distribution
- Advanced result management
- Multiple payment gateway integration
- Deposit Commission and Registration-based referral system
- Premium push notifications for promotions and marketing
- Rich analytics and reports
- One-stop frontend and system settings
- Multi-language support (unlimited languages)
- Google & Facebook login
- Recaptcha with on/off feature
- Google Analytics integration
- Bank account setup and financial configuration
- Advanced ticket management
- Withdraw request system
- Referral system for earning bonuses
- Email verification for secure accounts
- Result page with detailed breakdowns
- SEO-friendly design
- Customizable appearance for brand identity
- FAQ and blog for user engagement
- Discount and promotional offers
- and Much More ...
Configuration Summary
- First, you must deploy your admin panel on a remote server.
- Use the admin host URL as the base URL and use that for setting up your app.
- You can also build the customer web using the same base URL. Build the web and deploy to your main domain.
Also, you can customise any part of the application according to your own.
Warning
If anything goes wrong with the customization you made, we won’t be responsible for that.
Admin Application Configuration
Table of Contents
LotteryBox is dependent on PHP version 8.2 or higher and MySQL version 5.7 or later. Additionally, the following server configurations and PHP extensions are necessary:
- Mod_rewrite for Apache
- BCMath PHP extension
- Ctype PHP extension
- JSON extension
- Mbstring extension
- OpenSSL extension
- PDO extension
- BCMath PHP extension
- Ctype PHP extension
- Tokeniser extension
- XML extension
- Zip extension
- Fileinfo extension
- Gd extension
- Sodium extension
- Mysql PDO extension
Typically, these extensions are enabled by default on most servers. However, it is advisable to verify the configuration with your hosting provider to ensure compatibility with the project.
Warning
Please do this very carefully. We will not be responsible for your mistake.
Environment Configuration
Local
Choose the right development environment for your local machine based on the operating system. Follow the instructions below for a smooth setup:
- Windows (XAMPP):
– Download and install XAMPP to set up a comprehensive local development environment on Windows. - Linux (LAMP):
– Configure the LAMP stack on your Linux distribution for the local development environment. - MacOS (MAMP):
– Install MAMP to establish a compatible local development environment on MacOS.
Each choice gives you a flexible setup that fits well with your computer’s system. Watch the tutorial videos for step-by-step help while installing.
TIP
Recommended tutorial is below 👇
cpanel
Database Configuration
Before starting the admin installation, the database must be configured for the application.
For creating the database, the following ways must be maintained-
- Go to MySQL Databases
- Create a new database for the application
- Create a user for the database
Warning
Avoid using hash (“#”) in your password
- Add the user to the database
- Give privileges to the user
Info
From one hosting provider to the next, the interface or step differs. Speak with your server provider if you’re having trouble configuring the database. You can also get in touch with us for any type of consulting if you need it.
TIP
Recommended tutorial is below 👇
Domain Configuration
Navigate to your cPanel and locate the page for domain configuration. For LotteryBox, it is essential to have two domains or subdomains. Utilise your main domain to host the customer web panel.
Additionally, create a subdomain for the admin panel. For instance, if your domain is ‘example.com’, generate a subdomain such as ‘admin.example.com’ and host the admin panel on that subdomain.
TIP
Recommended tutorial is below 👇
Digital Ocean
Initially, you must configure a droplet to host your application, allowing you to modify the configuration according to your business needs. We advise a minimum specification of 2 cores CPU paired with 4GB of RAM, with the option to increase resources for larger client bases.
Refer to the tutorial for additional details and guidance.
TIP
Recommended tutorial is below 👇
Server Setup
To host an application on a Virtual Private Server (VPS), you need to configure the LAMP stack, which serves as the environment for PHP/Laravel applications. LAMP comprises Linux, Apache2, MySQL, and PHP. Alternatively, NGinx can be used instead of Apache2, but this tutorial focuses only on Apache2 configuration.
Installing LAMP Stack
This guide will walk you through the process of setting up a LAMP stack on an Ubuntu server. Make sure you have an Ubuntu server instance with sudo privileges.
Run the following commands for installing required things-
- Step 1: Update Package Lists
sudo apt update
- Step 2: Install Apache
sudo apt install apache2 -y
- Step 3: Install MySQL
sudo apt install mysql-server
- Step 4: Install PHP
sudo apt install php libapache2-mod-php php-mysql
- Step 5: Test PHP Processing
echo "" | sudo tee /var/www/html/info.php
- Step 6: Additional PHP Modules
sudo apt install php-bcmath -y
sudo apt install php-ctype -y
sudo apt install php-json -y
sudo apt install php-mbstring -y
sudo apt install php-openssl -y
sudo apt install php-pdo -y
sudo apt install php-tokenizer -y
sudo apt install php-xml -y
sudo apt install php-zip -y
sudo apt install php-fileinfo -y
sudo apt install php-gd -y
sudo apt install php-sodium -y
sudo apt install php-mysql -y
Afterward, access the IP address, and you’ll be directed to the default Apache configuration page.
Check if the php is working correctly or not by hitting the URL YOUR_IP/info.php and you can see the system’s PHP configs.
Info
The following configurations are only for UBUNTU distro.
Tip
Recommended tutorial is below 👇
Configure domain/sub-domain
Make sure you have an Apache web server installed. For configuring domain or sub-domain in your VPS server, you must configure a vhost (Virtual Host) configuration file. Follow the steps below to configure vhost config file for both domain or sub-domain-
Run the following commands for installing required things-
- Step 1: Navigate to Apache Sites Directory
cd /etc/apache2/sites-available/
- Step 2: Create a Virtual Host Configuration File
sudo nano /etc/apache2/sites-available/your_domain.com.conf
- Step 3: Install MySQL
sudo apt install mysql-server
Add the following content:
ServerAdmin webmaster@your_domain.com
ServerAlias www.your_domain.com
ServerName your_domain.com
DocumentRoot /var/www/your_domain.com/public_html
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
Save the file and exit the text editor.
- Step 3: Enable the virtual host configuration file
sudo a2ensite your_domain.com.conf
- Step 4: Reload the Apache2 server
sudo systemctl reload apache2
- Step 5: Test the Virtual Host
Open your web browser and navigate to http://your_domain.com. You should see your website.
Info
The following configurations are only for UBUNTU distro.
Domain propagation
- Domain propagation refers to the process of updating DNS (Domain Name System) records across the internet, allowing a newly purchased domain or subdomain to become accessible globally.
- To initiate the process, configure an A record for your domain and CNAME record for your subdomain. Alternatively, if preferred, you can opt to create an A record for your subdomain instead of a CNAME record.
Info
Once DNS changes are made, propagation begins. It can take anywhere from a few minutes to 48 hours for DNS changes to propagate worldwide. During this time, some users might see the old site while others see the new one.
Info
Once your domain is propagated, check from the follow site – https://dnschecker.org/ Recommended tutorial is below 👇
Setup SSL with Certbot on Apache
SSL (Secure Socket Layer) is crucial for securing data transmitted between the user’s browser and your web server. Certbot is a free, open-source software tool for automatically managing SSL certificates.
In this guide, we’ll walk through the process of setting up SSL for your Apache web server using Certbot.
Before you begin, make sure you have:
An Apache web server installed.
A registered domain pointing to your server’s IP address.
The domain is accessible over HTTP (port 80).
Step 1: SSH into the server
- Access the server hosting your HTTP website via SSH using a user account with sudo privileges.
Step 2: Install snapd
- Ensure that you install snapd and carefully follow any provided instructions to activate classic snap support.
- Refer to the instructions provided on snapcraft’s website for installing snapd.
install snapd
Step 3: Remove certbot-auto and any Certbot OS packages
- If you have any Certbot packages installed via an OS package manager such as apt, it’s advisable to uninstall them before installing the Certbot snap. This ensures that when you execute the command “certbot,” the snap version is utilized rather than the one from your OS package manager. For removing the certbot from the system run the following command-
sudo apt-get remove certbot
Step 4: Install Certbot
- Execute this command on the command line of your machine to install Certbot.
sudo snap install --classic certbot
Step 5: Prepare the Certbot command
- Run the following instruction on the command line of your machine to ensure that the certbot command can be executed.
sudo ln -s /snap/bin/certbot /usr/bin/certbot
Step 6: Choose how you’d like to run Certbot
- Either get and install your certificates…
- Run this command to get a certificate and have Certbot edit your apache configuration automatically to serve it, turning on HTTPS access in a single step.
sudo certbot --apache
- Or, just get a certificate
- If you’re feeling more conservative and would like to make the changes to your apache configuration by hand, run this command.
sudo certbot certonly --apache
Step 7: Test automatic renewal
- he Certbot packages on your system come with a cron job or systemd timer that will renew your certificates automatically before they expire. You will not need to run Certbot again, unless you change your configuration. You can test automatic renewal for your certificates by running this command:
sudo certbot renew --dry-run
Step 8: Confirm that Certbot worked
- To confirm that your site is set up properly, visit https://yourwebsite.com/ in your browser and look for the lock icon in the URL bar.
TIP
Recommended tutorial is below 👇
MySQL Database and User Setup
Setting up a MySQL database involves creating a database, creating a user, and assigning that user appropriate privileges. This guide will walk you through the process using MySQL commands.
Before you begin, make sure you have:
- MySQL installed on your server.
- MySQL root access or a user with sufficient privileges.
Step 1: Log in to MySQL
sudo mysql
Step 2: Create a Database
CREATE DATABASE your_database_name;
Replace your_database_name with the desired name for your database.
Step 3: Create a MySQL User
CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
Replace your_username with the desired username and your_password with the desired password for the user.
Step 4: Grant All Privileges to the User for the Database
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';
Step 5: Flush the privileges
FLUSH PRIVILEGES;
Replace your_database_name with the name of the database created in Step 2 and your_username with the username created in Step 3
Step 6: Exit MySQL
EXIT;
phpMyadmin setup (optional)
Run the following commands for installing phpmyadmin in your system
sudo apt update
sudo apt install phpmyadmin php-mbstring php-zip php-gd php-json php-curl
Here are the options you should choose when prompted in order to configure your installation correctly:
- For the server selection, choose apache2
Warning
When the prompt appears, “apache2” is highlighted, but not selected. If you do not hit SPACE to select Apache, the installer will not move the necessary files during installation. Hit SPACE, TAB, and then ENTER to select Apache.
- Select Yes when asked whether to use dbconfig-common to set up the database
- You will then be asked to choose and confirm a MySQL application password for phpMyAdmin
Restart the apache2 server-
sudo systemctl restart apache2
Project Setup
Upload your project in /var/www/your_domain.com/public_html and unzip the file
apt install unzip
unzip your_file_name
Then give permission to some specific files & folders
sudo chmod 755 .env
sudo chmod 777 modules_statuses.json
sudo chmod 777 app/Providers/RouteServiceProvider.php
sudo chmod -R 777 storage
sudo chmod -R 777 bootstrap/cache
sudo chmod -R 777 resources/lang
Now you are ready to go for the installation.
Installation
After downloading the code from CodeCanyon, upload the Admin New Install.zip in your directory and extract the zip file. LotteryBox can be installed on your main domain or subdomain: For Example, yourdomain.com or subdomain.yourdomain.com
Info
As the admin panel and web app are developed using two different technologies, If you want the web app in your main domain, then you need to install the admin panel in a subdomain. For example, if you want the web app(website) in yourdomain.com, then you can install the admin panel in admin.yourdomain.com or any subdomain. Later in the web app part you will know how you need to install the web app on your server.
WARNING
Don’t install the admin panel or web app in a sub directory (like: yourdomain.com/folder)
LotteryBox requires an SSL certificate to be installed on your domain to work with all the services. A free SSL certificate can be easily installed on your domain using sslforfree.com
Let’s start the installation-
- First, hit your site URL, and it will automatically take you to the installation. Click ‘Get Started’ to start.
- Step 1: All the required extensions and permissions must be enabled. Check the required information if everything is OK, then click on Process Next.
- Step 2: Provide your CodeCanyon username and purchase code and Continue.
If you find the following page, you must activate your domain. Now fill up the information and proceed
- Step 3: Now you need to set the Database host, Database name, Database username & password and click Continue. If the database is in your server, then the host is localhost.
- Step 4: Now, you need to import the SQL file. For this, just press Click Here to import the database.
- If you find the following page, that means your database is not clean. Click ‘Force Import Database’ to import the database, which will clear your database first, then import the application’s database.
- Step 5: Now fill up the information and click Complete Installation
- Congratulations! Your software is ready to run. Click on the Admin Panel or view the Landing Page.
- Default Admin Login URL is Your-domain/login/admin
TIP
Recommended tutorial is below 👇
Mandatory 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. This configuration is used for sending password recovery mail for the store.
Firebase Configuration (for notification)
The Firebase Push Notification will send messages for general notifications, chatting notification, order place notification and every order status notification. To set up firebase notification go to admin panel 3rd Party & Configuration > Firebase Notification > Firebase Configuration.
- Go to https://console.firebase.google.com/
- If you don’t have a project, create one.
- Click on the settings icon from left sidebar (beside Project Overview) & Go to Project Settings.
- From the Project Settings, go to Service Accounts tab.
- Click on Generate new private Key to generate the key. It will automatically download a .json file.
- Open the file with any text editor, copy the contents in it, and add those to Service File Content in 3rd Party > Push Notification > Firebase Configuration in admin panel.
Tip
Recommended tutorial is below 👇
The Firebase Push Notification will send messages for every order status. If the admin turns on the status then with order status change customers, restaurant, delivery man will get status notification and if he turned off that then no one will get that message. 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: "...",
});
Payment Configuration
In this part Admin will introduced with the payment gateways. Cash on delivery, Digital Payment like SSLCOMMERZ, Razor pay, Paypal, Stripe, Paystack, Senang Pay, Flutterwave, MercadoPago, Payment accept are available for payment gateways. He can make the necessary setup of making the status active and inactive of those payment gateways as well.
Version Update
For update the admin panel just upload your update zip file in your project root folder and extract it. Hit the domain or refresh. There will be a Update button, just click, and you are done.
Update after Customisation
If you customized something on the code and want to update to our latest version follow any option given below:
Follow Any One
Way 1
First, push your code on a git branch. Then download our project code from codecanyon and push it to another branch. And at last marge both branch, and it is possible to get conflict on branch. Resolve it carefully.
Way 2
We provided changed files directory-wise with our every update. You have to replace them with your code. Remember that it may conflict with your customization. If you customize something on a file and we changed something on the same file then merge those codes carefully.
Way 3
Download updated files from codecanyon and do your customization again.
Warning
You have to be a developer in that case. If something goes wrong, we won’t be responsible for that.
Common Issues
Do You Need Help To Customization
After Purchase this Script...
You Will Start Customizing According Your Requirement
BUT What If You Don't Know
SOLUTION IS HIRE LotteryBox Team
Hire Same Team For Quality Customization
-
In Order To Ensure Your Website Is Live, We Will Customize
Script According To Your Requirements And Upload It to the Server.
Version History
v1.0 - 15 March 2025
- New - Created & Upload LotteryBox