// Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
|
//
|
// You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
|
// copy, modify, and distribute this software in source code or binary form for use
|
// in connection with the web services and APIs provided by Facebook.
|
//
|
// As with any software that integrates with the Facebook platform, your use of
|
// this software is subject to the Facebook Developer Principles and Policies
|
// [http://developers.facebook.com/policy/]. This copyright 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.
|
|
#import <UIKit/UIKit.h>
|
|
#import <FBSDKCoreKit/FBSDKButton.h>
|
|
#import <FBSDKLoginKit/FBSDKLoginManager.h>
|
|
#import "FBSDKTooltipView.h"
|
|
@protocol FBSDKLoginButtonDelegate;
|
|
/**
|
NS_ENUM(NSUInteger, FBSDKLoginButtonTooltipBehavior)
|
Indicates the desired login tooltip behavior.
|
*/
|
typedef NS_ENUM(NSUInteger, FBSDKLoginButtonTooltipBehavior)
|
{
|
/** The default behavior. The tooltip will only be displayed if
|
the app is eligible (determined by possible server round trip) */
|
FBSDKLoginButtonTooltipBehaviorAutomatic = 0,
|
/** Force display of the tooltip (typically for UI testing) */
|
FBSDKLoginButtonTooltipBehaviorForceDisplay = 1,
|
/** Force disable. In this case you can still exert more refined
|
control by manually constructing a `FBSDKLoginTooltipView` instance. */
|
FBSDKLoginButtonTooltipBehaviorDisable = 2
|
};
|
|
/**
|
A button that initiates a log in or log out flow upon tapping.
|
|
`FBSDKLoginButton` works with `[FBSDKAccessToken currentAccessToken]` to
|
determine what to display, and automatically starts authentication when tapped (i.e.,
|
you do not need to manually subscribe action targets).
|
|
Like `FBSDKLoginManager`, you should make sure your app delegate is connected to
|
`FBSDKApplicationDelegate` in order for the button's delegate to receive messages.
|
|
`FBSDKLoginButton` has a fixed height of @c 30 pixels, but you may change the width. `initWithFrame:CGRectZero`
|
will size the button to its minimum frame.
|
*/
|
@interface FBSDKLoginButton : FBSDKButton
|
|
/**
|
The default audience to use, if publish permissions are requested at login time.
|
*/
|
@property (assign, nonatomic) FBSDKDefaultAudience defaultAudience;
|
/**
|
Gets or sets the delegate.
|
*/
|
@property (weak, nonatomic) IBOutlet id<FBSDKLoginButtonDelegate> delegate;
|
/**
|
Gets or sets the login behavior to use
|
*/
|
@property (assign, nonatomic) FBSDKLoginBehavior loginBehavior;
|
/**
|
The publish permissions to request.
|
|
|
Use `defaultAudience` to specify the default audience to publish to.
|
Note this is converted to NSSet and is only
|
an NSArray for the convenience of literal syntax.
|
*/
|
@property (copy, nonatomic) NSArray *publishPermissions;
|
/**
|
The read permissions to request.
|
|
|
Note, that if read permissions are specified, then publish permissions should not be specified. This is converted to NSSet and is only
|
an NSArray for the convenience of literal syntax.
|
*/
|
@property (copy, nonatomic) NSArray *readPermissions;
|
/**
|
Gets or sets the desired tooltip behavior.
|
*/
|
@property (assign, nonatomic) FBSDKLoginButtonTooltipBehavior tooltipBehavior;
|
/**
|
Gets or sets the desired tooltip color style.
|
*/
|
@property (assign, nonatomic) FBSDKTooltipColorStyle tooltipColorStyle;
|
|
@end
|
|
/**
|
@protocol
|
A delegate for `FBSDKLoginButton`
|
*/
|
@protocol FBSDKLoginButtonDelegate <NSObject>
|
|
@required
|
/**
|
Sent to the delegate when the button was used to login.
|
- Parameter loginButton: the sender
|
- Parameter result: The results of the login
|
- Parameter error: The error (if any) from the login
|
*/
|
- (void)loginButton:(FBSDKLoginButton *)loginButton
|
didCompleteWithResult:(FBSDKLoginManagerLoginResult *)result
|
error:(NSError *)error;
|
|
/**
|
Sent to the delegate when the button was used to logout.
|
- Parameter loginButton: The button that was clicked.
|
*/
|
- (void)loginButtonDidLogOut:(FBSDKLoginButton *)loginButton;
|
|
@optional
|
/**
|
Sent to the delegate when the button is about to login.
|
- Parameter loginButton: the sender
|
- Returns: YES if the login should be allowed to proceed, NO otherwise
|
*/
|
- (BOOL) loginButtonWillLogin:(FBSDKLoginButton *)loginButton;
|
|
@end
|
