SocialGap

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 11 Open GitHub ↗

Plugin developed to be used with Mmarazzu Mobile.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

SocialGap
=========

SocialGap is a simple library intended to ease the integration of PhoneGap hybrid mobile apps with social networks.
It is modular, so it can be easily extended and it reduces overhead since you import only the modules you need.
This plugin has been developed as a proof of concept while developing Mmarazzu Mobile app.
This software is not intended for production usage as it is because of the following list of known needed modifications:

<ol>
	<li> 
		Facebook long-lived token support needs the app-secret. This should not be deployed on the clients. 
		In order to use the Facebook API as intended you need to transform short-lived token in long-lived 
		ones on your servers and then transport the tokens on the clients, where they will be stored.
		More information: https://developers.facebook.com/docs/facebook-login/access-tokens
	</li>
</ol>

Setup
-------

Including this library in your project is quite easy.
This software require the <a href="https://github.com/apache/cordova-plugin-inappbrowser/blob/master/doc/index.md" target="_blank">inAppBrowser</a> plugin and the <a href="http://modernizr.com/" target="_blank">modernizr</a> javascript library.

If you do not have it already, you can install the inAppBrowser plugin by typing the following command from within your app main folder: 
<code>cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git</code>

Once the prerequisites are in place, reference the following js files from your html page:
 <pre><code>	&lt;script type=&quot;text/javascript&quot; src=&quot;js/modernizr.js&quot;&gt;&lt;/script&gt;
	&lt;script type=&quot;text/javascript&quot; src=&quot;js/SocialGap/socialGap.js&quot;&gt;&lt;/script&gt;
	&lt;script type=&quot;text/javascript&quot; src=&quot;js/SocialGap/socialGap_facebook.js&quot;&gt;&lt;/script&gt;</code></pre>

From now on the setup procedure differ based on the module you would like to use.

<ul>
	<li>Facebook: 
		When deviceready event is received, set up the Facebook extension calling the <code>Facebook_ChangeSettings</code>
		function as follows: 
		 <pre><code> SocialGap.Facebook_ChangeSettings('appID', 'appSecret', 'fbAppDomain', 'fbScopes');</code></pre> 
		
		Then prepare two callback functions. 
		One of them will be called in case of success receiving as parameter the Facebook access token. 
		Instead, the other will be called in case of failure.
		 <pre><code>	fbLogonSuccess: function(accessToken)
	{
		alert(token);
	}

fbLogonFailure: function(){
		alert('Fail');
	}</code></pre>
		
		Once ready build a link that will start the authentication process.
		 <pre><code>	&lt;a onclick=&quot;SocialGap.Facebook_PerformLogon(fbLogonSuccess, fbLogonFailure);&quot;&gt;
		Logon with Facebook
	&lt;/a&gt;</code></pre>
		
	</li>
	
	<li>LinkedIn: 
		When deviceready event is received, set up the Facebook extension calling the <code>Linkedin_ChangeSettings</code>
		function as follows: 
		 <pre><code> SocialGap.Linkedin_ChangeSettings('apiKey', 'secretKey', 'ldAppDomain', 'ldScopes');</code></pre> 
		
		Then prepare two callback functions. 
		One of them will be called in case of success receiving as parameter the LinkedIn access token. 
		Instead, the other will be called in case of failure.
		 <pre><code>	ldLogonSuccess: function(accessToken)
	{
		alert(token);
	}

ldLogonFailure: function(){
		alert('Fail');
	}</code></pre>
		
		Once ready build a link that will start the authentication process.
		 <pre><code>	&lt;a onclick=&quot;SocialGap.Linkedin_PerformLogon(ldLogonSuccess, ldLogonFailure);&quot;&gt;
		Logon with LinkedIn
	&lt;/a&gt;</code></pre>
		
	</li>
	
	
</ul>

Develop an extension
---------------------
Developing an extension is quite straightforward. 
We have prepared a "template" in <code>example/js/socialGap_basic.js</code> which can be used as a starting point for extending this library.

Run the example
-------
In order to make the example work follow these steps:
<ol>
	<li> Create a new PhoneGap app typing something similar to: 
 		<code>phonegap create YourApp/ com.whatever.yourapp YourApp</code></li>
		<li> Copy the files contained in the <code>example</code> folder into the <code>www</code> folder of the project you've just created</li>
		<li> Copy the folder <code>Social Gap</code> contained under the <code>lib</code> directory into the folder <code>www/js</code> of the project you have just created.</li>
		<li>Set the required settings for the extension(s) you need as explained above.</li>
		<li>Install the <a href="https://github.com/apache/cordova-plugin-inappbrowser/blob/master/doc/index.md" target="_blank">inAppBrowser</a> plugin for your project, typing these commands:
			<pre><code>cd YourApp
cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git</code></pre>			
		</li>
		<li> 
			Run the project for the platform you like most. 
			For instance type the following command from within <code>YourApp</code> directory: 
 			<code>phonegap run android</code>
		</li>
</ol>

SocialGap

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README