AdForest - Classified Native Android App

Please visit online documentation here

https://documentation.scriptsbundle.com/docs/adforest-android-native-app/

AdForest is a premium classified android native app work with WordPress plugin and is super flexible. We
build AdForest classified android native app with a lot of thought and care to make AdForest a complete
classified solution. We carefully handcrafted this app with a strong focus on typography, usability and overall
user-experience. It’s very quick to setup and easy to customize. There is also a WordPress theme for it.
Preparation and Installation

Software Installation

To start the developing you have to installed the JDK

(http://www.oracle.com/technetwork/java/javase/downloads/index.html), make sure to install all
components.

You also need to download Android Studio (http://developer.android.com/sdk/index.html) which will also
install the SDK manager.

SDK Manager

The installer, should automatically download all required components. If you do a manual setup, download
at least the following components using the SDK manager: In the tools folder:

 SDK Tools
 SDK Platform Tools
 SDK Build Tools

In the extras folder;

 Google Play Services

 Android Support Library
 Android Support Repository
 Google Repository
 Google USB Driver

And at least one SDK version (At least Android 5.0).

After you're done,

Now you can open Android Studio and continue your development
Importing Project
To import the template, simply open Android Studio and import the template. Make sure to wait
for all the processes (the Gradle Build) to complete before continuing to the next step.

Some Addition Steps

Sometimes, the Gradle Build fails, here are some additional steps you can take:

Android Studio might ask you to do download some additional SDK components in the 'messages'
tab, simply follow the instructions to install and download the additional components to fix this.

Make sure the app is targeting at least Marshmallow and that all the libraries are linked:

 Libraries (.jar) from the libs folder

 All the Gradle defined libraries are linked (as found in app/build.gradle)
 Make sure to wait until all loading is complete before manually (re)adding any modules
and/or libraries!

Some Important Video Links For App Setup:

https://www.youtube.com/watch?v=uvxi7UWSU5c

https://www.youtube.com/watch?v=v6VzvMaNqbA

https://www.youtube.com/watch?v=UG3dUKkXJ_4

https://www.youtube.com/watch?v=M-rZnwCsOU8
To install this theme you must have a working version of WordPress already installed. If you need help
installing WordPress, follow the instructions in WordPress Codex or you can watch the Instructional Video
created by Woo Themes. Below are all the useful links for WordPress information.

AdForest Theme Requirements

To use AdForest, you must be running WordPress 4.0 or higher, PHP5 or higher, and mysql 5 or higher. We
have tested it with Mac, Windows and Linux. Below are a list of items you should ensure your host can
comply with. Check to ensure that your web host has the minimum requirements to run WordPress. Always
make sure they are running the latest version of WordPress You can download the latest release of
WordPress from official WordPress website. Always create secure passwords FTP and Database.

Hosting is more secure when PHP applications, like WordPress, are run using your account’s username
instead of the server’s default shared username (www or www-data). The most common way for hosting
companies to do this is using suPHP. Just ask your potential host if they run suPHP or something similar.

After Installing WordPress Put the Follow code in Theme .htaccess file

Please make sure you have added follow code in .htaccess

SetEnvIf Authorization .+ HTTP_AUTHORIZATION=$0

Other Plugins Required With AdForest Apps API

1. SB Framework
2. Woo-Commerce

After Installing (AdForest Apps API) Plugin It will automatically ask to installed the required plugins.

*Note If you are using AdForest Wordpress Theme and it’s already installed and active then it will not ask
you to install those plugin. All the things will sync you just need to set the Theme Options For App.

https://codecanyon.net/item/adforest-classified-wordpress-theme/reviews/19481695
About AdForest Plugin.
This is a WordPress so first you need to install the WordPress on you server. You can download WordPress
latest version from the WordPress official website: https://wordpress.org/

App Settings:
1. Featured Slider Settings
 Enable Scroll On Featured Ads
 Slider Scroll Speed
 Slider Loop scroll
2. Language settings
 RTL
 App Language
3. App Color
 App Colors
 Custom Colors
4. Profile Image Settings
 Default User Picture
 Default Guest Picture
5. Social Login Settings
 Facebook Login/Register
 Google Login/Register
6. App Dynamic Pages
 Select Pages/For simple web view
 Select Pages/For Advanced web view
 Default page icon

App Extra Settings:

1. App About
 Show About Section
 Title (App version title)
 App About Description
2. App Version
 Show App Version
 Title (App version Title)
3. App Rating Settings
 App Rating
 Rating Title
 App URL For Android
  App ID for IOS App
4. App Share Settings
 App Share
 Share popup Title
 Subject
 App share URL
5. App FAQ’s Settings
 Show FAQ’s Section
 Title
 App FAQ’s URL
6. Privacy Policy Settings
 Show Privacy Policy Section
 Title
 App Privacy Policy URL
7. Terms and conditions Settings
 Show Terms and Condition Section
 Title
 Terms and Condition URL
8. Feedback Settings
 Feedback Section
 Title
 Subline
 Feedback Admin Email
 Feedback Email Subject
 Ad Feedback Email From
 Feedback Email Template

App Key Settings:

1. Android Key Settings
 For Android App
 Android Purchase Code
 Android Secret Code
2. IOS Key Settings
 For IOS App
 IOS Purchase Code
 IOS Secret Code
3. Strips Key Settings
 Strips Publishable Key
  Strips Secret Key
4. YouTube Key Settings
 YouTube Key
5. PayPal Settings
 PayPal Mode
 PayPal Key
 PayPal Secret Key
 Merchant Name
 Account Currency
 Privacy URL
 Agreement URL
6. InApp Purchase Settings
 Android InApp Purchase
 Android InApp Secret Code
 App Store InApp Purchase
 App Store InApp Secret Code
7. ThankYou Settings
 ThankYou Title

Ads/Reporting Settings:
1. Ads Settings
 Show Ads
2. Analytic Settings
 Make Analytics
 Analytics ID
3. FireBase Settings
 Firebase API Key
 Strips Secret Key

Menu Settings:
1. Hide From Menu
 Turn Custom Menu
 Menu Title Control
 Show Message Count
Home Screen:
1. Storable Settings
 Home Storable
  Storable Sections
2. Home Search Sections
 Home Search Section
 Search Main Text
 Search Sub Text
 Input Place Holder
 Background Image
3. Categories Icons
 Categories Columns
 Select Categories
 Default Category Icon
 Show Button
 Button Text
4. Categories Slider
 Select Slider Categories
 Slider Posts Limit
5. Featured Ads
 Featured Ads
 Featured Ads Section Title
 Featured Posts (On home page)
 Featured Ads Position
6. Latest Ads
 Latest Ads
 Latest Ads Section Title
 Latest Ads (limit on home page)
7. Near By Ads
 Near By Ads
 Near By Ads Section Title
 Near By Ads(limit on home page)
8. Ads Locations
 Location Section Title
 Select Locations Categories
 Default Location Icon
 Show Button
 Button Text
9. Blog/News
 News/Blog
 Blog/News Section Title
  Select Categories
 Number Of Posts (On Home Page)

Ads General Settings

1. Ad Post Settings
 Allowed All Countries
 Communication Mode
 Package Order Auto Approval
 Send Email On Ad Post
 Email For Notification
 Send Email On Message
 Currency
 Price Direction
 Thousand Separator
 Decimals
 Decimals Separator
 Add Approval
 Ad Update Approval
 Email To Ad owner To Approval
 Report Ad Options
 Ad Report Limit
 Auction On Ad Report Limit
 Default Image
 Set Image Sizes For Listings
 Set Image Sizes For Ads Details
2. Ad View Settings
 Info Columns
 Link Text
 Related Ads Section Title
 Related Posts
3. Ads Search Settings
 Featured Ads
 Featured Ads Section Title
 Featured Posts
4. Ads Rating Settings
 Rating on Ad
 Allow Update The Rating
 Rating Section Title
  Email To Author On Rating
 Rating Show At Most

Woo Products

 Select Product
 Payment Methods For Android App
 Payment Methods For IOS App

Shop Settings

 Turn On Shop
 Shop Menu

Users

 Phone Verification
 Resend Security Code
 Change Phone Number While Ad Posting
 New User Email to Admin
 Welcome Email To User
 New User Email Verification
 Select Page (Term And Condition)
 Term And Condition Text
 Show Delete Button
 Delete Popup Text
 Block User

Bidding Settings

 Enable Bidding
 Give Bidding Option To User
 Bidding Timer
 Top Bidder Limit
 User Section Title
 Email To AD Author
 Section Title
 Disclaimer note

Email templates
1. New Ad Email
  New Ad Email Subject
 New Ad From
 New Ad Posted Message
2. New Message On Ad
 New Message Email Subject
 New Message From
 New Message Template
3. Ad Report Email
 Ad Report Email Subject
 Ad Report Email From
 Ad Report Template
4. Reset Password Email
 Reset Password Email Subject
 Reset Password Email From
 Reset Password Template
5. Reset Password Email
 Reset Password Email Subject
 Reset Password Email From
 Reset Password Template
6. New Rating Email
 New Rating Email Subject
 New Rating Email From
 New Rating Template
7. New Bid Email
 Bid Email Subject
 Bid Email From
 Bid Template
8. New User Registration Email
 New User Email Template Subject For Admin
 New User Email From For Admin
 New User Email Template For Admin
9. User Welcome confirmation Email
 New User Email Template Subject
 New User Email From
 New User Email Template
10. Ad Activation Email
 Ad Activation Email Subject
 Ad Activation From
  Ad Activation Message
11. New Rating Received Email
 Rating Email Subject
 Rating From
 Rating Message

12. Rating Reply Email

 Rating Reply Email Subject
 Rating Reply From
 Rating Reply Message
Push Notifications
Push notifications are the CTP.

First you need to click on publish after putting are the details i.e title, text and if you want you can
sent image as well. To send image you need to set it as featured image.

*Push notification will only send when you update the post and it will ask for confirmation before
sending notification to users.
Changing package name & exporting
Before we can submit our app to the play store, you have to change your package name and compile your
application.

Changing the package name

The package name is you apps unique identifier. It is mentioned in your manifest and all your java files, and
it is your project structure.

Create a new package (usually something like: com.mycompany.myapp) now drag the content from the
com.scriptsbundle.adforest package (subpackages and files) into the new package. Also replace in strings
and textual occurrences.

After you have done this, replace all the occurrences of com.scriptsbundle.adforest with your new package
name using Ctrl + Shift + R (Cmd + Shift + R on OSX).

If everything went correctly, com.scriptsbundle.adforest.xxx packages in the project explorer should be

changed into com.yourcompany.name, just as the package name in the manifest.

Translating: To Translate the app you need to translate the WordPress plugin comes with this app,

Compiling AdForest App

In this step we are going to create an apk, and you can run it on your phone!

1. Make sure your project is selected.

2. Click Build > Generate Signed APK.
3. Follow the onscreen instructions to create a keystore, this is only required once. Save the keystore
on a safe place, otherwise you won’t be able to update your app.
4. Export the android application to a location (desktop for example).

You can now put this file: Xxx.apk on your phone, you will be prompted to check the unknown sources
checkbox if you have not checked it already, you users won’t have to do this if they download the app from
the google play store.

Run directly You can also connect your phone to your PC and run the app directly using Run > Run "App"
(you can also debug using Run & Logcat).
To Change the App Icon

1. Create PNG image file of size 512x512 pixels

2. In Android Studio, in project view, highlight a mipmap directory
3. In menu, go to File>New>Image Asset
4. Click Image Button in Asset type button row
5. Click on 3 Dot Box at right of Path Box.
6. Drag image to source asset box
7. Click Next (Note: Existing launcher files will be overwritten)
8. Click Finish

To Change the Splash Screen

Go to the below folder in the app.

AdForest/app/src/main/res/drawable

Replace the splash.png image with your one with image file name “splash.png"

Easiest way for getting SHA1 Key in android studio both (Debug and release Mode)

1. Open Android Studio

2. Open Your Project
3. Click on Gradle (From Right Side Panel, you will see Gradle Bar)
4. Click on Refresh (Click on Refresh from Gradle Bar , you will see List Gradle scripts of your Project)
5. Click on Your Project (Your Project Name form List)
6. Click on Tasks/Android
7. Double Click on signingReport (You will get SHA1 and MD5 in Run Bar)
Note( for more detail you can see here. https://stackoverflow.com/questions/15727912/sha-1-fingerprint-
of-keystore-certificate)

Replace google-services.json file

1. Get SHA 1 key.

2. Goto android quick start guide and click on Get A Configuration File button. This will redirect you to
a page where you can choose the project and package name.
3. Create / choose an app and give your current app package name. I gave my package name as
info.androidhive.gpluslogin.
4. Paste the SHA-1 fingerprint and click on Enable Google Sign-In. Finally click on Generate
Configuration File to download your google-services.json
5. Replace the downloaded file in the folder " AdForest/app/google-services.json"
Change of Url and Security code.

Go to below file in the android studio.

Change the values of below variables with your one.

private static String Purchase_code = "Your-Purchase-Code-Here";

private static String Custom_Security = " Your-App-Code-Security-Here ";
private static String IP_ADDRESS = "adforest.scriptsbundles.com”;
Purchase_code and Custom_Security should be same that you put in theme options.
Create Facebook App
We need to create facebook app in order to get Facebook App ID. To do so, create an application on
FB developer site. Go to https://developers.facebook.com/

After login, click on Add a New App.

Type your application name.

Choose category and click on Confirm.

Once application is created, go to application dashboard and note down App ID.

To register package and activity, go to Settings from left menu and click on Add Platform and select Android.

Register your application package name and activity which uses Facebook sharing. And add key hash
values explained in get SHA 1 key.
Find Your Key Hash For Facebook Login:
Change your package name and runs application once and then find keyhash in logcat. Also
please follow the video below.

https://www.youtube.com/watch?v=UG3dUKkXJ_4
Add App ID to your project
Add App ID in strings.xml file of your project. put your app id in place of "your

app_id”. <string name="app_id">your app_id</string>

Google map settings:

Hi,

Please follow the article below and generate your key.

https://developers.google.com/maps/documentation/android-api/signup

or

https://developers.google.com/places/android-api/signup#api-console

Copy the key

Finalizing and Submitting To Play Store
In this step we are going to publish your app to the Google Play store.

What you will need:

1. A valid Google account.

2. 25$ (one time)
3. A credit card.
4. Some Assets (screenshots, 512*512 icon, etc)

Basic instructions:

1. Browse to: https://play.google.com/apps/publish (https://play.google.com/apps/publish) and

follow the onscreen instructions.
2. Click the +Add a new app button, enter your apps name, and upload your .apk file.
3. Take your time to open all the tabs: APK, Store Listing, Pricing and Distribution, etc. and enter all
the required items.

Thank you

We would like to thank you again for your purchase and we hope you will able to successfully launch
your app.

If you face any bugs or flaws (in this docs or the template), feel free to report them to us! You can
contact our support team here: https://scriptsbundle.ticksy.com/

If you feel like you need support, you can visit our support page:

https://scriptsbundle.ticksy.com/

What support does include

 Answers to (technical) questions about the item's features.

 Assistance with reported bugs and issues
 Answers to questions about importing and setting up the item as is described in the docs.

Please note that support does not include:

 Customization & adding new features

 Installation Services
 Support for 3rd party software and/or plugins
 Content related rejections and violations from Google