1.0.0 • Published 8 years ago

jquery-facebook-authorize v1.0.0

Weekly downloads
3
License
Apache-2.0
Repository
github
Last release
8 years ago

jquery-facebook-authorize

jQuery Plugin to simplify the process of requesting Facebook permissions, such that you only proceed forward in sign-up once the user has granted all you require.

This worked with v2.5 and v2.6, I haven't back-tested it, and let me know if it breaks in the future.

Install

Simply include the asset and the Facebook API, see under Usage below.

Usage

This is simpler, but does require that you initial the Facebook API in your page already, something like the following:

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>
<script src="jquery-facebook-authorize/jquery.facebook-authorize.min.js"></script>

<script>
window.fbAsyncInit = function() {
    FB.init({
        appId   : XXXXXXXXXXXXXXXXXXXXXXX,
        cookie  : true,
        xfbml   : true, /* parse social plugins on this page. */
        version : 'v2.5'
    });
};

(function(d, s, id){
    var js, fjs = d.getElementsByTagName(s)[0];
    if (d.getElementById(id)) {return;}
    js = d.createElement(s); js.id = id;
    js.src = "//connect.facebook.net/en_US/sdk.js";
    fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));
</script>


<div id='error_msgs'></div>

<div class='row'>
  <button id='facebook_request' class="btn btn-default" style="color:#0b62a4;">
    <i class="fa fa-facebook-square"></i> Login with Facebook
  </button>
</div>

<script>
    $(function() {
        var $fbreq = $('#facebook_request');

        var options = {required : ['public_profile', 'email', 'user_friends', 'publish_actions'],
                       optional: []};
        $fbreq.facebookAuthorize(options);

        $fbreq.on('facebook-request-clicked', function(event) {
            $('#error_msgs').empty();
        });
        $fbreq.on('facebook-missing-required', function(event, missing) {
            $('#error_msgs').text('missing: ' + JSON.stringify(missing));
        });
        $fbreq.on('facebook-success', function(event, granted, missing, details) {
            /* move the user onto whatever step applies. */
            createOrLogin(granted, details);
        });
        $fbreq.on('facebook-not-authorized', function(event) {
            $('#error_msgs').text('not authorized');
        });
        $fbreq.on('facebook-not-loggedin', function(event) {
            $('#error_msgs').text('not logged in...');
        });
    });
</script>

Options

OptionDescription
requiredList of required permissions.
optionalList of optional permissions.

Events

EventHandler
facebook-request-clickedfunction(event): - event - jQuery event
facebook-missing-requiredfunction(event, missing): - event - jQuery event - missing - comma separated string of missing required permissions
facebook-successfunction(event, granted, missing, details): - event - jQuery event - granted - comma separated string of all permissions granted - missing - comma separated list of any missing optional permissions - details - Facebook API response.authResponse object
facebook-not-authorizedfunction(event): - event - jQuery event
facebook-not-loggedinfunction(event): - event - jQuery event

License

Apache License 2.0