1 - Introduction

Streamz iOS is built with native Swift in XCode. It’s an iOS audio application. It has an admin panel by which admin can publish audio to the app. Admin can publish audio by uploading it in the admin panel. It offers more than 18 screens and all are fully designed and functional. Streamz iOS offers all required features, which can fulfil any modern application. It’s easy to customize. You can customize any screen as per your needs. It follows all the standards to fulfil the user’s requirements.

Features

• Admin panel with PHP
• More than 18 screens
• Easy to install
• Easy to customize
• Super friendly code
• Well commented code
• Basics knowledge for setup
• Equip with all modern features

2 - Folder Structure

2.1Unzip the file.

2.2You see the following folders:

3 - Requirements

We have made important steps yellow for up and running the project.

4 - Installation

4.1PHP version 7+ required(So update your Xampp control panel or install new one).

4.2Database Setup

In order to setting up database , first you create a database streamz_db”.

Then you can easily import the db.sql file in your server.

Link the database to admin panel

For linking up, first you will find the file from this directory:

Insert the dbname (if it is empty), username, password.

You also have to put the link of your server in the DOMAIN_NAME without the http. If you running the server locally put your IP address with the folder of the project. The link would look like 192.168.2.71/streamz/

4.3Installation on Locally

Make sure that you have already installed Xampp control panel.

Copy the streamz-admin folder and paste it in your Xampp's htdocs folder.

Now run your Xampp Control Panel.

Create a database. Database name will be "stramz_db" or any other name

Import the db.sql file in your created database. (db.sql file is located in the Main_files.)

Find your pc ip address.

Open Command Promt and type => ipconfig

Then find the IPv4 address (example: 192.168.2.88), copy the address

Open your browser.In your browser url type:

If you see the admin login page, then admin-panel work successfully.

You also have to put the link of your server in the DOMAIN_NAME without the http. If you running the server locally put your IP address with the folder of the project. The link would look like 192.168.2.71/streamz/

4.4Installation on Server

To install it on the live server, First import the databse to the server.

Then copy the project folder and paste it to your live server folder.

Please give the writeable 777 permission to the following folders and the subfolders inside them:

Login as Admin:

You also have to put the link of your server in the DOMAIN_NAME without the http. If you running the server locally put your IP address with the folder of the project. The link would look like 192.168.2.71/streamz/

4.5Installation with terminal

Installing apache

Copy project to web root dir

Installing MySQL

Create Database(mysql)

Import Database

Install PHP 7.2

Enabling mod_rewrite

Edit host

If you want to change the server link. Edit this following file. If you don't want to change the link of the server, you can skip this step.

For more detail, Please follow the link below. https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-14-04-lts

Restart server

Permission

Please give the writeable 777 permission to the following folders and the subfolders inside them:

Login as Admin:

You also have to put the link of your server in the DOMAIN_NAME without the http. If you running the server locally put your IP address with the folder of the project. The link would look like 192.168.2.71/streamz/

5 - Installation of IOS

Update your gem file with command sudo gem install -n /usr/local/bin cocoapods

Then give your project path in terminal cd /your project path

Run pod install --verbose command in terminal. Output should be like this.

Another new file will create named Streamz XC12.3.xcworkspace

Double click Streamz XC12.3.xcworkspace to open

Project will be opened in XCode and you will see there are two projects.

Streamz XC12.3 contains full projects source code and Pods contains library files.

Open XCode project and open Streamz XC12.3/Streamz XC12.3/AppCredentials.json file

You need to update baseUrl, fileUrl, adminToken, userSecret, and userName here.

Please provide your own data here.

Select any simulator or iOS Device and Run the project.

6 - Customizing the App

6.1Change app name and bundle identifier

Click the project file from the left and then choose the General tab. It will open settings for this project.

Update Display Name for App Name and Bundle Identifier.

6.2Change App Logo

Open Resources/Assets.xcassets file and choose AppIcon on top.

Provide your app logo. This needs different sizes of images for different device support.

6.3Change Splash screen

OpenLaunchScreen.storyboard file. You can simply redesign or change the image from the inspector window of XCode.

7. Integrate Firebase iOS SDK

Please follow the steps described by Google to successfully integrate

7.1Firebase iOS SDK

Reference: https://firebase.google.com/docs/ios/setup and download.

GoogleService-Info.plist file into your Xcode Project.

8 - Firebase - Authenticate Using Google Sign-In on iOS

Please follow the steps described by Firebase

Reference: https://firebase.google.com/docs/auth/ios/google-signin

9 - Firebase - Authenticate Using Facebook Login

Please follow the steps described by Firebase

Reference: https://firebase.google.com/docs/auth/ios/facebook-login

In facebook developer console create a new app and you will get App ID and App secret.

You may need those in the Firebase console.

10 - Firebase - Authenticate Using Apple Login

You need to enable Sign In with Apple apple in apple developer console https://developer.apple.com/account/resources/identifiers/bundleId/edit/G8P59B9K4L

Note: If you already generated your provisioning profile, please regenerate them again. Otherwise your apple sign in will not work.

Then add Sign In with Apple apple in Signing & capabilities section from XCode.

Click on plus button, scroll down and then double click on Sign In with Apple apple.

11 - Configure Push Notification

For iOS client apps, you can receive notification and data payloads up to 4KB over the

Firebase Cloud Messaging APNs interface.

Reference: https://firebase.google.com/docs/cloud-messaging/ios/client

Go to this link

If its your first app tghen you have to select your country, timezone and currency

Then you have to agree of the terms and condition and Create Admob Account

Then you click Continue to Admob

Then you click App and Create your first app

If apps in play store then select yes otherwise no

Then provide app information and click add

Then you will get an App ID. Save it. You will need it later

Select ‘ Interstitial ’ ad type.

You will find a page like this. Provide ad unit name and select ‘ CREATE AD UNIT ’

Copy ad unit id and save it . You will need it later .

Now get saved Admob App ID, Interstitial Ad Unit ID. Then go to Admin Panel. Click Admob form sidebar. Put App ID and Ad Unit ID in the Interstitial Ad in the admin panel.

You can hide admob from the ap by clicking the on/off toggle button form the header.

14 - SMTP Server Config

To send the confirmation email and forgot password functionality you have to configure your SMTP server. To configure the SMTP server, click the Configuration >> SMTP Configuration menu from sidebar and change the credentials of the SMTP server.

14.2Google SMTP Server Config

Login to your Gmail account.

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

In the security page, turn off the 2-step verification

Turn on the less secure app access

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

15 - Publishing the app in Appstore

This one is very good and detailed updated instruction https://codewithchris.com/submit-your-app-to-the-app-store/

If you prefere text only then you can use this one: https://medium.com/macoclock/how-to-submit-ios-app-to-app-store-c1e801ff817b

16 - Folder Structure of Admin Panel

Inside the project folder, you will see the following directories that are important to setup and customizing the admin panel.

Home directory: All the public files, uploaded images/audios, apis are inside this directory.

private directory: All the private files like models, controllers files are inside this directory.

Please make sure you have change the database credential in the private/init.php file.

Please make sure you have set the writable 777 permission to the following folders

Changing maximum file size

For changing the maximum file size of the server, first you must change the post_max_size and upload_max_filesize of the server and then restart the server. For details please visit the following link Click Here

In the root of our project there is a .htaccess file.

You can change this file to configure the upload file size of the server.

Also you nedd to change the following constants form private\init.php file.

Open private > init.php

Change the value of MAX_IMAGE_SIZE and MAX_VIDEO_SIZE and MAX_AUDIO_SIZE

You have to change the following lines form .htaccess also.

17 - Functionality of Admin Panel

17.1Artist

Admin have to create an artist in order to create track. Put the image, artist name, genre of the artist(If you didn't create any genre, please add a genre), description and the make the artist active by clickin the switch button and add the artist.

Admin can upload multiple tracks from the tracks option form the artist > tracks

17.2Genres

Admin can view / create / update / delete the genres from the genre sidebar.

17.3Albums

Admin can view / create / update / delete the albums from the albums sidebar. First Upload the image of the album. Admin can make the album featured( This is needed for the slider of the app. All the featured album will be shown in the slider of the app). Put the title, artist, Genres, Tags (This is optional). And make the album active.

Admin can put the description of the album in the album > description

Admin can upload multiple tracks from the tracks option form the album > tracks

17.4Playlist

All the playlist is being showin in this page. admin can view and delete a playlist from here.

17.5Users

In the Users page admin can see all the registered users of the app. And can delete a user form here

17.4Google Admob

Admin can configure admob credentials from admin panel. Also admin can on/off admin from the toggle button in the admob page.

17.5Push Notification

Admin can send push notification from the admin panel. First, Admin have to put the AuthKey in the Configuration > push Notification field.

To get the Auth key please follow section 8

Admin can create, delete, Update notification form the Push Notification sidebar

14.6App Feedback

Admin can view all the feedback which given by the users from the app here.

To get the Auth key please follow section 8

Admin can create, delete, Update notification form the Push Notification sidebar

17.6Configuration

In the configuration page, admin will be able to change the icon, site title and site tag line in the Configuration > Site Configuration.

In the configuration page, admin will be able to change SMTP configuration form Configuration > Site Configuration.

In the configuration page, admin will be able to change Firebase Auth for the push notification form Configuration > Push Notification.

To secure the API we have used the api token. This token is being used in the android app to secure the API. Admin can change the Api Token form Configuration > API Token. For more information check