LoginRadius iOS SDK

Introduction

LoginRadius is an Identity Management Platform that simplifies user registration while securing data. LoginRadius Platform simplifies and secures your user registration process, increases conversion with Social Login that combines 30 major social platforms, and offers a full solution with Traditional Customer Registration. You can gather a wealth of user profile data from Social Login or Traditional Customer Registration.

LoginRadius centralizes it all in one place, making it easy to manage and access. Easily integrate LoginRadius with all of your third-party applications, like MailChimp, Google Analytics, Livefyre and many more, making it easy to utilize the data you are capturing.

LoginRadius helps businesses boost user engagement on their web/mobile platform, manage online identities, utilize social media for marketing, capture accurate consumer data, and get unique social insight into their customer base.

Please visit here for more information.

Requirements

You'll need iOS 8 or later.

This release have breaking changes from the SDK v2.0. Please refer to CHANGELOG.md.

Installation

We recommend to use CocoaPods for installing the library in a project.

Podfile

To integrate LRSDK into your Xcode project using CocoaPods, specify it in your Podfile:

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

target 'TargetName' do
pod 'LRSDK', '~> 3.2.2'
end

Then, run the following command:

$ pod install

Initilization

Application is launched

Initilize the SDK with your API key and Site name in your AppDelegate.m

Details on obtaining Site name here and API key here

#import <LRSDK/LRSDK.h>
//  AppDelegate.m

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
	[LoginRadiusSDK instanceWithAPIKey:<your api key>
	                          siteName:<your site name>
	                       application:application
	                     launchOptions:launchOptions];
	//Your code
	return YES;
}

Application is asked to open URL

Call is to handle URL's for social login to work properly in your AppDelegate.m

#import <LRSDK/LRSDK.h>
//  AppDelegate.m

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    return  [[LoginRadiusSDK sharedInstance] application:application openURL:url sourceApplication:sourceApplication annotation:annotation];
}

Usage

Registration Service

Registration service supports traditional registration and login methods using hosted pages.

Supported actions are login, registration, forgotpassword, social

[LoginRadiusSDK registrationServiceWithAction:@"login" inController:self
completionHandler:^(BOOL success, NSError *error) {
	if (success) {
		NSLog(@"successfully logged in");
	} else {
		NSLog(@"Error: %@", [error description]);
	}
}];

Check the demo apps for user registration service.

Social Login

Social Login with the given provider.

[LoginRadiusSDK socialLoginWithProvider:@"facebook" parameters:nil inController:self completionHandler:^(BOOL success, NSError *error) {
	if (success) {
		NSLog(@"successfully logged in with facebook");
	} else {
		NSLog(@"Error: %@", [error description]);
	}
}];

Check the demo app for social login.

By default all social authentication will be done using Safari, if you want native integration set useNativeSocialLogin to YES after SDK initilisation [LoginRadiusSDK sharedInstance].useNativeSocialLogin = YES; LoginRadius iOS SDK only supports Facebook & Twitter native login, for detailed documentation please refer to LoginRadius API docs.

Logout

Log out the user.

[LoginRadiusSDK logout];

Documentation

You can find the full documentation for this library on that LoginRadius API docs.

Author

LoginRadius

License

This project is licensed under the MIT license. See the LICENSE file for more info.