statusnet/README

   1 ____ StatusNet Plugin ____
   2 by Tobias Diekershoff
   3    tobias.diekershoff(at)gmx.net
   4
   5 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   6 !! This addon is currently under development. If you have any problem       !!
   7 !! with it, please contact the Author.                                      !!
   8 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   9
  10 With this addon to Friendika you can give your user the possibility to post
  11 their public messages to any StatusNet instance (like identi.ca for example).
  12 The messages will be strapped their rich context and shortened to to the character
  13 limit of the StatusNet instance in question if necessary. If shortening of the
  14 message was performed a link will be added to the notice pointing to the
  15 original message on your server.
  16
  17 There is a similar plugin to forward public messages to Twitter: Twitter Plugin.
  18
  19 Online version of this document: http://ur1.ca/35mpb
  20
  21 ___ Requirements ___
  22
  23 Due to the distributed nature of the StatusNet network, each user who wishes to
  24 forward public messages to a StatusNet account has to get the OAuth credentials
  25 for themselves, which makes this addon a little bit more user unfriendly than
  26 the Twitter Plugin is. Nothing too geeky though!
  27
  28 The inclusion of a shorturl for the original posting in cases when the message
  29 was longer than the maximal allowed notice length requires it, that you have
  30 PHP5+ and curl on your server.
  31 Where to find
  32
  33 In the Friendika git repository /addon/statusnet/, this directory contains all
  34 required PHP files (including the Twitter OAuth library [1] by Abraham Williams,
  35 MIT licensed and the Slinky library [2] by Beau Lebens, BSD license), a CSS file
  36 for styling of the user configuration and an image to Sign in with StatusNet.
  37
  38 [1] https://github.com/abraham/twitteroauth
  39 [2] http://dentedreality.com.au/projects/slinky
  40
  41 ___ Configuration ___
  42
  43 __ Global Configuration __
  44
  45 To activate this addon add statusnet to the list of active addons in your
  46 .htconfig.php file
  47     $a->config['system']['addon'] = "statusnet, ...".
  48
  49 __ User Configuration __
  50
  51 When the addon is activated the user has to aquire three things in order to
  52 connect to the StatusNet account of choice.
  53  * the base URL for the StatusNet API, for identi.ca this is
  54    https://identi.ca/api/
  55  * OAuth Consumer key & secret
  56
  57 To get the OAuth Consumer key pair the user has to (a) ask her Friendika admin
  58 if a pair already exists or (b) has to register the Friendika server as a
  59 client application on the StatusNet server. This can be done from the account
  60 settings under "Connect -> Connections -> Register an OAuth client application
  61 -> Register a new application".
  62
  63 During the registration of the OAuth client remember the following:
  64  * there is no callback url
  65  * register a desktop client
  66  * with read & write access
  67  * the Source URL should be the URL of your Friendika server
  68
  69 After the required credentials for the application are stored in the
  70 configuration you have to actually connect your Friendika account with
  71 StatusNet. To do so follow the Sign in with StatusNet button, allow the access
  72 and copy the security code into the plugin configuration. Friendika will then
  73 try to acquire the final OAuth credentials from the API, if successful the
  74 plugin settings will allow you to select to post your public messages to your
  75 StatusNet account.