friendica-addons/statusnet
Michael Vogel 7dcfa83312
Merge pull request #480 from MrPetovan/task/4092-move-auth-to-src
Move auth to src
2018-01-04 18:43:46 +01:00
..
lang ES translation work THX Albert 2016-11-18 07:57:19 +01:00
templates The settings for the application name are removed since they will be filled automatically. 2015-03-22 09:26:18 +01:00
LICENSE SN license stuff 2013-05-31 15:55:37 +02:00
README.md Updated addon descriptions and readme files for several addons. 2015-11-14 09:22:32 +01:00
codebird.php The tempory path is now fetched from a new function (that ensures that the value is set correctly) 2014-06-23 22:35:00 +02:00
signinwithstatusnet.png some files were executable, now they are not 2017-12-07 14:26:26 +01:00
statusnet.css some files were executable, now they are not 2017-12-07 14:26:26 +01:00
statusnet.php Merge pull request #480 from MrPetovan/task/4092-move-auth-to-src 2018-01-04 18:43:46 +01:00

README.md

GNU Social Connector

Main authors Tobias Diekershoff and Michael Vogel.

With this addon to friendica you can give your users the possibility to post their public messages to GNU Social and to import their timeline of their legacy GNU Social accounts. The messages will be strapped their rich context and shortened if necessary.

Requirements

Due to the distributed nature of the GNU Social network, each user who wishes to forward public messages to a GNU Social account has to get the OAuth credentials for themselves, which makes this addon a little bit more user unfriendly than the Twitter Plugin is. Nothing too geeky though!

The inclusion of a shorturl for the original posting in cases when the message was longer than the maximal allowed notice length requires it, that you have PHP5+ and curl on your server.

Where to find

In the friendica addon git repository /statusnet/, 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 GNU Social.

Configuration

User Configuration

When the addon is activated the user has to acquire three things in order to connect to the GNU Social account of choice.

  • the base URL for the GNU Social API, for identi.ca this was https://identi.ca/api/
  • OAuth Consumer key & secret

To get the OAuth Consumer key pair the user has to (a) ask her Friendica admin if a pair already exists or (b) has to register the Friendica server as a client application on the GNU Social server. This can be done from the account settings under "Connect -> Connections -> Register an OAuth client application -> Register a new application".

During the registration of the OAuth client remember the following:

  • there is no callback URL
  • register a desktop client
  • with read & write access
  • the Source URL should be the URL of your friendica server

After the required credentials for the application are stored in the configuration you have to actually connect your friendica account with GNU Social. To do so follow the Sign in with GNU Social button, allow the access and copy the security code into the plugin configuration. Friendica will then try to acquire the final OAuth credentials from the API, if successful the plugin settings will allow you to select to post your public messages to your GNU Social account.

License

The GNU Social Connector is licensed under the 3-clause BSD license see the LICENSE file in the addons directory.