{"id":18663797,"url":"https://github.com/lopspower/ratebottomsheet","last_synced_at":"2025-03-22T09:10:58.246Z","repository":{"id":43025964,"uuid":"234048552","full_name":"lopspower/RateBottomSheet","owner":"lopspower","description":"To help to promote your android app by prompting users to rate your app in a BottomSheet ⭐️","archived":false,"fork":false,"pushed_at":"2022-03-22T18:45:18.000Z","size":1401,"stargazers_count":311,"open_issues_count":4,"forks_count":29,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-14T11:04:19.989Z","etag":null,"topics":["android","bottomsheet","rate"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lopspower.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"lopspower","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-01-15T09:46:33.000Z","updated_at":"2025-01-11T06:50:11.000Z","dependencies_parsed_at":"2022-08-12T10:11:05.797Z","dependency_job_id":null,"html_url":"https://github.com/lopspower/RateBottomSheet","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lopspower%2FRateBottomSheet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lopspower%2FRateBottomSheet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lopspower%2FRateBottomSheet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lopspower%2FRateBottomSheet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lopspower","download_url":"https://codeload.github.com/lopspower/RateBottomSheet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244787021,"owners_count":20510041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","bottomsheet","rate"],"created_at":"2024-11-07T08:19:49.456Z","updated_at":"2025-03-22T09:10:58.226Z","avatar_url":"https://github.com/lopspower.png","language":"Kotlin","funding_links":["https://github.com/sponsors/lopspower"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"/preview/header.png\"\u003e\u003c/p\u003e\n\n\u003cimg src=\"/preview/preview.gif\" alt=\"sample\" title=\"sample\" width=\"250\" height=\"444\" align=\"right\" /\u003e\n\nRateBottomSheet\n=================\n\n[![Platform](https://img.shields.io/badge/platform-android-green.svg)](http://developer.android.com/index.html)\n[![API](https://img.shields.io/badge/API-16%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=16)\n[![Twitter](https://img.shields.io/badge/Twitter-@LopezMikhael-blue.svg?style=flat)](http://twitter.com/lopezmikhael)\n\nThis an Android library to help to promote your Android App by prompting users to **rate** your app in the Google Play Store with a material design friendly **BottomSheet**.\n\n\u003ca href=\"https://play.google.com/store/apps/details?id=com.mikhaellopez.lopspower\"\u003e\n  \u003cimg alt=\"Android app on Google Play\" src=\"https://developer.android.com/images/brand/en_app_rgb_wo_45.png\" /\u003e\n\u003c/a\u003e\n\nUSAGE\n-----\n\nTo used this usefull library you can grab it via Gradle:\n\n```groovy\nimplementation 'com.mikhaellopez:ratebottomsheet:1.1.0'\n```\n\nKOTLIN\n-----\n\n```kotlin\nRateBottomSheetManager(this)\n    .setInstallDays(1) // 3 by default\n    .setLaunchTimes(2) // 5 by default\n    .setRemindInterval(1) // 2 by default\n    .setShowAskBottomSheet(false) // True by default\n    .setShowLaterButton(false) // True by default\n    .setShowCloseButtonIcon(false) // True by default\n    .monitor()\n\n// Show bottom sheet if meets conditions\n// With AppCompatActivity or Fragment\nRateBottomSheet.showRateBottomSheetIfMeetsConditions(this)\n```\n\nOverride string xml resources on your application to change the texts in bottom sheet:\n\n```xml\n\u003cresources\u003e\n    \u003cstring name=\"rate_popup_ask_title\"\u003eLike this App?\u003c/string\u003e\n    \u003cstring name=\"rate_popup_ask_message\"\u003eDo you like using this application?\u003c/string\u003e\n    \u003cstring name=\"rate_popup_ask_ok\"\u003eYes I do\u003c/string\u003e\n    \u003cstring name=\"rate_popup_ask_no\"\u003eNot really\u003c/string\u003e\n\n    \u003cstring name=\"rate_popup_title\"\u003eRate this app\u003c/string\u003e\n    \u003cstring name=\"rate_popup_message\"\u003eWould you mind taking a moment to rate it? It won\\'t take more than a minute. Thanks for your support!\u003c/string\u003e\n    \u003cstring name=\"rate_popup_ok\"\u003eRate it now\u003c/string\u003e\n    \u003cstring name=\"rate_popup_later\"\u003eRemind me later\u003c/string\u003e\n    \u003cstring name=\"rate_popup_no\"\u003eNo, thanks\u003c/string\u003e\n\u003c/resources\u003e\n```\n\nLISTENER\n-----\n\nWhen calling `RateBottomSheet.showRateBottomSheetIfMeetsConditions(...)` you can choose to add another parameter of type `AskRateBottomSheet.ActionListener`; this allows you to implement 3 optional callbacks.\nHere is how:\n\n```kotlin\nRateBottomSheet.showRateBottomSheetIfMeetsConditions(\n    this,\n    listener = object : AskRateBottomSheet.ActionListener {\n        override fun onDislikeClickListener() {\n            // Will be called when a click on the \"I don't like\" button is triggered\n        }\n\n        override fun onRateClickListener() {\n            // Will be called when a click on the \"Rate\" button is triggered\n        }\n\n        /*override fun onNoClickListener() {\n            // Will be called when a click on the \"No thanks\" button is triggered,\n            // in this example is commented,\n            // but each callback is optional and it's up to you whether to implement it or not!\n        }*/\n    }\n)\n```\n\nDEBUG\n-----\n\nEnable `debugForceOpen` to show bottom sheet without conditions check like this:\n\n```kotlin\nRateBottomSheetManager(this)\n    .setDebugForceOpenEnable(true) // False by default\n\n// Don't forget to run showRate function\nRateBottomSheet.showRateBottomSheetIfMeetsConditions(this)\n```\n\nYou can also enable logs with `debugLogEnable` properties:\n\n```kotlin\nRateBottomSheetManager(this)\n    .setDebugLogEnable(true) // False by default\n```\n\nClear all current data from RateBottomSheet like this:\n\n```kotlin\nRateBottomSheetManager(this)\n    .clear()\n```\n\nJAVA\n-----\n\nYou can call `showRateBottomSheetIfMeetsConditions` func like this:\n\n```java\nRateBottomSheet.Companion.showRateBottomSheetIfMeetsConditions(this);\n```\n\nAnd because this library it's write in Kotlin you need to add **kotlin-stdlib** dependency on your java project:\n\n```groovy\nimplementation 'org.jetbrains.kotlin:kotlin-stdlib:1.3.71'\n```\n\nSUPPORT ❤️\n-----\n\nFind this library useful? Support it by joining [**stargazers**](https://github.com/lopspower/RateBottomSheet/stargazers) for this repository ⭐️\n\u003cbr/\u003e\nAnd [**follow me**](https://github.com/lopspower?tab=followers) for my next creations 👍\n\nLICENCE\n-----\n\nRateBottomSheet by [Lopez Mikhael](http://mikhaellopez.com/) is licensed under a [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flopspower%2Fratebottomsheet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flopspower%2Fratebottomsheet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flopspower%2Fratebottomsheet/lists"}