Swiftpack.co - Package - Wootric/WootricSDK-iOS

Wootric

Wootric survey

GitHub license GitHub release Build Status CocoaPods Compatible Carthage compatible Platform Twitter

Requirements

  • iOS 8.0+

Demos

  • View the iOS demo video with referral prompt here.
  • View the iOS demo with App Store rating prompt here.

Installation

Using CocoaPods

The easiest way to get Wootric into your iOS project is to use CocoaPods.

  1. You can install CocoaPods using

    $ gem install cocoapods
    
  2. Create a file in your Xcode project called Podfile and add the following line:

    pod "WootricSDK", "~> 0.16.0"
    
  3. In your Xcode project directory run the following command:

    $ pod install
    
  4. CocoaPods should download and install the Wootric SDK, and create a new Xcode .xcworkspace file. Close your Xcode project and open the new .xcworkspace file.

Manually

If you want to, you can download the SDK and add it to your project without using any dependency manager. Note: Make sure you are using the latest version of Xcode and targeting iOS 8.0 or higher.

  1. Download & unzip the Wootric SDK

  2. In your Xcode project, go to General and drop the WootricSDK.framework on Embedded Binaries

Xcode

Make sure the "Copy items if needed" checkbox is checked.

Initializing Wootric

WootricSDK task is to present a fully functional survey view with just a few lines of code.

  1. Import the SDK's header:

    #import <WootricSDK/WootricSDK.h>
    
  2. Configure the SDK with your client ID and account token

    [Wootric configureWithClientID:<YOUR_CLIENT_ID> accountToken:<YOUR_TOKEN>];
    

    You can find the client ID on your Wootric's account settings on the API section.

  3. To display the survey (if user is eligible - this check is built in the method) use:

    [Wootric showSurveyInViewController:<YOUR_VIEW_CONTROLLER>];
    

And that's it! You're good to go and start receiving customer's feedback from your iOS app.

For more information on class methods, please refer to Wootric's docs.

Example

// Import Wootric
@import WootricSDK;

// Inside your view controller's viewDidLoad method

[Wootric configureWithClientID:YOUR_CLIENT_ID accountToken:YOUR_ACCOUNT_TOKEN];
[Wootric setEndUserEmail:@"nps@example.com"];
[Wootric setEndUserCreatedAt:@1234567890];
// Use only for testing
[Wootric forceSurvey:YES];
// show survey
[Wootric showSurveyInViewController:self];

License

The WootricSDK is released under the MIT license. See LICENSE for details.

Contribute

If you want to contribute, report a bug or request a feature, please see CONTRIBUTING for details.

Github

link
Stars: 7

Dependencies

Used By

Total: 0

Releases

Release 0.16.0 - 2019-12-04 22:09:29

Changes:

  • Add support of admin panel values for adding email, score and comment to thank you link

Release 0.15.0 - 2019-10-21 16:00:33

Changes:

  • Honor the 3rd screen (referral) settings from Wootric servers.
  • Add button to Demo project to start the survey
  • Add support of admin panel values for 3rd screen

Release 0.14.0 - 2019-08-13 04:00:31

Changes:

  • Add skipFeedbackScreen method
  • Fix promoter bug for non NPS scales

Release 0.13.0 - 2019-06-25 21:42:40

Changes:

  • Add support for custom scales

Release 0.12.1 - 2019-06-11 01:03:15

Changes:

  • Fix slider bug
  • Remove tracking pixel

Release 0.12.0 - 2019-05-02 23:04:30

Changes:

  • Add delegate pattern

Release 0.11.1 - 2019-03-21 20:46:24

Changes:

  • Fix bug that prevented the email from being sent to eligibility

Release 0.11.0 - 2018-12-18 21:58:07

Changes:

  • Add support for Property Based Sampling
  • Update eligibility logs to show more info

Release 0.10.2 - 2018-11-29 15:16:32

Fixed:

  • Percentage escape strings to prevent NSURL errors

Release 0.10.1 - 2018-09-26 21:53:32

Fixed:

  • Force left-to-right in slider

Release 0.10.0 - 2018-06-25 20:25:50

Changes:

  • Add notifications for appear events (willAppear, didAppear, willDisappear, didDisappear)

Release 0.9.0 - 2018-05-21 14:54:52

Changes:

-Add opt out option

Release 0.8.0 - 2018-05-15 17:10:38

Changes

  • Add WTRLogger to allow setting log level so logs can be disabled
  • Add new setters to Wootric.h to set the WTRLogger mode
  • Update license comment in all files

Release 0.7.0 - 2018-05-04 02:30:15

Changes

  • Add new method that just needs client_id & doesn't require the client_secret

Release 0.6.6 - 2017-12-20 18:18:40

Fixed:

  • Check for setDefaultAfterSurvey when checking defaults values

Release 0.6.5 - 2017-12-15 01:01:07

Fixed:

  • Fix char escaping when updating end user with product_name

Release 0.6.4 - 2017-11-28 20:02:34

  • Add setCustomTimeDelay method

Release 0.6.3 - 2017-11-02 10:53:28

Changes:

  • Fix Carthage compatibility
  • Update project for Xcode9
  • Fix iOS 11 keyboard bug
  • Fix warnings

Release 0.6.2 - 2017-09-06 03:45:10

Fixed:

  • Fix followup question and placeholder bug
  • Update demo project settings
  • Refactor code
  • Update Deployment Target = 8.0

Release 0.6.1 - 2017-05-16 18:02:59

Fixed:

  • Fix 'User-Agent' bug

Release 0.6.0 - 2017-03-30 04:42:09

  • CES and CSAT support

Release 0.5.12 - 2016-11-17 01:41:56

  • Change method names in category to avoid conflict
  • Update project settings

Release 0.5.11 - 2016-10-14 21:43:07

Fixed:

  • "Edit Score" string for different languages
  • Demo project

Release 0.5.10 - 2016-10-11 22:32:37

Fix bundle Info.plist to correct submission issues

Release 0.5.9 - 2016-09-28 14:23:11

  • SDK version bug
  • Escape customProduct and customAudience
  • Don't show survey if accountToken is wrong

Release 0.5.8 - 2016-09-07 23:21:52

-Pass external_id & phone_number -Update tests

Release 0.5.7 - 2016-09-01 02:15:57

  • Accept resurvey_throttle and decline_resurvey_throttle
  • Fix last button long text adjustment
  • Update tests
  • Add tests for WTRDefaults

Release 0.5.6 - 2016-06-29 17:48:04

Send Wootric SDK, OS version and OS name

Release 0.5.5 - 2016-06-10 21:41:32

  • Add end_user_last_seen to eligibility requests
  • Code cleanup
  • Add documentation
  • Change resources for new logo

Release 0.5.4 - 2016-06-02 22:20:25

Color customization support for Segment integration