Atomic Plugins for Facebook

This repo contains Cocoon Social Interface for the Facebook Extension designed using the Atomic Plugins paradigm.

You can contribute and help to create more awesome plugins.

##About Atomic Plugins

Atomic Plugins provide an elegant and minimalist API and are designed with portability in mind from the beginning. Framework dependencies are avoided by design so the plugins can run on any platform and can be integrated with any app framework or game engine.

#Provided APIs

• JavaScript API
• API Reference
• Introduction
• Setup your project
• Example

##JavaScript API:

###API Reference

See API Documentation

###Introduction

Cocoon.Social.Facebook class provides an easy to use social interface for Facebook.

###Setup your project

Releases are deployed to Cordova Plugin Registry. You only have to install the desired plugins using Cordova CLI, CocoonJS CLI or Ludei's Cocoon.io Cloud Server.

cordova plugin add cocoon-plugin-social-ios-facebook --variable APP_ID=xxxxxxxx --variable APP_NAME=AppName
cordova plugin add cocoon-plugin-social-android-facebook --variable APP_ID=xxxxxxxx --variable APP_NAME=AppName

The following JavaScript files are included automatically:

cocoon_social.js cocoon_facebook.js

###Example

//How to initialize for iOS, Android & Browser
var social;
	
Cocoon.Social.Facebook.init({
    appId: "XXXXXXXXXXXXXXXXXXXXX",
        xfbml: true,
        version: 'v2.5'
}, fbInitialized);

function fbInitialized() {
    social = Cocoon.Social.Facebook.getSocialInterface(); //high level abstraction API
}


//API examples using high level abstraction API got by calling getSocialInterface()
//You can also use FB oficial API (api, ui, Event methods) using the Cocoon.Social.Facebook object.
var loggedIn = social.isLoggedIn();

function loginSocial() {
	if (!social.isLoggedIn()) {
    	social.login(function(loggedIn, error) {
            if (error) {
               console.error("login error: " + error.message);
            }
            else if (loggedIn) {
               console.log("login succeeded");
            }
            else {
               console.log("login cancelled");
            }
    	});
	}
}

loginSocial();

	social.submitAchievement(achievementID, function(error){
	if (error)
    	console.error("submitAchievement error: " + error.message);
});

social.showAchievements(function(error){
	if (error)
    	console.error("showAchievements error: " + error.message);
});

social.submitScore( score, function(error){
	if (error)
		console.error("submitScore error: " + error.message);
});

social.showLeaderboard(function(error){
	if (error)
		console.error("showLeaderbord error: " + error.message);
});

social.logout();

#License

Mozilla Public License, version 2.0

Copyright (c) 2015 Ludei

See MPL 2.0 License