Friendica Communications Platform (please note that this is a clone of the repository at github, issues are handled there)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Friendika d124c67322 remove note about accounts being hidden in register email 11 years ago
OAuth.php add twitter plugin 11 years ago
README added README files for the piwik, twitter and statusnet addon 11 years ago
lighter.png Post to Twitter plugin 11 years ago
slinky.php added Slinky library by Beau Lebens for shortening the post url 11 years ago
twitter.css Post to Twitter plugin 11 years ago
twitter.php disable network toggles when ACL's are entered 11 years ago
twitteroauth.php add twitter plugin 11 years ago


____ Twitter Plugin ____
By Tobias Diekershoff

!! This addon is currently in under development. If you have any problem !!
!! with it, please contact the Author. !!

With this addon to Friendika you can give your user the possibility to post
their *public* messages to Twitter. The messages will be strapped their rich
context and shortened to 140 characters length if necessary. If shortening of
the message was performed a link will be added to the Tweet pointing to the
original message on your server.

There is a similar addon for forwarding public messages to
"StatusNet": [[StatusNet Plugin]].

Online version of this document:

___ Requirements ___

To use this plugin you have to register your Friendika instance as an
_client application_ for Twitter with _read and write_ access, we do not intend
to use Twitter for login. The registration can be done at
and you need to have a Twitter account to do so.

After you registered the application you get an OAuth consumer key / secret
pair that identifies your app, you will need them for configuration.

The inclusion of a shorturl for the original posting in cases when the
message was longer then 140 characters requires it, that you have *PHP5+* and
*curl* on your server.

___ Where to find ___

In the Friendika git repository /addon/twitter/, this directory contains
all required PHP files (including the Twitter OAuth library [1] by Abraham
Williams, MIT licensed and the Slinky library [2] by Beau Lebens, BSD license),
a CSS file for styling of the user configuration and an image to _Sign in with


___ Configuration ___

__ Global Configuration __

To activate this addon add @twitter@ to the list of active addons in your
.htconfig.php file
$a->config['system']['addon'] = "twitter, ..."
Afterwards you need to add your OAuth consumer key / secret pair to it by
adding the following to lines

$a->config['twitter']['consumerkey'] = 'your consumer KEY here';
$a->config['twitter']['consumersecret'] = 'your consumer SECRET here';

When this is done your user can now configure their Twitter connection at
"Settings -> Addon Settings" and enable the forwarding of their *public*
messages to Twitter.

__ User Configuration __

When the OAuth consumer informations are correctly placed into the
configuration file and a user visits the "Addon Settings" page they can now
connect to Twitter. To do so one has to follow the _Sign in with Twitter_
button (the page will be opened in a new browser window/tab) and get a PIN from
Twitter. This PIN has to be entered on the settings page. After submitting the
PIN the plugin will get OAuth credentials identifying this user from the
Friendika account.

If this first step was successful the Twitter configuration will be changed
on the "Addon Settings" page displaying two check boxes. One to enable/disable
the forwarding of *all public* postings to Twitter and one to clear the
personal configuration from the Twitter credentials.