DisqusService 1.0.2

You want to add pod 'DisqusService', '~> 1.0' similar to the following to your Podfile:

target 'MyApp' do
  pod 'DisqusService', '~> 1.0'
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 DisqusService

DisqusService 1.0.2

By
ascarrambad
about.me

DisqusService

Wrapper for Disqus APIs written in Swift. This open-source library allows you to integrate it into your iOS apps. Learn more about Disqus APIs.

Installation

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

pod 'DisqusService'

Usage

Add the following code in your AppDelegate class

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey : Any]? = nil) -> Bool {
    DisqusService.shared.set(publicKey: "<your-public-key>",
                             secretKey: "<your-secret-key>",
                             redirectURI: "<your-redirect-uri>")
}

@available(iOS 9.0, *)
func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
    if let sourceApplication = options[.sourceApplication] as? String {
        if sourceApplication == "com.apple.SafariViewService" {
            NotificationCenter.default.post(name: .DisqusServiceSafariAuthDidClose, object: url)
        }
    }
    return true
}

Because Disqus APIs don’t support schemes to redirect your app after OAuth authentication, you MUST provide an URL which then redirects to the following scheme: disqus-redirect://. To do so in Project Settings → Info: scroll down to URL Types and add an entry with +

Identifier: your-app-bundle-id, i.e. com.disqusService.testApp
URL Schemes: disqus-redirect

Authenticating/Deauthenticating a user is very simple:

DisqusService.shared.authenticate(viewController: yourVC) { (success) in
    if success {

    } else {

    }
}

////////////////

DisqusService.shared.logout()

This library also includes a convenient class called DisqusComment to better handle received comments from a thread. Here’s an example:

let params = ["thread" : "<your-thread-id>", "order" : "asc"]
let posts: [DisqusComment] = []

DisqusService.shared.performGETRequest(api: "posts/list", authRequired: false, params: params) { (data, success) -> Void in
    if success {
        let posts = data?["response"] as! [[AnyHashable : Any]]

        for postJSON in posts {
            if let post = DisqusComment(disqusData: postJSON) {
                posts.append(post)
            }
        }
    }
}

Please note that certain APIs require authentication and MUST be specified. API usage example:

let paramsDetails = ["forum" : "<your-forum>", "thread" : "<your-thread-id>"]
DisqusService.shared.performGETRequest(api: "threads/details", authRequired: false, params: paramsDetails) { (data, success) in

}

let paramsVote = ["post" : "<your-post-id>", "vote" : "1"]
DisqusService.shared.performPOSTRequest(api: "posts/vote", authRequired: true, params: paramsVote) { (data, success) in

}

Author

Matteo Riva, [email protected]

License

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