Introduction

SayHi

Thank you so much for purchasing our item.

Version: v1.3
Author: IosAppsWorld

Created: 1 Oct. 2023
Updated: 20 Feb. 2024

If you have any questions that are beyond the scope of this help file, Please feel free to email via Support.

Basic

SayHi is a complete social platform with fully loaded modules developed using Yii2, Node.js and and Flutter Framework.
It comprises of Mobile Applications, Backend Penal. As This is complete social system with lots of modules for web and mobile apps, it is compulsory to have some basic knowledge in both server side and mobile app development if you want to do the installation, setup and publishing with your branding yourself.

Flutter SDK and JDK with path setup in your IDE.
Real server related knowledge like apache or local machine server,nodejs we preferred to use a real server.
Server related knowledge and we preferred cPanel in your server for quick installation
Basic knowledge in PHP, Yii2, Nodejs and Flutter if you want to do some customization yourself (Not compulsory).
basic knowledge about google cloud and firebase.

Server

Requires PHP v8.1 and MySQL.
Mod_rewrite Apache
Ctype PHP, JSON, PDO, XML, Zip, Gd Extension
Nodejs v18.16.0
SSL Required
Preferred Server: DigitalOcean, AWS

Mobile app

Android studio or VC code
Flutter SDK setup (version 3.3.0 Stable)
JDK with path setup (only for vs code)
Xcode 13.2+ for IPA file build
Android studio for APK file build

Install on server

After download the code from codecayon, upload the backend code zip file (sayhi_v1.3.zip) in your server root and extract the zip file. Backend admin panel can be installed on a domain or subdomain: For Example, yourdomain.com OR xyz.yourdomain.com.

Database setup

Step 1

Create a new database from your server MYSQL database “MySQL® Database Wizard”

Create a DB user to the database and link that database to the DB user and give permission

Import Mysql database file into your database. database file can be find in doc/db folder in given code.
For new setup use sayhi_v1_3.sql file

Step 2

Db configuration can be updated in common/config/main-local.php.
Update dbname, username and password.

<?php
              return [
                  'components' => [
                      'db' => [
                          'class' => 'yii\db\Connection',
                          'dsn' => 'mysql:host=localhost;dbname=DB_NAME####',
                          'username' => '#####',
                          'password' => '######',
                          'charset' => 'utf8',
                      ],
                      'mailer' => [
                          'class' => 'yii\swiftmailer\Mailer',
                          'viewPath' => '@common/mail',
                          'transport' => [
                              'class' => 'Swift_SmtpTransport',
                              'host' => 'smtp-relay.sendinblue.com',  // e.g. smtp.mandrillapp.com or smtp.gmail.com
                              'username' => '############',
                              'password' => '###########',
                              'port' => '587', // Port 25 is a very common port too
                              'encryption' => 'tls', // It is often used, check your provider or mail server specs
                          ],
                      ],
                      


                  ],
              ];

Step 3

Site Url and Envato purchase code

Site url can be update from common/config/params.php

<?php

              'adminEmail' => 'admin@yourdomain.com',
              'supportEmail' => 'support@yourdomain.com',
              'senderEmail' => 'admin@yourdomain.com',
              'senderName' => 'SayHi',
              
              'siteMode' => 1, // 1 for live, 2 for testing , 3 demo
              'siteUrl' => 'https://example.com',// domain here
              'enventoPurchaseCode' => '##########', // envato purchase code
              'releaseVersion' => '1.3', // current installed product version
              'storageSystem'=> 1,// storage system (local storage =1, AWS S3=2, AZURE=3)
              's3' => [
                  'key' => '##############',
                  'secret' => '##############',
                  'region' => '##############',
                  'defaultBucket' => '#########', //name
                  'storageUrl'=>'https://[bucket_name].s3.amazonaws.com'  //aws s3 storage url /cdn url
                  
                  
              ],

Step 4

All done for appache srever, your software is ready to run.
Admin Url : youdomin.com/backend/web/index.php
Login information :
Username : admin
Password : 123456

Nodejs Chat Socket Setup

We are using nodeJs socket programming for chat, Use following instruction for chat socket setup
All nodeJs chat code will be in /chat forder

Step 1

Nodejs v18.16.0 must be installed on your server
To confirm you have nodejs install, try to run command in your console :

node -v

You must see installed version of nodejs

Output
v18.16.0

It the nodejs is already not install you can install Nodejs with few steups.
Open the ssh terminal and run following commands:

To get this version, you can use the apt package manager. Refresh your local package index first:

sudo apt update

Then install Node.js:

sudo apt install nodejs

Check that the install was successful by querying node for its version number:

node -v

Output
v18.16.0

Install the npm package with apt for installing other moduels like pm2:

sudo apt install npm

Step 2

You can update configuration filechat/config.json with given fields


{
  "port":4000,  //server port
    "live":{    // add your db information
      "host": "127.0.0.1",    
      "user": "######",
      "password": "######",
      "database": "#######"
    },
    "dev":{ // leave it blank
      "host": "####",
      "user": "#####",
      "password": "####",
      "database": "###"
    }
  },
  "encryptionKey":"##########################", // enter key for encryption chat eg. bbC2H19lkVsQDf74rtNMQdddFloLyws
  "storageUrl":"https://[bucket_name].s3.amazonaws.com   OR  https://yoursite.com/uploads",  //Use bucket url for AWS S3 OR use https://yoursite.com/upload for local storage   Check For S3
  "pushNotification":{    
      "databaseURL": "https://q#############.firebaseio.com"         See here
  },
  "voipNotification":{                                               Check documentation to create
    "key": "cert/AuthKey_#####.p8", // .p8 file
    "keyId": "########", //67J4MZG469
    "teamId": "########", // T937GPNTUY
    "bundleId":"###########"  //com.example.app
  },
  "sslCertificatePath":{
    "isSsl":true,   //if ssl not available then make fasle
    "key": "############/##privkey.pem",     // ssl key certificate path
    "cert": "##############/##fullchain.pem" // ssl certificate path
    
  }

Step 3

Firbase Setup

Download serviceAccountKey.json and put the file in /chat folder

Download Json File

Step 4

Start node server

After installing all dependencies and updated the configuration, you must start node server :
Open a terminal and nvigate to the /chat folder that contain the file "index.js"
Run following command to start server :


          cd /path/to/your/root forlder/chat
          node index.js

OR
For running server all time you can install pm2 package More Detail
Run following command to run server with forever:


          cd /path/to/your/root forlder/chat
          pm2 start index.js

Visit https://yourdomain:4000 in your browser. You will see following screen if server is started successfully.

Mandatory setup

Mail Configuration (SMTP)

Mail Configurations part admin can set his Mailer host, user name and his own encryption method and password for this SMTP Mail setup. This configuratin is used for sending mails.

MAil configuration can be updated in common/config/main-local.php.

<?php
        return [
            'components' => [
                'db' => [
                    'class' => 'yii\db\Connection',
                    'dsn' => 'mysql:host=localhost;dbname=DB_NAME####',
                    'username' => '#####',
                    'password' => '######',
                    'charset' => 'utf8',
                ],
                'mailer' => [
                    'class' => 'yii\swiftmailer\Mailer',
                    'viewPath' => '@common/mail',
                    'transport' => [
                        'class' => 'Swift_SmtpTransport',
                        'host' => 'smtp-relay.sendinblue.com',  // e.g. smtp.mandrillapp.com or smtp.gmail.com
                        'username' => '############',
                        'password' => '###########',
                        'port' => '587', // Port 25 is a very common port too
                        'encryption' => 'tls', // It is often used, check your provider or mail server specs
                    ],
                ],
                


            ],
        ];

Storage Setting

We are giving following three option to store media files. You can choose one storage system according to your requirements

Local server storage
AWS S3
Azure Storage

Local server storage setting

Storage system can update be update from common/config/params.php
set storageSystem=1 for local storage

<?php

        'adminEmail' => 'admin@yourdomain.com',
        'supportEmail' => 'support@yourdomain.com',
        'senderEmail' => 'admin@yourdomain.com',
        'senderName' => 'SayHi',
        
        'siteMode' => 1, // 1 for live, 2 for testing , 3 demo
        'siteUrl' => 'https://example.com',// domain here
        'enventoPurchaseCode' => '##########', // envato purchase code
        'releaseVersion' => '1.3', // current installed product version
        'storageSystem'=> 1,//  storage system ( local storage =1, AWS S3=2, AZURE=3)
        's3' => [
            'key' => '##############',
            'secret' => '##############',
            'region' => '##############',
            'defaultBucket' => '#########', //name
            'storageUrl'=>'https://[bucket_name].s3.amazonaws.com'  //aws s3 storage url
            
        ],
        'azureFs' => [
            'accountName' => '###########',
            'accountKey' => '##########',
            'container' => '#######'
            
        ],

Firebase key Setting

We are using firebase to send push notification.

Firbase srever key can update be update from common/config/params.php

<?php
        
        'adminEmail' => 'admin@yourdomain.com',
        'supportEmail' => 'support@yourdomain.com',
        'senderEmail' => 'admin@yourdomain.com',
        'senderName' => 'SayHi',
        
        'siteMode' => 1, // 1 for live, 2 for testing , 3 demo
        'siteUrl' => 'https://example.com',// domain here
        'enventoPurchaseCode' => '##########', // envato purchase code
        'releaseVersion' => '1.3', // current installed product version
        'storageSystem'=> 1,//  storage system ( local storage =1, AWS S3=2, AZURE=3)
        's3' => [
            'key' => '##############',
            'secret' => '##############',
            'region' => '##############',
            'defaultBucket' => '#########', //name
            'storageUrl'=>'https://[bucket_name].s3.amazonaws.com'  //aws s3 storage url
            
        ],
        'azureFs' => [
            'accountName' => '###########',
            'accountKey' => '##########',
            'container' => '#######'
            
        ],
        'testOtp' => '###',
        'apiKey.firebaseCloudMessaging'=> '##############',             See here
        'user.passwordResetTokenExpire' => 3600,

Agora key Setting

Setup Agora api key for audio video calling. You can get your keys. See here
After Getting the App ID, and App Certificate keys, update it from admin panel setting: Admin > Setting > App Setting

Amazone S3 Setup

We are using amazone s3 for storage files and images.

Step 1

Create Bucket

You can create bucket on s3 with public access to follow this URL:
https://docs.aws.amazon.com/quickstarts/latest/s3backup/step-1-create-bucket.html .

Step 2

Update AWS S3 Access key and secret access key

Use following url to create secret keys:
https://docs.aws.amazon.com/powershell/latest/userguide/pstools-appendix-sign-up.html#get-access-keys.

After generate the keys and secret, update it with bucket name on common/config/params.php

set storageSystem=2 for AWS s3 storage, and update s3 information as below

<?php
    
            'adminEmail' => 'admin@yourdomain.com',
            'supportEmail' => 'support@yourdomain.com',
            'senderEmail' => 'admin@yourdomain.com',
            'senderName' => 'SayHi',
            
            'siteMode' => 1, // 1 for live, 2 for testing 
            'siteUrl' => 'https://example.com',// domain here
            'storageSystem'=> 2,  // storage system (local storage =1, AWS S3=2)
            's3' => [
                'key' => '##############',
                'secret' => '##############',
                'region' => '##############',
                'defaultBucket' => '##############', //bucket name
                'storageUrl'=>'https://[bucket_name].s3.amazonaws.com '  //aws s3 storage url
                
                
            ],

Azure Storage Setup

We are using microsoft azure for storage files and images.

Step 1

Create access keys (Account Name, Account Key, Container)

You can create azure setup from :
https://learn.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage?tabs=azure-portal .

Step 2

Update Azure Access keys

After generate the keys update it on common/config/params.php

set storageSystem=3 for Azure storage, and update azureFs information as below

<?php
          'adminEmail' => 'admin@yourdomain.com',
          'supportEmail' => 'support@yourdomain.com',
          'senderEmail' => 'admin@yourdomain.com',
          'senderName' => 'SayHi',
          
          'siteMode' => 1, // 1 for live, 2 for testing , 3 demo
          'siteUrl' => 'https://example.com',// domain here
          'enventoPurchaseCode' => '##########', // envato purchase code
          'releaseVersion' => '1.3', // current installed product version
          'storageSystem'=> 3,//  storage system ( local storage =1, AWS S3=2, AZURE=3)
          's3' => [
              'key' => '##############',
              'secret' => '##############',
              'region' => '##############',
              'defaultBucket' => '#########', //name
              'storageUrl'=>'https://[bucket_name].s3.amazonaws.com'  //aws s3 storage url
              
          ],
          'azureFs' => [
              'accountName' => '##############',
              'accountKey' => '##############',
              'container' => '##############',
              
          ],

Setup Agora api key for audio video calling

Create Agora api key from below url

URL https://www.agora.io

Project access URL

Admin Panel

Admin Url : youdomin.com/backend/web/index.php
Login information :
Username : admin
Password : 123456

Socket Url (socketApiBaseUrl)

https://yourdomain:4000

Rest API Endpoint Url (restApiBaseUrl)

youdomin.com/api/web/v1/

API name will be added in the last of above api endpoint url. This will be done on the mobile side by programming. suppose if we need to call categories api, then mobile application is calling following url with adding api name "categories" like :

youdomin.com/api/web/v1/categories

if the above url is working then Rest api setup successfully.

iPhone app setup

Step 1

Go to developer.apple.com and login using credentials Follow the instructions given in the link below to create bundle identifier.

https://www.appcodezip.com/2020/05/app-id.html

Keep note of bundle identifier as we need it in firebase ios app setup and flutter ios app setup.

Step 2

Enbale apple pay and push notification

Your need to enable push notification and apple login option in create identifer that you created in step 1. See below screenshot for refrence

Step 3

Setup iOS app source code

Open ios project from "mobile" project in xcode.

You need to double click on "Runner.xcworkspace" file to open project

Step 4

Change bundle identifier

Replace the bundle identifier with your created bundle identifier above in ios app setup in apple developer account

Step 5

Change app name

Add new app name in display name field

Step 6

Change app icons

Go to "Assets.xcassets" folder and replace app icon as shown in below screenshot

Android app setup

Step 1

Replace package name

Open the "build.gradle" file in android code, Replace the package with your own created package name as shown in below screenshot.

Change app name

Step 2

Go to project and then open folder in sequence android -> app -> src -> main -> AndroidManifest.xml

Add new app name in android:label in application tag

Change app icons

Step 3

Go to project and then open folder in sequence android -> app -> src -> main -> res

There will be folders like mipmap-hdpi, mipmap-mdpi etc. Replace icons in these folders as shown in the below screenshot

Firebase app setup for social login and push notificatoions

Create new firebase project

Step 1

Create an app if its not created

Create iOS app in firebase project

Step 2

Follow the below screenshots to Create ios app.

Download the plist file , We will use it later in flutter app.

Create android app in firebase project

Step 3

Follow the below screenshots to Create android app.

Download the json file , We will use it later in flutter app.

Step 4

Download the service account key and get database url for nodejs setup

Copy the server key key for push notifictaion in backend server setup

Enable social logins

Go to Authentication tab from left menu and click on get started

Google login

Select google sign in and enable it

Link firebase project with source code

Open project in android studio

Open iOS/Runner folder and delete the older "GoogleService-Info.plist file

Drag and drop the new "GoogleService-Info.plist" config file that you have created above for your ios app. Make sure you drag the file at same location from where you delete the older file

Copy the "REVERSED_CLIENT_ID" and paste it in URL types as shown in screenshots

Goto info.plist file and replace the Old facebook id with your facebook id as shown in below screenshots, Repeat the same process for facebook client token also

Open strings.xml file in android project under android/app/src/main/res/values folder

Enter facebook app id and client token as shown in screenshots

Third party api keys

Facebook login setup

Create app on developer.facebook.com or choose existing app in My apps section

Enter the required details in the app page on developer.facebook.com

Copy the App id and Facebook client token

Replace the old app id and facebook client token with your one you copied from above step at below mentioned places

Giphy setup

Get the Giphy api key from below url

Giphy api key https://support.giphy.com/hc/en-us/articles/360020283431-Request-A-GIPHY-API-Key

After getting the api key enter it in admin panel app setting page, Setting > App setting > Giphy api key

ChatGPT setup

Get the ChatGPT api key from below url

ChatGPT api key https://chat.openai.com/auth/login

After getting the api key enter it in admin panel app setting page, Setting > App setting > ChatGPT api key

Stripe setup

Follow the below url to get the stripe publishable key and secret key

Stripe api key https://stripe.com/docs/keys

After getting the both keys enter it in admin panel app setting page, Setting > Payment setting > Stripe publishable key / Stripe secret key

Razorpay setup

Follow the below url to get the Razorpay api key

Razorpay api key https://razorpay.com/docs/payments/dashboard/account-settings/api-keys/

After getting the both keys enter it in admin panel app setting page, Setting > Payment setting > Razorpay api key

Setup Google map api key for showing google map for location sharing in chat

Create Google map key from below url

Remember to enable Places API, Maps SDK for Android, Maps SDK for iOS and Geocoding API for your API key.

URL https://cloud.google.com/maps-platform/

Replace the Google map key in project as shown below

Setup Google Admob api key for showing google ads

Create Google admob api keys for both android and ios

URL Setup admob key

Replace the admob api key for android app as shown in below screenshot

Replace the admob api key for ios app as shown in below screenshot

Change api urls

Go to "app_config_constants.dart" file and change api server(PHP) url and socket server(Node.js) url as shown in below screenshot

Change app name

Go to "app_config_constants.dart" file and change app and as below screenshot

Change app version for force update

Go to "app_config_constants.dart" file and change currentVersion value to current version number of the app that you are going to publish

Change color scheme

Go to "theme.dart" file and change light and dark mode theme colors as shown in below screenshots

Change localization strings

Go to "resources" folder and change the required strings in required language file

Common Setup problems/Answer

All the api return 401 status after successfully login

The Authorization header is usually, but not always, Please make sure server must accept Authorization header.

restApiBaseUrl (youdomin.com/api/web/v1/) return 404 not found error

API name will be added in the last of above api endpoint url. This will be done on the mobile side by programming.
suppose if we need to call categories api, then mobile application is calling following url with adding api name "categories" like :
youdomin.com/api/web/v1/categories
if the above url is working then Rest api setup successfully.

Successfully login/register but not getting email

You must setup SMTP for email.

MAil configuration can be updated in common/config/main-local.php.

<?php
                  return [
                      'components' => [
                          'db' => [
                              'class' => 'yii\db\Connection',
                              'dsn' => 'mysql:host=localhost;dbname=DB_NAME####',
                              'username' => '#####',
                              'password' => '######',
                              'charset' => 'utf8',
                          ],
                          'mailer' => [
                              'class' => 'yii\swiftmailer\Mailer',
                              'viewPath' => '@common/mail',
                              'transport' => [
                                  'class' => 'Swift_SmtpTransport',
                                  'host' => 'smtp-relay.sendinblue.com',  // e.g. smtp.mandrillapp.com or smtp.gmail.com
                                  'username' => '############',
                                  'password' => '###########',
                                  'port' => '587', // Port 25 is a very common port too
                                  'encryption' => 'tls', // It is often used, check your provider or mail server specs
                              ],
                          ],
                          
          
          
                      ],
                  ];

You can also use third party https://www.brevo.com/ to setup SMTP , its easy and no need extra authentication required.

I 'm stuck on mobile app screen "TIME TO UPDATE APP"

Your mobile app version and release version in admin should be matched.
You can udpate the release version from Admin Penal
LeftMenu => Setting => General Setting => Release Version

Chat screen show "Only admins can send message"

Probably nodejs server not setup/working properly. Please check the following link after replace you domain to check your nodejs server working or not.
https://yourdomain:4000
It must be display "Server Started" message on your screen.

Support

If this documentation doesn't answer your questions, So, Please send us Email or contact via Skype.

Email : topiosappsworld@gmail.com

Working Days : Monday To Friday

We are located in GMT +5:30 time zone and we answer all questions within 12-24 hours in weekdays. In some rare cases the waiting time can be to 48 hours. (except holiday seasons which might take longer).

Note: While we aim to provide the best support possible, please keep in mind that it only extends to verified buyers and only to issues related to our template like bugs and errors. Custom modifications or third party module implementations are not included.

Changelog

See what's new added, changed, fixed, improved or updated in the latest versions.

Version 1.3 (20 Feb. 2024)

AddedStory editing
AddedText Story
AddedShare story in chat
AddedShow cached content in case of no internet
AddedCreate post when a product is added
AddedCreate a post when event is created by admin
AddedCreate post from event manually, also When joined the event
AddedCreate post when Fund raising is added
AddedCreate post when donated in fund raising
AddedCreate post when Offer is added
AddedCreate post Job is added
AddedCreate a post when competition is added by admin
AddedCreate a post when competition result is declared
AddedCreate a post when new club is created by user
AddedCreate a post when new open group is created by a user
AddedShare broadcast : When the user starts a live broadcast, he must invite his followers by sharing the broadcast.
AddedPost in an event
AddedSeparate timeline for event post feed
AddedPost in fund raising campaign
AddedSeparate timeline for fund raising post feed
AddedSub-admin modules permission in admin panel
AddedCheck-in and notes button for every event ticket booking in admin panel
FixedPost in club
FixedForgot password
FixedDelete message issue fixed
FixedOnline/ offline status issues
FixedChat scrolling issue
Fixedmore minor issues

Version 1.2 (14 Jan. 2024)

AddedShare post as link
AddedMain host can Ban users from live
AddedHost can add moderator in Live streaming that have access to remove/ban any user from live
AddedAdmin can see user last login detail, like device, model, IP address
AddedBlock IP address to use app
AddedTag location to post
AddedManage features user wise, now you can enable/disable feature for a particular user from admin
AddedAdd/Remove coins from user wallet via admin
AddedEnable/disable last seen and online status
Added2 Factor authentication for admin
AddedChange user name and password for admin
FixedCopy ChatGPT response
FixedDuplicate phone number account reg issue
FixedShow live joined users count in live suers listing

Version 1.1 (20 Nov. 2023)

Added Search screen with default data before searching.
Added Added camera option for post and chat.
Added Delete comments
Added Like comments
Added Report comment
Added Reply on comment
Added Reply on story
Added Account privacy
Added Post Photo/Video editor
Fixed Theme color issue turned to blue some time
Fixed Verified blue tick icon everywhere
Fixed Copy chatgpt answers
Fixed Delete blocked and deleted users posts

Version 1.0 (01 Oct. 2023)

Initial Release

Buy