Difference between revisions of "TwitterSocialAdapter"
| Line 50: | Line 50: | ||
| ===Account=== | ===Account=== | ||
| − | + | Defines the properties of a Twitter application account. | |
| + | |||
| + | Its attributes are: | ||
| {|class="gvtable" | {|class="gvtable" | ||
| ! Attribute !! Type !! Description | ! Attribute !! Type !! Description | ||
| |- | |- | ||
| − | | name || required || Account name. | + | | name || required || Account name '''(avoid spaces in @name value)'''. | 
| |- | |- | ||
| | consumer_key || required || Account consumer key. | | consumer_key || required || Account consumer key. | ||
| Line 63: | Line 65: | ||
| |} | |} | ||
| − | + | 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=... | ||
|   ACCOUNT_NAME.oauth_access_token_secret=...     |   ACCOUNT_NAME.oauth_access_token_secret=...     | ||
| − | where '''ACCOUNT_NAME''' is '''@name''' value. | + | where '''ACCOUNT_NAME''' is '''Account/@name''' value. | 
| + | |||
| + | To get the required token/key/secret follow the instructions on [https://dev.twitter.com/docs/auth/tokens-devtwittercom tokens-devtwittercom] | ||
Revision as of 08:38, 14 May 2014
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 ... | |
|---|---|---|
|  | twitter-update-status | tweet | 
|  | twitter-retweet-status | retweet | 
|  | twitter-enable-notification | follow | 
|  | twitter-disable-notification | unfollow | 
|  | twitter-get-followers-ids | get followers | 
|  | twitter-get-friends-ids | get friends | 
|  | twitter-send-direct-message | send direct tweet | 
| Plug-in | Use this for ... | |
|---|---|---|
|  | twitter-get-user-timeline | get user timeline | 
|  | 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
