Table of contents
Description
Provides access to tweets as well as profiles of connected people of a twitter user.
Responsible Person
Status
Status | Ready for use |
|---|
Possible Values: Ready for Use, In Development, Plannend, Broken
Aggregation Features
Fill | Yes |
|---|---|
Update | No |
Enrich | No |
Source Code
Project: https://github.com/soziotech/CommunityMashup/tree/master/sources/TwitterSourceService
Tracking
Planned Todos
Bugs
Feature Request
Used Service
Name | |
|---|---|
Link | |
Developer Portal | |
Authentication | OAuth 2.0 |
Used Libraries
Name | Version | License | Usage | Link |
|---|---|---|---|---|
Twitter4J | 2.2.5 | Apache License 2.0 | Compiled |
Possible Usage Values: Compiled, Source, Extended Source, Modified Source
Configuration
Key | Description | Possible Values | Default | Required (Yes/No) |
|---|---|---|---|---|
consumerKey | Consumer key for authentication | Text | empty | Yes |
| consumerSecret | Consumer secret for authentication | Text | empty | Yes |
| accessToken | Access token for authentication | Text | none | Yes |
| accessTokenSecret | Access token for authentication | Text | none | Yes |
| commandLineAuthentication | Switch to turn on a command line authentication with mendeley. This should only be used in development environments. The access token and its secret should be empty in this case. | true/false | false | No |
| addPeopleStatus | The status is the last tweet of a person. If set to true this will be added for every added person. | true/false | false | No |
| addMentionedPeople | If set to true, persons mentioned in tweets will be added. | true/false | false | No |
| addURLEntities | If set to true, urls appearing in tweets will be added as websites to content of a tweet. Note: Twitter supports this only since the middle of 2012. Urls in older tweets will not be handled. | true/false | false | No |
| loadHomeTimeline | If set to true, the home timeline (the newest tweets from persons the account owner follows) will be added. | true/false | false | No |
| loadUserTimeline | If set to true, the user timeline (the newest tweets of the account owner) will be added. | true/false | false | No |
loadAccountOwner | Whether the profile of the account owner should be loaded or not | true/false | true | No |
| numberOfUserTimelineTweets | The number of tweets from the user timeline that should be added. | 1..200 | 20 | No |
| loadFollowing | If set to true, persons following the account owner will be added. Note: This feature needs many api calls and the limits will be reached very quickly. | true/false | false | No |
| loadFollowers | If set to true, persons the account owner follows will be added. Note: This feature needs many api calls and the limits will be reached very quickly. | true/false | false | No |
| interconnectFollowing | If set to true, persons in the data set will be connected depending of their following relation on twitter. Note: This feature needs many api calls and the limits will be reached very quickly. | true/false | false | No |
| interconnectFollowers | If set to true, persons in the data set will be connected depending of their follow relation on twitter. Note: This feature needs many api calls and the limits will be reached very quickly. | true/false | false | No |
| search | Term to search tweets for. | Text, e. g. #cscw | none | No |
| numberOfSearchTweets | Number of tweets that should be loaded at search. | 1..100 | 20 | No |
| loadHighResProfileImage | Whether a higher res profile image should be loaded for every twitter user. Results to an extra api call for every user. | true/false | false | No |
searchLatitude | Geolocation latitude to search for tweets. | latitude | none | No |
searchLongitude | Geolocation longitude to search for tweets. | longitude | none | No |
searchRadius | Radius around the geolocation to search for tweets. | 1-100 | 100 | No |
searchRadiusUnit | Unit of the search radius. | km/mi | km | No |
loadPhotos | Whether to load photos from media entities as content attachments. | true/false | false | No |
loadPhotoTweetsOnly | Whether to keep only tweets with photos. | true/false | false | No |
Example:
<sources bundleId="org.sociotech.communitymashup.source.TwitterSourceService" name="Tweets">
<configuration>
<properties Key="consumerKey" Value="-" />
<properties Key="consumerSecret" Value="-" />
<properties Key="accessToken" Value="-" />
<properties Key="accessTokenSecret" Value="-" />
<properties Key="loadHomeTimeline" Value="false" />
<properties Key="loadUserTimeline" Value="true" />
<properties Key="numberOfUserTimelineTweets" Value="50" />
<properties Key="addURLEntities" Value="true"/>
</configuration>
</sources>
Description | With this configuration the newest 50 tweets of the account provider will be loaded. The url in tweets will be added as websites. Note: access token and secret as well as consumer key and secret must be replaced to run this configuration. |
|---|
Meta-Informations
Type | Description | Value | Items |
|---|---|---|---|
MetaTag | Meta tag for items added by a twitter source. | Items | |
| MetaTag | Meta tag for profile images from twitter. | twitter_profile_image | Images |
| MetaTag | Meta tag for persons that provided their account for the twitter source. (The provider of the access token) | provided_twitter_profile | Person |
| MetaTag | Meta tag for all tweeted images. | tweetpic | Content |
Transformation
External | CommunityMashup |
|---|---|
Tweet | Content |
| Url in Tweet | Website added to tweet Content |
| Hashtag in Tweet | Tag added to Content |
| Person mentioned in tweet | Contributor of Content |
| Twitter profile | Person |
| Twitter screen name | WebAccount added to Person |
| Twitter account creation date | Creation date of WebAccount |
| Twitter profile url | WebSite added to Person |
| Twitter profile image | Image added to Person |
| Location in twitter profile | Location (single stringValue) added to Person |