History

Adam Magness ca3c45101e Network was moved to src update all function calls to use class, insert use statements and remove require_once statements		2018-01-27 08:52:02 -05: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	Update strings	2018-01-20 11:01:59 -05: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	Network was moved to src	2018-01-27 08:52:02 -05:00

README.md

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 Addon 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 addon configuration. Friendica will then try to acquire the final OAuth credentials from the API, if successful the addon 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.