Ornids Documentation

# Quick Start

Last updated: September 24th, 2020

## Introduction

Thank you for purchasing the app. If you have any questions that are beyond the scope of this help file, please feel free to message us via our user page contact. Ornids is an on-demand vehicle ordering application with various services such as motorbike, car, delivery and car rental, in this latest update has added several new features such as food, shop, grocery, and med. customer make reservations through the mobile application and communicate with partner drivers or merchant through their application in realtime.

## Whats Include?

- Costumers APP (Android Source Code)
- Driver APP (Android Source Code)
- Merchant APP (Android Source Code)
- Admin Panel
- Documentation

## Change Log

Check for updates to this item below

######

# | Log | Type
--- | --- | ---
1 | NEW RELEASE | New

###### Latest Update

# | Log | Type
--- | --- | ---
1 | Migrate from "google maps" to "mapbox" on 3 apps and admin panel. | Migrate
2 | Update STRIPE on 3 apps | Update
3 | Fix reset password issue on driver apps | Fix
4 | Valuation feature on admin panel | New

## Firebase Configuration

### 1. Setup and create firebase project

You must create a New Project in Firebase by logging into Firebase Console and then entering using your Google account if you don't sign in, then create a new Project and specify the name you like for the project, then:

- click on Add Firebase to your Android app
- copy the application Id from your build.gradle and paste it as Android Package Name

- click on Register App > Next
- click on Download google-services.json. it will download a .json file we will use it later

you can skip the remaining setup steps

next up copy the downloaded google-services.json and paste it in the path 'Ornids\app\' to make sure that your app is linked with your Firebase Project

##### NOTE**: Register all applications, make sure you enter the customer, driver, and merchant app in the same firebase project

### 2. Setup firebase realtime database

##### Change database rules

- click on Database > Realtime Database > Rules
- change ".read": false and ".write": false to ".read": true and ".write": true

##### NOTE: if you did not change the firebase rules some of the app functions will not work like chat or save/change pictures.

- where to find firebaseDB

### 3. Setup firebase storage

##### Change storage rules

- click on Storage > Realtime Database > Rules
- allow read, write;

##### NOTE: if you did not change the firebase rules some of the app functions will not work like chat or save/change pictures.

### 4. Setup login phone

next up you have to Enable Phone Authentication in Firebase Console by going to :

- click on Authentication > Sign-In Methode > click on Phone
- enable it and save

### 5. Get fcm server key

- go to project setting
- click on cloud messaging tab
- now you get the fcm server key

### 6. How to insert sha1 fingerprint

in an Android project there are 2 fingerprints for each application, debug and release. Get the SHA1 Fingerprint then fill up SHA certificate fingerprints on firebase, you can follow the step below:

click here how to get android project SHA1

- go to project setting
- click on general tab
- add new fingerprint

##### NOTE: if you upload your application to the playstore, you need to add playstore sha1 certificate here, if you don't add it the application doesn't work properly.

## Admin Panel Configuration

To install the admin, follow the steps below:

### 1. How to upload admin panel to server

- First of all find the adminpanel folder from the downloaded package and upload on live server.

- upload the admin panel file that has been zipped

### 2. Create database on server

you can create a new database or use the database that you have provided on your server manager

- create a database.

- Import the database from the database folder.

### 3. Setup admin panel

go to your cpanel file manager, find your admin panel folder that you uploaded before. you need to configure the config and database file.

- click on application > config > config.php

- fill in all the sections below

- click on application > config > database.php

- fill in this section according to the database that you created before

### 4. How to insert firebasedb

- click here where to find firebasedb
- click here where to insert firebasedb

### 5. How to insert purchase code

You can find out the purchase code on your Envato Purchase Statement

- find your purchase code

- click here where to insert purchase code

### 6. Insert fcm server key

- click here how to find fcm server key

- click here where to insert fcm server key

### 7. Mapbox Configuration

This application uses a third-party maps service from the mapbox platform, you must enter the mapbox access token.

mapbox may charge for this service click here to find out more

##### How to get mapbox access token :

- From your account's tokens page, click the Create a token button
- From the token creation page, give your token a name and make sure the box next to the Downloads:Read scope is checked
- Click the Create token button at the bottom of the page to create your token
- The token you've created is a secret token, which means you will only have one opportunity to copy it somewhere secure

- create mapbox token.

- setting mapbox.

- copy mapbox token token.

- click here where to insert mapbox access token

## Android Configuration

In installing the Android application it will be more complex, follow the steps correctly so that the application can run properly, you can also watch the installation video in the Android application installation section for more details.

### 1. How to open project

- open Android Studio > Open an Existing Android Studio Project > Select Your Project build.gradle file > ok

- browse to directory where you place "Ornidsapp" project and click OK.

### 2. How to change package name

after you open the android project, please change the package name first

- close / unselect “Compact Empty Middle Packages”

- then, right click "refactor->rename" your package and rename it.

##### NOTE**: make sure the package name of each application matches what you entered when registering your application with firebase, click here how to register aplication on firebase

### 3. How to change app name

- open Android Studio >app > res > values > strings.xml
- enter your app name inside "app_name" string tag

### 4. How to change app icon

- open Android Studio > app > res > all mipmap folder > ic_launcher.png
- rename your icon with ic_launcher.png and paste in mipmap folder
- replace all icons with particular size in particular folder

### 5. How to insert url

- select project > go to Constans > constans
- add your url http://yoururl.com in line 15

- select project > go to res > xml > network_security_config.xml
- add your url without http:// or https:// like "yoururl.com" in line 4

### 6. How to insert fcm server key

- select project > go to Constans > constans
- copy the fcm server key then paste it to constants, right on line 16.

- click here how to find fcm server key

### 7. How to setting Mapbox

- open Android Studio >app > res > values > strings.xml
- enter your Mapbox access token "mapbox_access_token" string tag

- open Android Studio > gradle scripts > gradle.properties
- enter your Mapbox access token on mapbox "MAPBOX_DOWNLOAD_TOKEN"

### 8. Generate signed APK then create new key store

- click build > generate signed bundle/APK

- make new key store to get "JKS FILE"

### 9. Configure project structure

- open project structure(ctrl+Alt+Shift+S) then create new signing config.

- fill it with the key store and the "JKS FILE" that was created before.

- click modules and than Click default config, choose your new signing config.

- click build variants on the release option, choose your new signing config.

- apply it and click "OK"
- just ignore it if an error message appears on this step

### 10. How to get sha1 fingerprint

in an Android project there are 2 fingerprints for each application, debug and release.

- run the signing report you will get a release and debug the SHA1 fingerprints

- add your SHA1 fingerprints debug and release on each application and copy to each firebase project, click here where to insert the sha1 fingerprint on firebase
- after entering all sha1 fingerprints for each application on firebase, download the google service json again and paste it on all applications

##### NOTE**: use the same google service json in all applications after you enter the sha1 fingerprint of all applications on firebase

- clean and rebuild project.

## After Installation Configuration

there are several configurations that you have to do after installing this project

### 1. Stripe configuration

- open Admin panel go to settings menu click on stripe
- enter your Secret key and published key to admin panel form input stripe
- click "Update"

### 2. Paypal configuration

click here for more detail about Paypal service

- open Admin panel go to settings menu click on PayPal
- enter your Secret key and PayPal currency
- click "Update"

### 4. SMTP configuration

Valid login details are required to send email using SMTP. You can see the explanation below.

- SMTP Host = Name of the outgoing mail server.
- Type of Encryption = None / SSL / TLS
- SMTP Port = The port used for sending e-mail to the mail server
- SMTP Authentication = Yes / No. In most cases this option must be enabled.
- SMTP Username = Username of the login used for the mail server.
- SMTP Password = Password used to login to the mail server.

### Configure SMTP on your server

- Please create a new email account via your cPanel hosting which will be used on later.
- In cPanel hosting, please navigate to the Email Accounts section then click on Set Up Mail Client.

- You can check SMTP details below. There are the details of the required SMTP, for the example in this tutorial using port 465, depending on the hosting service you are using.

- remember the Outgoing Server and Port which will be needed later

### Read Gmail messages on other email clients using POP

- click here for more detail Gmail POP

### Fill up the SMTP setting on admin panel

- after you got all detail of your SMTP, fill up all the SMTP setting form on admin panel

## FAQ

Frequently asked questions

### Why is my email being responded to late and not even getting a reply?

- So many questions come in via email about our items, we try to give direction and answer all these questions one by one, so we hope your patience awaits your turn.
- We will reply to incoming emails on “Monday” to “Friday” at 10:00 to 17:00 on Indonesian local time, we also take breaks on our national holidays. Please remember the schedule above when your email has not yet received a reply.
- We will not reply to emails that contain spam, violence, sarcasm, and contain other negative content that can waste our time, constructive comments will be appreciated so we hope you can be wise in this case.
- Please check your spam list or sometimes this can also caused by a failure of the email system either from our side or from the recipient’s email system, if this happens we will confirm you through the item comment section to send email with a different address.

### Are there another author support contacts?

- At this time we only provide support via email hello@ourdevelops.com and the codecanyon comment section.

### Will it be charged again when there are updates of this item in the future?

- Price changes will occur when there are additional features, price changes only apply to new buyers, you only need to pay the current price. There are no additional costs after purchasing the item, additional fees are only charged if you get installation and customization services from us.

### If I want to get instalation services, what steps do I have to do?

- Please send us an installation service request via email, please note that this service only covers basic installation only, if you want to change this application more advance according to your wishes please send a customization request.

### If I want to get customization services, what steps do I have to do?

- Please create and send us the list of customizations that you want in great detail so that the discussion process is more effective, we will determine whether we can do it or reject it. You can send this list before making a purchase to avoid disappointment when we reject your customization while you have purchased our item.

### Why I didn’t get a verification code?

- Make sure you have installed the application correctly, please follow the documentation that we have provided.
- Make sure you have activated phone auth on firebase.
- Make sure that your internet connection is stable.

### Why is the application forced close when clicking on the topup button?

- Please disable paypal in the admin panel when not in use, and fill in the paypal key form with “1234”.

### Has created an account driver and customer but why can’t it find the driver?

- Make sure you have activated the driver application, the button is on the application driver homepage.
- Make sure the driver balance is sufficient according to the minimum balance requirements for each service on admin panel.
- Make sure the driver is within the radius requirements for each service on admin panel.

### Why my merchant does not appear on the customer application?

- Make sure the merchant has at least 1 active menu.
- Make sure the merchant balance is sufficient according to the minimum balance requirements for each service on admin panel.
- Make sure the merchant is within the radius requirements for each service on admin panel.

### Why my merchant does not appear on the customer application?

- Make sure the merchant has at least 1 active menu.
- Make sure the merchant balance is sufficient according to the minimum balance requirements for each service on admin panel.
- Make sure the merchant is within the radius requirements for each service on admin panel.

### Why i didn’t receive a driver / merchant registration confirmation email?

- Make sure you have confirmed the account that you registered in the admin panel.
- Make sure you enter your SMTP data correctly, you can use SMTP through the server or if you use gmail it requires special settings, check here

### Why the list of merchant features and merchant categories does not load when registering?

- When you do change the package name, automatically the url on the Android merchant changes according to your package name, this causes a connection failure between android and the server. Please replace the url again in utils > api > service > MerchantService which has changed “package name/...” to “merchant/...”.

### Why merchant image didn’t appear in merchant applications?

- When you do change the package name automatically the url on the Android merchant changes according to your package name, this causes a connection failure between Android and the server. please replace the url at constant > Constant which has changed “images/package name” to “images/merchant”.

### 2. Support

##### Whats included in item support?

- Get an answers to common questions, we will answer questions about the item and how to use it, for example: “How do I make my application look like the item preview?”
- Get an answer to a technical question about the item.
- Reporting and discussing minor bugs in the item with the team, we will help with bug problems by updating the item.
- Reporting and discussing minor bugs in the item with the team, we will help with bug problems by updating the item.

##### Whats not included in item support

- Item Customization
- Item support does not include services to modify or expand items beyond the original features, style, and functionality, which have been described on the item page to customize the item according to your specific needs.
- Item Installation
- Make sure that you have intermediate knowledge about server compilation and Android applications, because installation on your server is not included in item support, if you don’t understand what and how this item works then, please don’t buy this item until you have enough technical people to understand this item, although you can request installation services from us but this service is subject to an additional fees.
- Server or hosting environment problem
- We do not support web hosting problems and your server environment, or problems with items that you install on your server, please check your ISP or web hosting provider. Or you can look for other documentation to solve problems related to your server and hosting.

### 3. Refund request

We cannot refund because the products we sell on this platform are digital goods and cannot be “returned”, but we can refund if the item has not been downloaded, so before you buy, please check the demo that we provide and read the terms that we have made.

### 4. Note

##### Please Note

- It is not mandatory for the codecanyon author to provide support services, but we will keep answering questions and provide support regarding our items.
- Make sure that you have intermediate knowledge about server compilation and Android applications, if you don’t understand what and how this item works then, please don’t buy this item until you have enough technical people to understand this item, although you can request installation services from us but this service is subject to an additional fees.
- Find answers of your questions about our items here, make sure you have been looking for answers to your problems here before sending us a questions.
- If you find a question that matches your problem, please follow the answers step by step until the last option. if the same error still occurs, please contact us.
- We also expect a report from you if the answers we provide have not been able to solve your problem, so we will keep updating this library, and also we will keep adding to the list below with the most frequently asked problem reports.

## Rating the app

If you like our app, we will highly appreciate if you can provide us a rating of 5. You can rate us from your Codecanyon.net Menu > Download page.

# THANK YOU