Hoodie Social Plugin

About the plugin

This plugin allows Hoodie app integration with popular social network providers. Social authentication, authorization, status updates, get contacts, and get followers are currently supported. Supported providers currently include Facebook, Twitter, and Google+.

Contributors

How to get help

The best way to get help is to open an issue on Github. You may email us at code@appback.com with any other inquiry.

Installation Instructions

Install from the Hoodie CLI

hoodie install social

 
Register your app with each of the providers for API access using the appropriate callback URL

https://your-app-host:port/_api/_auth/facebook|twitter|google/callback

 
Open Pocket, add your provider Key/ID & Secret, then save.

Methods

Signin to Hoodie through a social provider

hoodie.account.socialLogin( providerName, /*optional*/ options )
.done( successCallback)
.fail( errorCallback );

Supported options:

{
    popupOptions: {
        showPGLocation: true //show inAppBrowser location bar
    }
}

 

Connect a Hoodie account to a social account (must be logged in)

hoodie.account.socialConnect( providerName, /*optional*/ options )
.done( successCallback)
.fail( errorCallback );

Supported options:

{
    popupOptions: {
        showPGLocation: true //show inAppBrowser location bar
    }
}

 

Set status message on connected social account (must be logged in)

hoodie.account.socialSetStatus({
    provider: providerName,
    status: status //string for Facebook/Twitter or Google+ moment payload (see https://developers.google.com/+/api/moment-types/add-activity)
})
.done( successCallback)
.fail( errorCallback );

 

Get a user social profile from a connected provider (defaults to current user)

hoodie.account.socialGetProfile(provider, /*optional*/ options)
.done( successCallback)
.fail( errorCallback );

Supported options:

{
    user_id: userId, //provider user ID
    user_name: userName //provider display or screen name
}

 

Get a user’s contacts (aka friends or following) from a connected provider (defaults to current user)

hoodie.account.socialGetContacts(provider, /*optional*/ options)
.done( successCallback)
.fail( errorCallback );

Supported options:

{
    user_id: userId, //provider user ID
    user_name: userName //provider display or screen name
}

 

Get a user’s followers (aka subscribers) from a connected provider (defaults to current user)

hoodie.account.socialGetFollowers(provider, /*optional*/ options)
.done( successCallback)
.fail( errorCallback );

Supported options:

{
    user_id: userId, //provider user ID
    user_name: userName //provider display or screen name
}

Change Log

Version 0.10.1
- Added latest Hoodie compatibility (as of 08/24/2014)
- Fixed issue #19 (Windows app name regex error)
 
Version 0.1.0
- Initial release

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>