OpinionzRate

CI Status Version License Platform

Introduction

OpinionzRate is a class designed to simplify the way you remind your users to review your app on the App Store. It has unique designs for prompting user and we are going to add new design eventually. Read on below for how to get started.

Installation

Cocoapods

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

pod 'OpinionzRate', '~> 0.1.0'

Manual

  1. Add the OpinionzRate code into your project.
  2. Add the StoreKit frameworks to your project.

Usage

.

Usage

  1. Add #import <OpinionzRate.h> in your AppDelegate.m
  2. Call [[OpinionzRate sharedInstance] setupWithAppStoreId:YOUR_APP_ID] with the app id provided by Apple. A good place to do this is at the beginning of your app delegate's application:didFinishLaunchingWithOptions: method.
  3. Add #import <OpinionzRate.h> in your class where you want to ask user for review.
  4. Call [[OpinionzRate sharedInstance] promptForRating] at your desired action

NOTE: prompt it after your view did appeared

Example

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

//
//  AppDelegate.m
//  Demo
//
//  Created by Opinionz.io on 18/08/15.
//  Copyright (c) 2015 Opinionz.io. All rights reserved.
//

#import <OpinionzRate.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    [[OpinionzRate sharedInstance] setupWithAppStoreId:995007460];

    return YES;
}
//
//  ViewController.m
//  Demo
//
//  Created by Opinionz.io on 18/08/15.
//  Copyright (c) 2015 Opinionz.io. All rights reserved.
//

#import "ViewController.h"

#import <OpinionzRate.h>

- (IBAction)buttonHandlerRate:(id)sender {
    //Optional customization
//    [OpinionzRate sharedInstance].title = @"Do you love our app?";
//    [OpinionzRate sharedInstance].message = @"Would you mind taking a moment to rate it? It won’t take more than a minute. Thanks for your support!";
//    [OpinionzRate sharedInstance].cancelTitle = @"No, thanks";
//    [OpinionzRate sharedInstance].rateTitle = @"Rate now";
//    [OpinionzRate sharedInstance].rateLaterTitle = @"Remind me later";

    [[OpinionzRate sharedInstance] promptForRating];
}

Configuration

You can set title, message, cancelTitle, rateTitle and rateLaterTitle messages. If some of them are not set, default values will be used.

Properties

The OpinionzRate has the following properties:

@property (nonatomic, strong) NSString *title;

Title of the rate popup (default is "Enjoying Application name?"

@property (nonatomic, strong) NSString *message;

Message of the rate popup (default is "Would you mind taking a moment to rate it? It won’t take more than a minute. Thanks for your support!"

@property (nonatomic, strong) NSString *cancelTitle;

Cancel button title (default is "No, Thanks"

@property (nonatomic, strong) NSString *rateTitle;

Rate button title (default is "Rate me"

@property (nonatomic, strong) NSString *rateLaterTitle;

Rate later button title (default is "Remind me later"

Methods

The OpinionzRate class has the following methods:

+ (OpinionzRate *)sharedInstance;

Required method for getting single manager. The recommended way to set library into your application is to place a call to sharedInstance in your -application:didFinishLaunchingWithOptions: method.

- (void)setupWithAppStoreId:(NSUInteger)appStoreID;

Register app with store id and start using Opinionz SDK.

- (void)promptForRating;

Show rate popup at your desired time

Supported OS & SDK Versions

ARC Compatibility

OpinionzRate requires ARC.

Protocols

Thread Safety

Release Notes

Version 1.0

Author

Opinionz.io, support@opinionz.io

License

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