1 - Introduction

Streamz is built with PHP. It’s a music streaming website with an admin panel where users can listen to music. The backend allows the admin to configure settings and manage tracks. Admins can create, edit, update, and delete tracks.

Features

• Admin panel built with Laravel
• More than 20 pages
• Material Design UI
• Easy to install
• Easy to customize
• Super-friendly code
• Well-commented code
• Basic knowledge required for setup
• Equipped with all modern features

2 - Folder Structure

2.1 Unzip the downloaded file.

2.2 You will see the following folders and files:

3 - Requirements

Important steps have been highlighted in yellow to help you get the project up and running smoothly.

4 - Local Installation

PHP version 8.2+ is required (update your XAMPP control panel or install a new version if needed).

Database Setup

First, create a database named streamz_laravel.

Then import the streamz_laravel.sql file into your server.

Link the database to the admin panel

To link the database, open the following file:

Insert your dbname (if empty), username, and password.

Add your server link to DOMAIN_NAME without "http". If running locally, use your IP address followed by the project folder. Example: 192.168.2.71/streamz-api-admin/

Local Installation

Ensure XAMPP, Composer, and Node.js are installed on your system.

Copy the streamz-api-admin folder to your XAMPP htdocs directory.

Start the Apache and MySQL services from the XAMPP Control Panel.

Create a database (e.g., streamz_laravel) using phpMyAdmin.

Import the streamz_laravel.sql file (located in the Main_files folder) into your database.

Open terminal/command prompt inside the project folder and run the following commands:

Open your browser and visit:

If the admin login page appears, the admin panel is working correctly.

5 - Server Installation

cd /var/www/demo.raoatech.ca
git clone <repo-url> streamz-api-admin

sudo chown -R www-data:www-data /var/www/demo.raoatech.ca/streamz-api-admin
sudo chmod -R 755 /var/www/demo.raoatech.ca/streamz-api-admin

sudo chmod -R 775 storage
sudo chmod -R 775 bootstrap/cache

cd /var/www/demo.raoatech.ca/streamz-api-admin
composer install --no-dev --optimize-autoloader

cp .env.example .env
php artisan key:generate

APP_NAME=Streamz
APP_ENV=production
APP_DEBUG=false
APP_URL=https://demo.raoatech.ca/streamz-api-admin

php artisan migrate --force
php artisan db:seed --force

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On
    RewriteBase /streamz-api-admin/

    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP_AUTHORIZATION}]

    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

sudo a2enmod rewrite
sudo a2enmod headers
sudo systemctl restart apache2

/var/www/demo.raoatech.ca

Alias /streamz-api-admin/ /var/www/demo.raoatech.ca/streamz-api-admin/public/

<Directory /var/www/demo.raoatech.ca/streamz-api-admin/public>
    AllowOverride All
    Require all granted
</Directory>

<Location /streamz-api-admin/>
    AuthType Basic
    AuthName "Restricted Content"
    AuthUserFile /etc/apache2/.htpasswd
    Require valid-user
</Location>

sudo htpasswd -c /etc/apache2/.htpasswd username
sudo htpasswd /etc/apache2/.htpasswd anotheruser

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan optimize

sudo systemctl restart apache2

https://demo.raoatech.ca/streamz-api-admin/

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

sudo a2enmod rewrite
sudo systemctl restart apache2

php artisan optimize:clear

tail -f storage/logs/laravel.log

tail -f /var/log/apache2/error.log

6 - SMTP Server Configuration

SMTP Configuration from Server

To enable confirmation emails and the forgot password functionality, you need to configure your SMTP server.

Login to your cPanel, go to Email Accounts, and click to continue.

Click Create.

Fill out the form to create an email account and copy the password.

Click Connected Devices.

You will see two sections for settings. Use SSL if your server supports it; otherwise, use non-SSL. Enter all credentials in the admin panel.

To configure the SMTP server, go to Configuration >> SMTP Configuration from the sidebar and update the server credentials:

Google SMTP Server Configuration

Login to your Gmail account.

Then visit: https://myaccount.google.com/security

On the security page, turn off 2-step verification.

Enable Less secure app access.

Also visit: https://accounts.google.com/b/0/DisplayUnlockCaptcha and enable it.

8 - Functionality of Admin Panel

Artist

Admin must create an artist before adding tracks. Provide the image, artist name, genre (if no genre exists, create one), description, and activate the artist by clicking the switch button before adding.

Genres

Admin can view, create, update, or delete genres from the Genre sidebar.

Albums

Admin can view, create, update, or delete albums from the Albums sidebar. Upload the album image, make it featured (featured albums appear in the app slider), provide the title, artist, genres, and optional tags, then activate the album.

Admin can add a description for the album via Album > Description.

Playlist

All playlists are shown on this page. Admin can view or delete playlists from here.

Admin can add multiple tracks via Playlist > Playlist Tracks.

Users

On the Users page, admin can view all registered users and delete users if necessary.

Configuration

In the configuration page, admin can change the site icon, title, and tagline via Configuration > Site Configuration.

Admin can also update SMTP configuration via Configuration > Site Configuration.