Bukoli 1.3.0

You want to add pod 'Bukoli', '~> 1.3' similar to the following to your Podfile:

target 'MyApp' do
  pod 'Bukoli', '~> 1.3'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try Bukoli


Depends on:
Alamofire	~> 4.2
AlamofireImage	~> 3.2
ObjectMapper	~> 2.0

Bukoli 1.3.0

By
Bukoli

Bukoli iOS SDK

You can sign up for a Bukoli account at http://www.bukoli.com.

Requirements

iOS 8.0+
Xcode 8.1+
Swift 3.0+

Dependencies

Example

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

Installation

Swift 2

For swift 2 use version 0.3

https://github.com/bukoli/bukoli-ios/tree/swift2

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'Bukoli', '~> 0.3'
end

Then, run the following command:

$ pod install

Api Key

You need api key to integrate sdk to your application. You can get it from Bukoli

Usage

Configuration

In Xcode, secondary-click your project’s .plist file and select Open As -> Source Code. Insert the following XML snippet into the body of your file just before the final element.

<key>NSLocationWhenInUseUsageDescription</key>
<string>{Human readable reason for location access}</string>

Initialize

AppDelegate.swift
import Bukoli

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    // Override point for customization after application launch.
    ...
    Bukoli.initialize("your api key")
    ..
    return true
}

Customization

import Bukoli

Bukoli.sharedInstance.brandName = "Brand" // Brand Name for info dialog
Bukoli.sharedInstance.brandName2 = "Brand'den" // Ablative Brand Name for info dialog
Bukoli.sharedInstance.buttonTextColor = UIColor.white // Text Colors on button
Bukoli.sharedInstance.buttonBackgroundColor = UIColor.black // Button background color
Bukoli.sharedInstance.shouldAskPhoneNumber = true // If you want to ask user phone number for Bukoli point

Bukoli Select Point

SetUser function first parameter is user unique id on your system Select function first parameter is presenter viewcontroller.

import Bukoli

Bukoli.setUser(userCode, phone, email) 
Bukoli.select(self, { (result: BukoliResult, point: BukoliPoint?, phoneNumber: String?) in
    switch(result) {
    case .success:
        // Point selected
        // If you asked for phone number, phone number is taken. 
        // Phone number format is: 1231234567
        self.handleSuccess(point, phoneNumber)
        break
    case .phoneNumberMissing:
        // Point selected
        // User didn't give phone number.
        self.handlePhoneNumberMissing(point, phoneNumber)
        break
    case .pointNotSelected:
        // User closed without selecting a point
        self.handlePointNotSelected(point, phoneNumber)
        break
    }
})

Bukoli Info

First parameter is presenter viewcontroller.

import Bukoli

Bukoli.info(self)

Bukoli Point Status

First parameter is point code

import Bukoli

Bukoli.pointStatus(pointCode, { (result, point) in
    switch(result) {
    case .enabled:
        // Point is enabled
    case .disabled:
        // Point is disabled
    case .notFound:
        // Point not found
    }
})

License

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