Nihilism Philisophy Major

    mp-cordova-plugin-facebook

    1.4.1 • Public • Published

    cordova-plugin-facebook4

    Use Facebook SDK version 4 in Cordova projects

    Installation

    Make sure you've registered your Facebook app with Facebook and have an APP_ID https://developers.facebook.com/apps.

    $ cordova plugin add mp-cordova-plugin-facebook --save --variable APP_ID="123456789" --variable APP_NAME="myApplication"

    Usage

    This is a fork of the official plugin for Facebook in Apache Cordova that implements the latest Facebook SDK. Unless noted, this is a drop-in replacement. You don't have to replace your client code.

    The Facebook plugin for Apache Cordova allows you to use the same JavaScript code in your Cordova application as you use in your web application. However, unlike in the browser, the Cordova application will use the native Facebook app to perform Single Sign On for the user. If this is not possible then the sign on will degrade gracefully using the standard dialog based authentication.

    Compatibility

    • Cordova v5.0.0.
    • cordova-android >= 4.0
    • cordova-ios >= 3.8
    • cordova-browser >= 3.6

    Unfortunately, at this time PhoneGap Build is not supported on Android, since this plugin uses Gradle and PhoneGap Build does not support that yet

    Install Guides

    API

    Login

    facebookConnectPlugin.login(Array strings of permissions, Function success, Function failure)

    NOTE : Developers should call facebookConnectPlugin.browserInit(<appId>) before login - Web App ONLY (see Web App Guide)

    Success function returns an Object like:

    {
    	status: "connected",
    	authResponse: {
    		session_key: true,
    		accessToken: "<long string>",
    		expiresIn: 5183979,
    		sig: "...",
    		secret: "...",
    		userID: "634565435"
    	}
    }
    

    Failure function returns an error String.

    Logout

    facebookConnectPlugin.logout(Function success, Function failure)

    Get Status

    facebookConnectPlugin.getLoginStatus(Function success, Function failure)

    Success function returns an Object like:

    {
        authResponse: {
            userID: "12345678912345",
            accessToken: "kgkh3g42kh4g23kh4g2kh34g2kg4k2h4gkh3g4k2h4gk23h4gk2h34gk234gk2h34AndSoOn",
            session_Key: true,
            expiresIn: "5183738",
            sig: "..."
        },
        status: "connected"
    }
    

    For more information see: Facebook Documentation

    Show a Dialog

    facebookConnectPlugin.showDialog(Object options, Function success, Function failure)

    Example options - Share Dialog:

    {
    	method: "share",
    	href: "http://example.com",
    	caption: "Such caption, very feed.",
    	description: "Much description",
    	picture: 'http://example.com/image.png'
    }
    

    Game request:

    {
    	method: "apprequests",
    	message: "Come on man, check out my application.",
    	data: data,
    	title: title,
    	actionType: 'askfor',
    	filters: 'app_non_users'
    }
    

    Send Dialog:

    {
    	method: "send",
    	caption: "Check this out.",
    	link: "http://example.com",
    	description: "The site I told you about",
    	picture: "http://example.com/image.png"
    }
    

    For options information see: Facebook share dialog documentation Facebook send dialog documentation

    Success function returns an Object with postId as String or from and to information when doing apprequest. Failure function returns an error String.

    The Graph API

    facebookConnectPlugin.api(String requestPath, Array permissions, Function success, Function failure)

    Allows access to the Facebook Graph API. This API allows for additional permission because, unlike login, the Graph API can accept multiple permissions.

    Example permissions:

    ["public_profile", "user_birthday"]
    

    Success function returns an Object.

    Failure function returns an error String.

    Note: "In order to make calls to the Graph API on behalf of a user, the user has to be logged into your app using Facebook login."

    For more information see:

    Events

    App events allow you to understand the makeup of users engaging with your app, measure the performance of your Facebook mobile app ads, and reach specific sets of your users with Facebook mobile app ads.

    Activation events are automatically tracked for you in the plugin.

    Events are listed on the insights page

    Log an Event

    logEvent(String name, Object params, Number valueToSum, Function success, Function failure)

    • name, name of the event
    • params, extra data to log with the event (is optional)
    • valueToSum, a property which is an arbitrary number that can represent any value (e.g., a price or a quantity). When reported, all of the valueToSum properties will be summed together. For example, if 10 people each purchased one item that cost $10 (and passed in valueToSum) then they would be summed to report a number of $100. (is optional)

    Log a Purchase

    logPurchase(Number value, String currency, Function success, Function failure)

    NOTE: Both parameters are required. The currency specification is expected to be an ISO 4217 currency code

    App Invites

    facebookConnectPlugin.appInvite(Object options, Function success, Function failure)

    Please check out the App Invites Overview before using this. The URL is expected to be an App Link.

    Example options:

    {
      url: "http://example.com",
      picture: "http://example.com/image.png"
    }
    

    Sample Code

    Login

    In your onDeviceReady event add the following

    var fbLoginSuccess = function (userData) {
      console.log("UserInfo: ", userData);
    }
     
    facebookConnectPlugin.login(["public_profile"], fbLoginSuccess,
      function loginError (error) {
        console.error(error)
      }
    );

    Get Access Token

    If you need the Facebook access token (for example, for validating the login on server side), do:

    var fbLoginSuccess = function (userData) {
      console.log("UserInfo: ", userData);
      facebookConnectPlugin.getAccessToken(function(token) {
        console.log("Token: " + token);
      });
    }
     
    facebookConnectPlugin.login(["public_profile"], fbLoginSuccess,
      function (error) {
        console.error(error)
      }
    );

    Get Status and Post-to-wall

    For a more instructive example change the above fbLoginSuccess to;

    var fbLoginSuccess = function (userData) {
      console.log("UserInfo: ", userData);
      facebookConnectPlugin.getLoginStatus(function onLoginStatus (status) {
        console.log("current status: ", status);
        facebookConnectPlugin.showDialog({
          method: "share"
        }, function onShareSuccess (result) {
          console.log("Posted. ", result);
        });
      });
    };

    Getting a User's Birthday

    Using the graph api this is a very simple task:

    facebookConnectPlugin.api("<user-id>/?fields=id,email", ["user_birthday"],
      function onSuccess (result) {
        console.log("Result: ", result);
        /* logs:
          {
            "id": "000000123456789",
            "email": "myemail@example.com"
          }
        */
      }, function onError (error) {
        console.error("Failed: ", error);
      }
    );

    Publish a Photo

    Send a photo to a user's feed

    facebookConnectPlugin.showDialog({
        method: "share",
        picture:'https://www.google.co.jp/logos/doodles/2014/doodle-4-google-2014-japan-winner-5109465267306496.2-hp.png',
        name:'Test Post',
        message:'First photo post',
        caption: 'Testing using phonegap plugin',
        description: 'Posting photo using phonegap facebook plugin'
      }, function (response) {
        console.log(response)
      }, function (response) {
        console.log(response)
      }
    );

    Install

    npm i mp-cordova-plugin-facebook

    DownloadsWeekly Downloads

    1

    Version

    1.4.1

    License

    Apache 2.0

    Last publish

    Collaborators

    • jwebcat
    • nvisionweb