TwitterSocialAdapter

From GreenVulcano Wiki
Revision as of 08:38, 14 May 2014 by G.dimaio (talk | contribs)
Jump to: navigation, search

Twitter adapter is an implementation of the Social Adapter dedicated to Twitter platform. It can be called as specified into GVSocialAdapter-Configuration specifying a method name to call, or with some custom function reflecting Twitter ones.

Please refer to GVSocialAdapter-Configuration to see the generic call.

The VCL operations usable in the workflows are the following:

Plug-in Use this for ...
Tweet.png twitter-update-status tweet
Retweet.png twitter-retweet-status retweet
Follow.png twitter-enable-notification follow
Unfollow.png twitter-disable-notification unfollow
Follower.png twitter-get-followers-ids get followers
AddUser.png twitter-get-friends-ids get friends
Message.png twitter-send-direct-message send direct tweet
Plug-in Use this for ...
Tweet.png twitter-get-user-timeline get user timeline
Tweet.png twitter-search search status updates

Its attributes are:

Attribute Type Description
type fixed This attribute must assume the value social-adapter.
class fixed This attribute must assume the value it.greenvulcano.gvesb.social.twitter.TwitterSocialAdapter.
social fixed This attribute must assume the value twitter.

Might contain the following sub-elements:

Account

Defines the properties of a Twitter application account.

Its attributes are:

Attribute Type Description
name required Account name (avoid spaces in @name value).
consumer_key required Account consumer key.
consumer_secret required Account consumer secret.
twitteruserid required Account consumer twitter id.

For every Account, the information must be completed defining the following couple of properties into TwitterAccounts.properties file:

ACCOUNT_NAME.oauth_access_token=...
ACCOUNT_NAME.oauth_access_token_secret=...   

where ACCOUNT_NAME is Account/@name value.

To get the required token/key/secret follow the instructions on tokens-devtwittercom