The SCFacebook 4.1 is a simple and cleaner to use the api [Facebook-ios-sdk] (https://github.com/facebook/facebook-ios-sdk) with Blocks.
Facebook SDK 4.71 for iOS
Graph API Version v2.12
FBSDKCoreKit
FBSDKShareKit
FBSDKLoginKit
Before you need to follow the guide to begin using Facebook SDK for iOS - Getting Started with the Facebook iOS SDK
Using CocoaPods to get start, you can add following line to your Podfile:
pod 'SCFacebook'
Once you have set up the URL Scheme and FacebookAppID as image below:
IOS 9 is required this add fields like the image below:
Now in it's AppDelegate need to add one method and add permissions
#import <SCFacebook/SCFacebook.h>
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
/**
Init SCFacebook
Add the necessary permissions
If your app asks for more than than public_profile and email, it will require review by Facebook before your app can be used by people other than the app's developers.
The time to review your app is usually about 7 business days. Some extra-sensitive permissions, as noted below, can take up to 14 business days.
https://developers.facebook.com/docs/facebook-login/permissions/review
**/
[SCFacebook initWithReadPermissions:@[@"user_about_me",
@"user_birthday",
@"email",
@"user_photos",
@"user_events",
@"user_friends",
@"user_videos",
@"public_profile"]
publishPermissions:@[@"manage_pages",
@"publish_actions",
@"publish_pages"]
];
[FBSDKProfile enableUpdatesOnAccessTokenChange:YES];
return [[FBSDKApplicationDelegate sharedInstance] application:application
didFinishLaunchingWithOptions:launchOptions];
}
#pragma mark -
#pragma mark - SCFacebook Handle
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
return [[FBSDKApplicationDelegate sharedInstance] application:application
openURL:url
sourceApplication:sourceApplication
annotation:annotation];
}
To use the component is very easy. Import the header for your class.
#import <SCFacebook/SCFacebook.h>
@implementation ViewController
#pragma mark - Button Action
- (IBAction)login:(id)sender {
[SCFacebook loginCallBack:^(BOOL success, id result) {
if (success) {
}
}];
}
- (IBAction)publishYourWallLink:(id)sender {
[SCFacebook feedPostWithLinkPath:@"http://www.lucascorrea.com" caption:@"Portfolio" callBack:^(BOOL success, id result) {
if (success) {
}
}];
}
- (IBAction)publishYourWallMessage:(id)sender {
[SCFacebook feedPostWithMessage:@"This is message" callBack:^(BOOL success, id result) {
if (success) {
}
}];
}
When a person logs into your app via Facebook Login you can access a subset of that person's data stored on Facebook. Permissions are how you ask someone if you can access that data. A person's privacy settings combined with what you ask for will determine what you can access. Permissions are strings that are passed along with a login request or an API call. Here are two examples of permissions: email - Access to a person's primary email address. user_likes - Access to the list of things a person likes. https://developers.facebook.com/docs/facebook-login/permissions/v2.4 @param permissions
+ (void)initWithReadPermissions:(NSArray *)readPermissions publishPermissions:(NSArray *)publishPermissions;
Checks if there is an open session, if it is not checked if a token is created and returned there to validate session. @return BOOL
+ (BOOL)isSessionValid;
Facebook login https://developers.facebook.com/docs/ios/graph @param callBack (BOOL success, id result)
+ (void)loginCallBack:(SCFacebookCallback)callBack;
Facebook login https://developers.facebook.com/docs/ios/graph @param FBSDKLoginBehavior behavior @param callBack (BOOL success, id result)
+ (void)loginWithBehavior:(FBSDKLoginBehavior)behavior CallBack:(SCFacebookCallback)callBack;
Facebook logout https://developers.facebook.com/docs/ios/graph @param callBack (BOOL success, id result)
+ (void)logoutCallBack:(SCFacebookCallback)callBack;
Get the data from the logged in user by passing the fields. https://developers.facebook.com/docs/facebook-login/permissions/v2.12#reference-public_profile Permissions required: public_profile... @param callBack (BOOL success, id result)
+ (void)getUserFields:(NSString *)fields callBack:(SCFacebookCallback)callBack;
This will only return any friends who have used (via Facebook Login) the app making the request. If a friend of the person declines the user_friends permission, that friend will not show up in the friend list for this person. 1 - get the User's friends who have installed the app making the query 2 - get the User's total number of friends (including those who have not installed the app making the query) https://developers.facebook.com/docs/graph-api/reference/v2.12/user/friends/ Permissions required: user_friends @param fields fields example: id, name, email, birthday, about, picture @param callBack (BOOL success, id result)
+ (void)getUserFriendsWithFields:(NSString *)fields callBack:(SCFacebookCallback)callBack;
This will only return any friends who have used (via Facebook Login) the app making the request. If a friend of the person declines the user_friends permission, that friend will not show up in the friend list for this person. https://developers.facebook.com/docs/graph-api/reference/v2.12/user/friends/ Permissions required: user_friends @param callBack (BOOL success, id result)
+ (void)getUserFriendsCallBack:(SCFacebookCallback)callBack __attribute__ ((deprecated("getUserFriendsCallBack has been replaced with getUserFriendsWithFields:callBack")));
Post in the user profile with link and caption https://developers.facebook.com/docs/graph-api/reference/v2.12/user/feed Permissions required: publish_actions @param url NSString @param caption NSString @param callBack (BOOL success, id result)
+ (void)feedPostWithLinkPath:(NSString *)url caption:(NSString *)caption callBack:(SCFacebookCallback)callBack;
Post in the user profile with message https://developers.facebook.com/docs/graph-api/reference/v2.12/user/feed Permissions required: publish_actions @param message NSString @param callBack (BOOL success, id result)
+ (void)feedPostWithMessage:(NSString *)message callBack:(SCFacebookCallback)callBack;
Post in the user profile with photo and caption https://developers.facebook.com/docs/graph-api/reference/v2.12/user/feed Permissions required: publish_actions @param photo UIImage @param caption NSString @param callBack (BOOL success, id result)
+ (void)feedPostWithPhoto:(UIImage *)photo caption:(NSString *)caption callBack:(SCFacebookCallback)callBack;
Post in the user profile with video, title and description https://developers.facebook.com/docs/graph-api/reference/v2.12/user/feed Permissions required: publish_actions @param videoData NSData @param title NSString @param description NSString @param callBack (BOOL success, id result)
+ (void)feedPostWithVideo:(NSData *)videoData title:(NSString *)title description:(NSString *)description callBack:(SCFacebookCallback)callBack;
The feed of posts (including status updates) and links published by this person, or by others on this person's profile. https://developers.facebook.com/docs/graph-api/reference/v2.12/user/feed Permissions required: read_stream @param callBack (BOOL success, id result)
+ (void)myFeedCallBack:(SCFacebookCallback)callBack;
Invite friends with message via dialog https://developers.facebook.com/docs/graph-api/reference/v2.12/user/ @param appLink URL @param preview URL optional @param callBack (BOOL success, id result)
+ (void)inviteFriendsWithAppLinkURL:(NSURL *)url previewImageURL:(NSURL *)preview callBack:(SCFacebookCallback)callBack __attribute__ ((deprecated("App Invites no longer supported")));
Get pages in user https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: manage_pages @param callBack (BOOL success, id result)
+ (void)getPagesCallBack:(SCFacebookCallback)callBack;
Get page with id Facebook Web address ou pageId Example http://www.lucascorrea.com/PageId.png https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: manage_pages @param pageId Facebook Web address ou pageId @param callBack (BOOL success, id result)
+ (void)getPageById:(NSString *)pageId callBack:(SCFacebookCallback)callBack;
Post in the page profile with message https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: publish_actions @param page NSString @param message NSString @param callBack (BOOL success, id result)
+ (void)feedPostForPage:(NSString *)page message:(NSString *)message callBack:(SCFacebookCallback)callBack;
Post in the page profile with message and photo https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: publish_actions @param page NSString @param message NSString @param photo UIImage @param callBack (BOOL success, id result)
+ (void)feedPostForPage:(NSString *)page message:(NSString *)message photo:(UIImage *)photo callBack:(SCFacebookCallback)callBack;
Post in the page profile with message and link https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: publish_actions @param page NSString @param message NSString @param url NSString @param callBack (BOOL success, id result)
+ (void)feedPostForPage:(NSString *)page message:(NSString *)message link:(NSString *)url callBack:(SCFacebookCallback)callBack;
Post in the page profile with video, title and description https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: publish_actions @param page NSString @param videoData NSData @param title NSString @param description NSString @param callBack (BOOL success, id result)
+ (void)feedPostForPage:(NSString *)page video:(NSData *)videoData title:(NSString *)title description:(NSString *)description callBack:(SCFacebookCallback)callBack;
Post on page with administrator profile with a message https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: publish_actions @param page NSString @param message NSString @param callBack (BOOL success, id result)
+ (void)feedPostAdminForPageName:(NSString *)page message:(NSString *)message callBack:(SCFacebookCallback)callBack;
Post on page with administrator profile with a message and link https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: publish_actions @param page NSString @param message NSString @param url NSString @param callBack (BOOL success, id result)
+ (void)feedPostAdminForPageName:(NSString *)page message:(NSString *)message link:(NSString *)url callBack:(SCFacebookCallback)callBack;
Post on page with administrator profile with a message and photo Permissions required: publish_actions https://developers.facebook.com/docs/graph-api/reference/v2.12/page @param page NSString @param message NSString @param photo UIImage @param callBack (BOOL success, id result)
+ (void)feedPostAdminForPageName:(NSString *)page message:(NSString *)message photo:(UIImage *)photo callBack:(SCFacebookCallback)callBack;
Post on page with administrator profile with a video, title and description https://developers.facebook.com/docs/graph-api/reference/v2.12/page Permissions required: publish_actions @param page NSString @param videoData NSData @param title NSString @param description NSString @param callBack (BOOL success, id result)
+ (void)feedPostAdminForPageName:(NSString *)page video:(NSData *)videoData title:(NSString *)title description:(NSString *)description callBack:(SCFacebookCallback)callBack;
Get albums in user https://developers.facebook.com/docs/graph-api/reference/v2.12/user/albums Permissions required: user_photos @param callBack (BOOL success, id result)
+ (void)getAlbumsCallBack:(SCFacebookCallback)callBack;
Get album with id https://developers.facebook.com/docs/graph-api/reference/v2.12/user/albums Permissions required: user_photos @param albumId NSString @param callBack (BOOL success, id result)
+ (void)getAlbumById:(NSString *)albumId callBack:(SCFacebookCallback)callBack;
Get photos the album with id https://developers.facebook.com/docs/graph-api/reference/v2.12/album/photos Permissions required: user_photos @param albumId NSString @param params NSDictionary ex: @{@"fields": @"name, images"} @param callBack (BOOL success, id result)
+ (void)getPhotosAlbumById:(NSString *)albumId withParams:(NSDictionary*)params callBack:(SCFacebookCallback)callBack;
Get photos the album with id https://developers.facebook.com/docs/graph-api/reference/v2.12/album/photos Permissions required: user_photos @param albumId NSString @param callBack (BOOL success, id result)
+ (void)getPhotosAlbumById:(NSString *)albumId callBack:(SCFacebookCallback)callBack __attribute__ ((deprecated("getPhotosAlbumById:callBack has been replaced with getPhotosAlbumById:withParams:callBack")));
Create album the user https://developers.facebook.com/docs/graph-api/reference/v2.12/user/albums Permissions required: publish_actions and user_photos @param name NSString @param message NSString @param privacy ENUM @param callBack (BOOL success, id result)
+ (void)createAlbumName:(NSString *)name message:(NSString *)message privacy:(FBAlbumPrivacyType)privacy callBack:(SCFacebookCallback)callBack;
Post the photo album in your user profile https://developers.facebook.com/docs/graph-api/reference/v2.12/album/photos Permissions required: publish_actions @param albumId NSString @param photo UIImage @param callBack (BOOL success, id result)
+ (void)feedPostForAlbumId:(NSString *)albumId photo:(UIImage *)photo callBack:(SCFacebookCallback)callBack;
Post open graph Open Graph lets apps tell stories on Facebook through a structured, strongly typed API. When people engage with these stories they are directed to your app or, if they don't have your app installed, to your app's App Store page, driving engagement and distribution for your app. Stories have the following core components: An actor: the person who publishes the story, the user. An action the actor performs, for example: cook, run or read. An object on which the action is performed: cook a meal, run a race, read a book. An app: the app from which the story is posted, which is featured alongside the story. We provide some built in objects and actions for frequent use cases, and you can also create custom actions and objects to fit your app. https://developers.facebook.com/docs/ios/open-graph Permissions required: publish_actions @param actionType NSString @param graphObject NSString @param objectName NSString @param viewController UIViewController @param callBack (BOOL success, id result)
+ (void)sendForPostOpenGraphWithActionType:(NSString *)actionType graphObject:(FBSDKShareOpenGraphObject *)openGraphObject objectName:(NSString *)objectName viewController:(UIViewController *)viewController callBack:(SCFacebookCallback)callBack;
If not on the list in SCFacebook method, this method can be used to make calls via the graph API GET Calling the Graph API GET https://developers.facebook.com/docs/ios/graph @param method NSString @param params NSDictionary @param callBack (BOOL success, id result)
+ (void)graphFacebookForMethodGET:(NSString *)method params:(id)params callBack:(SCFacebookCallback)callBack;
If not on the list in SCFacebook method, this method can be used to make calls via the graph API POST Calling the Graph API POST https://developers.facebook.com/docs/ios/graph @param method NSString @param params NSDictionary @param callBack (BOOL success, id result)
+ (void)graphFacebookForMethodPOST:(NSString *)method params:(id)params callBack:(SCFacebookCallback)callBack;
SCFacebook is licensed under the MIT License:
Copyright (c) 2011-present Lucas Correa (http://www.lucascorrea.com/)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.