- Notifications
You must be signed in to change notification settings - Fork163
An Android library that encourages users to rate the app on the Google Play.
License
codemybrainsout/smart-app-rate
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Smart app rate dialog for Android which takes user rating into consideration. If the user rates the app below the defined threshold rating, the dialog will change into a feedback form. Otherwise, Itwill take the user to the Google PlayStore.
- Auto fetches the app icon to appear on top of the dialog
- Make the dialog appear on a defined app session
- Opens Feedback form if the user rates below the minimum threshold
- Extracts the accent color from your app's theme
- Customizable title, positive button and negative button texts
- Customizable button colors and backgrounds
- Override dialog redirection to Google Play or Feedback form according to your needs
If you want the dialog to appear on the Nth session of the app, just add thesession(N)
to the dialog builder method and move the code to theonCreate()
method of your Activity class. The dialogwill appear when the app is opened for the Nth time.
Use the dialog as it is
val ratingDialog:RatingDialog=RatingDialog.Builder(this) .threshold(3) .session(1) .onRatingBarFormSubmit { feedback->Log.i(TAG,"onRatingBarFormSubmit:$feedback") } .build()ratingDialog.show()
or use the dialog builder class to customize the rating dialog to match your app's UI.
val ratingDialog=RatingDialog.Builder(this) .icon(R.mipmap.ic_launcher) .session(session) .threshold(3) .title(text=R.string.rating_dialog_experience, textColor=R.color.primaryTextColor) .positiveButton(text=R.string.rating_dialog_maybe_later, textColor=R.color.colorPrimary, background=R.drawable.button_selector_positive) .negativeButton(text=R.string.rating_dialog_never, textColor=R.color.secondaryTextColor) .formTitle(R.string.submit_feedback) .formHint(R.string.rating_dialog_suggestions) .feedbackTextColor(R.color.feedbackTextColor) .formSubmitText(R.string.rating_dialog_submit) .formCancelText(R.string.rating_dialog_cancel) .ratingBarColor(R.color.ratingBarColor) .playstoreUrl("YOUR_URL") .onThresholdCleared { dialog, rating, thresholdCleared->Log.i(TAG,"onThresholdCleared:$rating$thresholdCleared") } .onThresholdFailed { dialog, rating, thresholdCleared->Log.i(TAG,"onThresholdFailed:$rating$thresholdCleared") } .onRatingChanged { rating, thresholdCleared->Log.i(TAG,"onRatingChanged:$rating$thresholdCleared") } .onRatingBarFormSubmit { feedback->Log.i(TAG,"onRatingBarFormSubmit:$feedback") } .build()ratingDialog.show()
- Don't use
session()
if you want to show the dialog on a click event. - Remove the
threshold()
from the builder if you don't want to show the feedback form to the user. - Use
onThresholdCleared()
to override the default redirection to Google Play. - Use
onThresholdFailed()
to show your custom feedback form.
Add it as a dependency in your app's build.gradle file
dependencies { implementation'com.codemybrainsout.rating:ratingdialog:2.0.0'}
This project was initiated byCode My Brains Out. You can contribute to this project by submitting issues or/and by forking this repo and sending a pull request.
Follow us on:
Author:Rahul Juneja
Copyright (C) 2016 Code My Brains OutLicensed 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 athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed 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 andlimitations under the License.
About
An Android library that encourages users to rate the app on the Google Play.