naluinui/eggrating

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

🤕

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.

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 😉👍

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

• The rating stars are from RateView.
• The star in the App Icon of an example project is made by Maxim Basinski from www.flaticon.com

License

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

eggrating's Issues

Could you add @objc to public properties?

To allow this to work from a view controller written in Objective-C, could you add @objc to all public properties of the EggRating class and to the EggRatingDelegate protocol?

Cocoapods uses tag 0.1.2 instead of master

Hi naluinui,

you commited "Some changes EggRatingViewController.swift " on your master, but in the podspecs you are telling to use tag 0.1.2. Could you maybe update the file?

Thx! :)

rejected appstore

my application has been rejected because I use "import EggRating"

I wasn't actually using it. However, I still think it is rejected automatically because of EGGRATING.

"lastRemind" default initial value undermines daysUntilPrompt

By default both daysUntilPrompt and remindPeriod are 10, but if you set a lower daysUntilPrompt it will be ignored in favor of the remindPeriod because the lastRemind variable is set to the date you first call the shouldPromptForRating method.

For example, I want to prompt the user for a rating two days after downloading the app, but then not bother them again until 10 days after they've ignored the rating prompt. Although I have daysUntilPrompt set to 2, when first calling that method it sets lastRemind's date to now, so when it gets to the portion of the prompt check method "minutesFromLastRemind < minuteRemindPeriod", it returns false because it thinks I already received a reminder just now.

I fixed this in my forked repo by defaulting the lastRemind value to a date from the far past.

Rejected by App Review team

Guideline 1.1.7 - Safety - Objectionable Content

“We noticed that your app includes content and features that can manipulate the user reviews or chart ranking on the App Store. Specifically, your app filters user reviews and only directs users who intend to rate your app 4 - 5 stars to complete a rating on the App Store.”