Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rbaumbach/InstagramSimpleOAuth
A quick and simple way to authenticate an Instagram user in your iPhone or iPad app.
https://github.com/rbaumbach/InstagramSimpleOAuth
Last synced: 8 days ago
JSON representation
A quick and simple way to authenticate an Instagram user in your iPhone or iPad app.
- Host: GitHub
- URL: https://github.com/rbaumbach/InstagramSimpleOAuth
- Owner: rbaumbach
- License: mit
- Created: 2014-08-07T14:08:34.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2019-12-16T19:51:14.000Z (almost 5 years ago)
- Last Synced: 2024-11-18T04:12:14.414Z (24 days ago)
- Language: Objective-C
- Homepage:
- Size: 551 KB
- Stars: 91
- Watchers: 10
- Forks: 20
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE.txt
Awesome Lists containing this project
- awesome-ios - InstagramSimpleOAuth - A quick and simple way to authenticate an Instagram user in your iPhone or iPad app. (Authentication)
- awesome-ios-star - InstagramSimpleOAuth - A quick and simple way to authenticate an Instagram user in your iPhone or iPad app. (Authentication)
- fucking-awesome-ios - InstagramSimpleOAuth - A quick and simple way to authenticate an Instagram user in your iPhone or iPad app. (Authentication)
- fucking-awesome-ios - InstagramSimpleOAuth - A quick and simple way to authenticate an Instagram user in your iPhone or iPad app. (Authentication)
README
# InstagramSimpleOAuth [](https://app.bitrise.io/app/685e0f69a57736fe) [](http://cocoapods.org/?q=InstagramSimpleOAuth) [](https://github.com/Carthage/Carthage) [](http://cocoapods.org/?q=InstagramSimpleOAuth) [](https://github.com/rbaumbach/InstagramSimpleOAuth/blob/master/MIT-LICENSE.txt)
A quick and simple way to authenticate an Instagram user in your iPhone or iPad app.
## Adding InstagramSimpleOAuth to your project
### CocoaPods
[CocoaPods](http://cocoapods.org) is the recommended way to add InstagramSimpleOAuth to your project.
1. Add InstagramSimpleOAuth to your Podfile `pod 'InstagramSimpleOAuth'`.
2. Install the pod(s) by running `pod install`.
3. Add InstagramSimpleOAuth to your files with `#import `.
### Carthage
1. Add `github "rbaumbach/InstagramSimpleOAuth"` to your Cartfile.
2. [Follow the directions](https://github.com/Carthage/Carthage#getting-started) to add the dynamic framework to your target.
### Clone from Github
1. Clone repository from github and copy files directly, or add it as a git submodule.
2. Add all files from 'Source' directory to your project (as well as the dependencies listed in the Podfile).
## How To
* Create an instance of `InstagramSimpleOAuthViewController` and pass in an [Instagram client ID, client secret, client callback URL](http://instagram.com/developer/register/#) and completion block to be executed with `InstagramLoginResponse` and `NSError` arguments.
* Once the instance of `InstagramSimpleOAuthViewController` is presented (either as a modal or pushed on the navigation stack), it will allow the user to login. After the user logs in, the completion block given in the initialization of the view controller will be executed. The argument in the completion block, `InstagramLoginResponse`, contains an accessToken and other login information for the authenticated user provided by [Instagram API Response](http://instagram.com/developer/authentication/). If there is an issue attempting to authenticate, an error will be given instead.
* By default, if there are issues with authentication, an UIAlertView will be given to the user. To disable this, and rely on the NSError directly, set the property `shouldShowErrorAlert` to NO.
* The default Instagram scope permissions for authentication are 'basic.' If additional permissions are needed, the permissions can be set using the `permissionScope` property.
* Note: Even though an instance of the view controller itself can be initialized without client ID, client secret, client callback and completion block (to help with testing), this data must be set using the view controller's properties before it is presented to the user.
### Example Usage
```objective-c
// Simplest Example:
InstagramSimpleOAuthViewController
*viewController = [[InstagramSimpleOAuthViewController alloc] initWithClientID:@"123I_am_a_client_id_567890"
clientSecret:@"shhhhhh, I'm a secret"
callbackURL:[NSURL URLWithString:@"http://your.fancy.site"]
completion:^(InstagramLoginResponse *response, NSError *error) {
NSLog(@"My Access Token is: %@", response.accessToken);
}];
[self.navigationController pushViewController:viewController
animated:YES];
// Authenticate with all scope permissions and disable error UIAlertViews Example:
InstagramSimpleOAuthViewController
*viewController = [[InstagramSimpleOAuthViewController alloc] initWithClientID:@"clients_r_us"
clientSecret:@"shhhhhh, don't tell"
callbackURL:[NSURL URLWithString:@"http://your.non.fancy.site"]
completion:^(InstagramLoginResponse *response, NSError *error) {
NSLog(@"My Username is: %@", response.user.username);
}];
viewController.shouldShowErrorAlert = NO;
viewController.permissionScope = @[@"basic", @"comments", @"relationships", @"likes"];
[self.navigationController pushViewController:viewController
animated:YES];
```
## Testing
* Prerequisites: [ruby](https://github.com/sstephenson/rbenv), [ruby gems](https://rubygems.org/pages/download), [bundler](http://bundler.io)
This project has been setup to use [fastlane](https://fastlane.tools) to run the specs.
First, run the setup.sh script to bundle required gems and Cocoapods when in the project directory:
```bash
$ ./setup.sh
```
And then use fastlane to run all the specs on the command line:
```bash
$ bundle exec fastlane specs
```
## Version History
Version history can be found [on releases page](https://github.com/rbaumbach/InstagramSimpleOAuth/releases).
## Suggestions, requests, and feedback
Thanks for checking out InstagramSimpleOAuth for your in-app Instagram Authentication. Any feedback can be can be sent to: [email protected].