Skip to content

An iOS app review tool to get only good reviews in the App Store!

License

Notifications You must be signed in to change notification settings

naluinui/EGGRating

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤕

This library is deprecated. Anyone who wants a tool for ratings and reviews, please use the official one from Apple instead: https://developer.apple.com/app-store/ratings-and-reviews/

EggRating

Let's increase your iOS app reviews with EggRating.

Version License Platform

EggRating is an iOS app review tool written in Swift. EggRating will prompt users to rate the app after they have used it a certain number of times or after a set time period. If the user rates more than a certain number, EggRating will take them right to the app store where they can leave their good review 😉👍

Screenshots

Requirements

  • iOS 8.0+
  • Swift 3.0+

Installation

EggRating is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'EggRating'

Usage

1., Import EggRating in AppDelegate file and in application:didFinishLaunchingWithOptions: initialize EggRating with your itunesId and other properties you want to customize

EggRating.itunesId = "123456789"
EggRating.minRatingToAppStore = 3.5

2., Import EggRating in view controller file:

import EggRating

3., Use the following to display the EggRating automatically (with the conditions):

EggRating.promptRateUsIfNeeded(in: self)

4., To show an EggRating immediately:

EggRating.promptRateUs(in: self)

5., To access EggRating protocol, implement EggRatingDelegate:

EggRating.delegate = self
extension ViewController: EggRatingDelegate {
    
    func didRate(rating: Double) {
        print("didRate: \(rating)")
    }
    
    func didRateOnAppStore() {
        print("didRateOnAppStore")
    }
    
    func didIgnoreToRate() {
        print("didIgnoreToRate")
    }
    
    func didIgnoreToRateOnAppStore() {
        print("didIgnoreToRateOnAppStore")
    }
    
    func didDissmissThankYouDialog() {
        print("didDissmissThankYouDialog")
    }
}

Customisation

EggRating also provides a property set for a customization usage:

  • itunesId : The iTunes ID of the application (required).

  • delegate : Register in order to listen to rating actions.

  • minRatingToAppStore : Minimum score to bring user to review on the App Store, default is 4.0.

  • daysUntilPrompt : A certain number of times to display EggRating after first used date, default is 10 days.

  • remindPeriod : A certain number of times to display EggRating again, default is 10 days.

  • starFillColor : The color of selected stars, default is yellow.

  • starNormalColor : The color of normal stars, default is clear.

  • starBorderColor : The color of star border, default is yellow.

  • titleLabelText : The title of EggRating dialog.

  • descriptionLabelText : The description of EggRating dialog.

  • dismissButtonTitleText : The dismiss button title of EggRating dialog.

  • rateButtonTitleText : The rate button title of EggRating dialog.

  • thankyouTitleLabelText : The thank you title.

  • thankyouDescriptionLabelText : The thank you description.

  • thankyouDismissButtonTitleText : The thank you dismiss button.

  • appStoreTitleLabelText : The rate on app store title.

  • appStoreDescriptionLabelText : The rate on app store description.

  • appStoreDismissButtonTitleText : The rate on app store dismiss button title.

  • appStoreRateButtonTitleText : The rate on app store rate button title.

  • debugMode : The debug mode, default is false.

  • minuteUntilPrompt : A certain number of times to display EggRating after first used date in minute. This can be set only when debug mode is on.

  • minuteRemindPeriod : A certain number of times to display EggRating again in minute. This can be set only when debug mode is on.

  • appVersion : The application version. This can be set only when debug mode is on.

  • shouldShowThankYouAlertController : The condition to show thank you alert dialog after user rated poor score.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Credits

License

EggRating is available under the MIT license. See the LICENSE file for more info.

About

An iOS app review tool to get only good reviews in the App Store!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published