https://github.com/restorando/rdloveseeker

Requests user rating or invites the user to send a feedback email depending on their opinion about the app
https://github.com/restorando/rdloveseeker

Last synced: about 1 month ago
JSON representation

Requests user rating or invites the user to send a feedback email depending on their opinion about the app

• Host: GitHub
• URL: https://github.com/restorando/rdloveseeker
• Owner: restorando
• License: mit
• Created: 2014-02-24T17:54:25.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2014-09-22T16:01:41.000Z (over 10 years ago)
• Last Synced: 2024-11-12T21:02:43.690Z (about 1 month ago)
• Language: Objective-C
• Size: 357 KB
• Stars: 3
• Watchers: 32
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RDLoveSeeker

[![Version](http://cocoapod-badges.herokuapp.com/v/RDLoveSeeker/badge.png)](http://cocoadocs.org/docsets/RDLoveSeeker)

[![Platform](http://cocoapod-badges.herokuapp.com/p/RDLoveSeeker/badge.png)](http://cocoadocs.org/docsets/RDLoveSeeker)

## Usage

To run the example project; clone the repo, and run `pod install` from the Project directory first.

## Installation

RDLoveSeeker will be soon available through [CocoaPods](http://cocoapods.org).

To install it simply add the following line to your Podfile:

    pod 'RDLoveSeeker'

## Author

Lucas Vidal, [email protected]

## License

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

## Configuration examples

When you setup the library, i.e. in the AppDelegate.m you have to import the library with

    #import "RDLoveSeeker.h"

####Configuration

    [RDLoveSeeker setDebug: NO]; 						// Will display debug information

    [RDLoveSeeker setEventsToRequestRating:15];			// How many significant events should be triggered before requesting user opinion

    [RDLoveSeeker setDaysToRequestRating:21];			// How many days from install before requesting user opinion

    

    [RDLoveSeeker setShouldRequestOnNewVersion:YES];	// If set to YES, the library will reset counters when the build number is changed, to request user feedback again once requirements are met.

    

    [RDLoveSeeker setFeedbackEmailAddress:@"[email protected]"];	// Which email addres will be used to receive user feedback

    

    [RDLoveSeeker setAppStoreID:529290320];				// App ip from app store, where the user will (hopefully) reward with 5 stars

####Logging events

    [RDLoveSeeker logSignificantEvent]; 				// Use this method when you want to mark a significant event has happened.

One great use is to call this on AppDelegate#applicationDidBecomeActive:(UIApplication *)application method, which will count every app open.

If you want to check if condidions are met in a particular moment, just call

    [RDLoveSeeker verifyIfNeedsToBeShown]

####Localization and texts

To manage which texts will be displayed, set in your Localizable.strings for every language the following texts:

    // LoveSeeker Pod

	"Do you love Restorando?" = "Do you love Restorando?";

	"No" = "No";

	"Yes" = "Yes";

	"We're so happy to hear that" = "We're so happy to hear that you love Restorando!";

	"It'd be really helpful if you rated us." = "It'd be really helpful if you rated us. Thanks so much for using Restorando ;)";

	"Rate app" = "Rate app";

	"What can we do to ensure that you love our app?" = "What can we do to ensure that you love our app?";

	"We appreciate your feedback." = "We appreciate your feedback.";

	"No thanks" = "No thanks";

	"Not now" = "Not now";

	"Send email" = "Send email";

	"Feedback Email subject" = "My opinion about Restorando app";

	"Feedback Email body" = "What I didn't like: \n\n\n What I did like: \n\n\n";

	"Ooops" = "Ooops";

	"There was an error sending feedback. Please try again later." = "There was an error sending feedback. Please try again later.";

	"OK" = "OK";

	"Thank you for helping us improve!" = "Thank you for helping us improve!";