sadiqrazasyed / wallpaperboard-enhanced

Android Json based wallpaper dashboard library
38 stars 23 forks source link
android dashboard google-admob material-design muzei notifications wallpaperboard

Wallpaper Board Enhanced

License

This is just an enhanced version of WallpaperBoard with additional features.

Actual Library : https://github.com/danimahardhika/wallpaperboard

Thanks to - Dani Mahardhika

Enahnced Features

Gradle Dependency

Requirements

Take a look on this screenshot for requirements

The minimum API level supported by this library is API 15

Add JitPack repository to root build.gradle

allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

Add the dependency

dependencies {
    implementation 'com.github.sadiqrazasyed:wallpaperboard-enhanced:v1.7.0-b5-2'
}

Or use a snapshot

dependecies {
    implementation('com.github.sadiqrazasyed:wallpaperboard-enhanced:-SNAPSHOT') {
        changing = true
    }
}

How to Use

Enhancing WallPaperBoard

Change "onesignal_app_id" & "onesignal_google_project_number" with your own.



Advance Editing

If you wanna edit when ads are shown or/and when the "BUY PRO" dialog should be shown, then follow this.

** Example & Info :

- About Ads

Shows ads in between min and max value randomly when user clicks on Apply Homescreen Wallpaper button only.

Example : Min = 2, Max = 4 : User will see an ad randomly between 2 to 4 when he/she tires to apply Homescreen Wallpaper. In easy words, either the ad popup will be shown the second time or 3rd, or maybe 4th time after "Apply" button is clicked.

This method is used so that the user/s doesn't get too annoyed with too many ads, &/or also have no static pattern which will prevent them from playing tricks.

Recommended value is 2 & 4 for ads.

- About "BUY PRO" ALert Dialog

This alert dialog is shown after an ad has been closed by the user, but just like the ads, even this dialog is written to randomly show between min/max value so that it doesn't mess the UX.

Example : Min = 2, Max = 4 : User will see a dialog after he/she has closed either the second ad, third, or maybe the fourth one.

Recommended value is 2 & 5 for this alert dialog.


To edit,

        <!-- Min Number -->
    <string name="ad_min_count">2</string>
    <!-- Max Number -->
    <string name="ad_max_count">4</string>
    <!-- Min Number -->
    <string name="ad_closemin_count">2</string>
    <!-- Max Number -->
    <string name="ad_closemax_count">5</string>

Change "Min Number" & "Max Number" with your own numbers.

Enhanced Feature-Previews

Final Report


License

Copyright (c) 2017 Dani Mahardhika

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.