From: Michael Vogel Date: Sat, 14 Nov 2015 08:22:32 +0000 (+0100) Subject: Updated addon descriptions and readme files for several addons. X-Git-Url: https://git.mxchange.org/?a=commitdiff_plain;h=bf52de030fbe9c3c170aa0103aa70b110da50c71;p=friendica-addons.git Updated addon descriptions and readme files for several addons. --- diff --git a/appnet/appnet.php b/appnet/appnet.php index 171461de..9eb71713 100644 --- a/appnet/appnet.php +++ b/appnet/appnet.php @@ -2,7 +2,7 @@ /** * Name: App.net Connector - * Description: app.net postings import and export + * Description: Bidirectional (posting and reading) connector for app.net. * Version: 0.2 * Author: Michael Vogel */ diff --git a/buffer/README.md b/buffer/README.md index d46ade85..2ba2b01e 100644 --- a/buffer/README.md +++ b/buffer/README.md @@ -3,3 +3,6 @@ The addon uses the library from [https://github.com/thewebguy/bufferapp-php](htt Please register an app at [http://bufferapp.com/developers/api](http://bufferapp.com/developers/api) Please use (your server address)/buffer/connect as Callback URL. + +After the registration please enter the values for "Client ID" and "Client Secret" in the +[administration](admin/plugins/buffer). diff --git a/fbpost/fbpost.php b/fbpost/fbpost.php index 4c4eda91..72373ff9 100644 --- a/fbpost/fbpost.php +++ b/fbpost/fbpost.php @@ -4,6 +4,7 @@ * Version: 1.3 * Author: Mike Macgirvin * Author: Tobias Hößl + * Status: Unsupported * */ diff --git a/gpluspost/gpluspost.php b/gpluspost/gpluspost.php index a5cbc932..43a1635e 100644 --- a/gpluspost/gpluspost.php +++ b/gpluspost/gpluspost.php @@ -5,6 +5,7 @@ * Description: Posts to a Google+ page with the help of Hootsuite * Version: 0.1 * Author: Michael Vogel + * Status: Unsupported */ function gpluspost_install() { diff --git a/pumpio/README b/pumpio/README deleted file mode 100644 index 4dd90d5f..00000000 --- a/pumpio/README +++ /dev/null @@ -1,5 +0,0 @@ -To let the connector work properly you should define an application name in the .htconfig: - -$a->config['pumpio']['application_name'] = "Name of you site"; - -This name appears at pump.io and is important for not mirroring back posts that came from friendica. diff --git a/pumpio/README.md b/pumpio/README.md new file mode 100644 index 00000000..4dd90d5f --- /dev/null +++ b/pumpio/README.md @@ -0,0 +1,5 @@ +To let the connector work properly you should define an application name in the .htconfig: + +$a->config['pumpio']['application_name'] = "Name of you site"; + +This name appears at pump.io and is important for not mirroring back posts that came from friendica. diff --git a/pumpio/pumpio.php b/pumpio/pumpio.php index 74702414..08668e15 100644 --- a/pumpio/pumpio.php +++ b/pumpio/pumpio.php @@ -1,7 +1,7 @@ */ diff --git a/rendertime/rendertime.php b/rendertime/rendertime.php index d104f12b..b5e486c6 100755 --- a/rendertime/rendertime.php +++ b/rendertime/rendertime.php @@ -26,7 +26,7 @@ function rendertime_page_end(&$a, &$o) { $duration = microtime(true)-$a->performance["start"]; - if (is_site_admin() AND ($_GET["mode"] != "minimal")) + if (is_site_admin() AND ($_GET["mode"] != "minimal") AND !$a->is_mobile AND !$a->is_tablet) $o = $o.'
'.sprintf(t("Performance: Database: %s, Network: %s, Rendering: %s, Parser: %s, I/O: %s, Other: %s, Total: %s"), round($a->performance["database"], 3), round($a->performance["network"], 3), diff --git a/statusnet/README.md b/statusnet/README.md index 99f3a73a..5042e413 100644 --- a/statusnet/README.md +++ b/statusnet/README.md @@ -1,31 +1,30 @@ -StatusNet Connector +GNU Social Connector =================== Main authors Tobias Diekershoff and Michael Vogel. -With this addon to friendica you can give your user the possibility to post -their public messages to any StatusNet instance. The messages will be strapped -their rich context and shortened to to the character limit of the StatusNet -instance in question if necessary. If shortening of the message was performed a -link will be added to the notice pointing to the original message on your -server. +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 StatusNet network, each user who wishes to -forward public messages to a StatusNet account has to get the OAuth credentials +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 StatusNet. +for styling of the user configuration and an image to Sign in with GNU Social. [1]:https://github.com/abraham/twitteroauth [2]:http://dentedreality.com.au/projects/slinky @@ -33,51 +32,18 @@ for styling of the user configuration and an image to Sign in with StatusNet. Configuration ============= -Global Configuration --------------------- - -**If you have configured an admin account, you can configure this plugin from -the admin panel.** First activate it from the plugin section of the panel. -Afterwards you will have a separate configuration page for the plugin, where -you can provide a set of globally available OAuth credentials for different -StatusNet pages which will be available for all users of your server. - -If you don't use the admin panel, you can configure the relay using the -.htconfig.php file of your friendica installation. To activate the relay add -it's name to the list of activated addons. - - $a->config['system']['addon'] = "statusnet, ..." - -If you want to provide preconfigured StatusNet instances for your user add the -credentials for them by adding - - $a->config['statusnet']['sites'] = array ( - array ('sitename' => 'identi.ca', 'apiurl' => 'https://identi.ca/api/', - 'consumersecret' => 'OAuth Consumer Secret here', 'consumerkey' => 'OAuth - Consumer Key here'), - array ('sitename' => 'Some other Server', 'apiurl' => - 'http://status.example.com/api/', 'consumersecret' => 'OAuth - Consumer Secret here', 'consumerkey' => 'OAuth Consumer Key here') - ); - -to the config file. - -Regardless of providing global OAuth credentials for your users or not, they -can always add their own OAuth-Key and -Secret thus enable the relay for any -StatusNet instance they may have an account at. - User Configuration ------------------ When the addon is activated the user has to acquire three things in order to -connect to the StatusNet account of choice. +connect to the GNU Social account of choice. -* the base URL for the StatusNet API, for identi.ca this was https://identi.ca/api/ +* 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 StatusNet server. This can be done from the account +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". @@ -90,58 +56,16 @@ During the registration of the OAuth client remember the following: After the required credentials for the application are stored in the configuration you have to actually connect your friendica account with -StatusNet. To do so follow the Sign in with StatusNet button, allow the access +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 -StatusNet account. - -Mirroring of Public Postings ----------------------------- - -To avoid endless loops of public postings that are send to StatusNet and then -mirrored back into your friendica stream you have to set the _name of the -application you registered there_ of your friendica node is using to post to -StatusNet in the .htconfig.php file. - - $a->config['statusnet']['application_name'] = "yourname here"; - -Connector Options for the User -============================== - -* **Allow posting to StatusNet** If you want your _public postings_ being - optionally posted to your associated StatusNet account as well, you need to - check this box. -* **Send public postings to StatusNet by default** if you want to have _all_ - your public postings being send to your StatusNet account you need to check - this button as well. Otherwise you have to enable the relay of your postings - in the ACL dialog (click the lock button) before posting an entry. -* **Mirror all posts from statusnet that are no replies or repeated messages** - if you want your postings from StatusNet also appear in your friendica - postings, check this box. Replies to other people postings, repostings and your own - postings that were send from friendica wont be mirrored into your friendica - stream. -* **Shortening method that optimizes the post** by default friendica checks how - many characters your StatusNet instance allows you to use for a posting and - if a posting is longer then this amount of characters it will shorten the - message posted on StatusNet and add a short link back to the original - posting. Optionally you can check this box to have the shortening of the - message use an optimization algorithm. _TODO add infos how this is - optimized_ -* **Send linked #-tags and @-names to StatusNet** if you want your #-tags and - @-mentions linked to the friendica network, check this box. If you want to - have StatusNet handle these things for the relayed end of the posting chain, - uncheck it. -* **Clear OAuth configuration** if you want to remove the currently associated - StatusNet account from your friendica account you have to check this box and - then hit the submit button. The saved settings will be deleted and you have - to reconfigure the StatusNet connector to be able to relay your public - postings to a StatusNet account. +GNU Social account. License ======= -The _StatusNet Connector_ is licensed under the [3-clause BSD license][3] see the +The _GNU Social Connector_ is licensed under the [3-clause BSD license][3] see the LICENSE file in the addons directory. [3]: http://opensource.org/licenses/BSD-3-Clause diff --git a/statusnet/statusnet.php b/statusnet/statusnet.php index 7041c399..20f81d6b 100644 --- a/statusnet/statusnet.php +++ b/statusnet/statusnet.php @@ -1,7 +1,7 @@ * Author: Michael Vogel diff --git a/tumblr/README b/tumblr/README deleted file mode 100644 index 9b77bdcd..00000000 --- a/tumblr/README +++ /dev/null @@ -1,7 +0,0 @@ -Register an application at this address: -http://www.tumblr.com/oauth/apps - -use (your server name)addon/tumblr/callback.php as callback URL - -Tumblr-OAuth-Library: -https://groups.google.com/d/msg/tumblr-api/g6SeIBWvsnE/gnWqT9jFSlEJ diff --git a/tumblr/README.md b/tumblr/README.md new file mode 100644 index 00000000..fb20dac2 --- /dev/null +++ b/tumblr/README.md @@ -0,0 +1,12 @@ +Installation +------------ + +[Register](http://www.tumblr.com/oauth/apps) an application and use (your server name)/addon/tumblr/callback.php as +callback URL + +After the registration please enter the values for "Consumer Key" and "Consumer Secret" in the [administration](admin/plugins/tumblr). + +Notice +------ +This connector is using the Tumblr-OAuth-Library: +[https://groups.google.com/d/msg/tumblr-api/g6SeIBWvsnE/gnWqT9jFSlEJ](https://groups.google.com/d/msg/tumblr-api/g6SeIBWvsnE/gnWqT9jFSlEJ) diff --git a/twitter/README.md b/twitter/README.md index 13f0152f..e3f58e8d 100644 --- a/twitter/README.md +++ b/twitter/README.md @@ -3,34 +3,18 @@ Twitter Plugin Main authors Tobias Diekershoff and Michael Vogel. -With this addon to friendica 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. +With this addon to friendica you can give your users the possibility to post their *public* messages to Twitter and +to import their timeline. The messages will be strapped their rich context and shortened to 140 characters length if +necessary. The addon can also mirror a users Tweets into the ~friendica wall. -There is a similar addon for forwarding public messages to -[StatusNet](http://status.net). - -Requirements +Installation ------------ -To use this plugin you have to register an application for your friendica -instance on Twitter with -* read and write access -* don't set a callback URL -* we do not intend to use Twitter for login -The registration can be done at twitter.com/apps and you need a Twitter -account for doing so. - -After you registered the application you get an OAuth consumer key / secret -pair that identifies your app, you will need them for configuration. +To use this plugin you have to register an [application](https://apps.twitter.com/) for your friendica instance on Twitter. Please leave the field "Callback URL" empty. -The inclusion of a shorturl for the original posting in cases when the -message was longer than 140 characters requires it, that you have *PHP5+* and -*curl* on your server. +After the registration please enter the values for "Consumer Key" and "Consumer Secret" in the [administration](admin/plugins/twitter). Where to find ------------- @@ -44,91 +28,6 @@ Twitter_. [1]: https://github.com/abraham/twitteroauth [2]: http://dentedreality.com.au/projects/slinky/ -Configuration -============= - -Global Configuration --------------------- - -If you enabled an administrator account, please use the admin panel to configure -the Twitter relay. If you for any reason prefer to use a configuration file instead -of the admin panels, please refer to the Alternative Configuration below. - -Activate the plugin from the plugins section of your admin panel. When you have -done so, add your consumer key and consumer secret in the settings section of the -plugin page. - -When this is done your user can now configure their Twitter connection at -"Settings -> Connector Settings" and enable the forwarding of their *public* -messages to Twitter. - -Alternative 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 two lines - - $a->config['twitter']['consumerkey'] = 'your consumer KEY here'; - $a->config['twitter']['consumersecret'] = 'your consumer SECRET here'; - - -Mirroring of Public Postings ----------------------------- - -To avoid endless loops of public postings that are send to Twitter and then -mirrored back into your friendica stream you have to set the _name of the -application you registered there_ of your friendica node is using to post to -Twitter in the .htconfig.php file. - - $a->config['twitter']['application_name'] = "yourname here"; - -Connector Options for the User -============================== - -When the OAuth consumer informations are correctly placed into the -configuration file and a user visits the "Connector 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 -friendica account. - -After this step was successful the user now has the following config options. - -* **Allow posting to StatusNet** If you want your _public postings_ being - optionally posted to your associated Twitter account as well, you need to - check this box. -* **Send public postings to StatusNet by default** if you want to have _all_ - your public postings being send to your Twitter account you need to check - this button as well. Otherwise you have to enable the relay of your postings - in the ACL dialog (click the lock button) before posting an entry. -* **Mirror all posts from statusnet that are no replies or repeated messages** - if you want your postings from Twitter also appear in your friendica - postings, check this box. Replies to other people postings, repostings and your own - postings that were send from friendica wont be mirrored into your friendica - stream. -* **Shortening method that optimizes the post** by default friendica checks how - many characters your Twitter instance allows you to use for a posting and - if a posting is longer then this amount of characters it will shorten the - message posted on Twitter and add a short link back to the original - posting. Optionally you can check this box to have the shortening of the - message use an optimization algorithm. _TODO add infos how this is - optimized_ -* **Send linked #-tags and @-names to StatusNet** if you want your #-tags and - @-mentions linked to the friendica network, check this box. If you want to - have Twitter handle these things for the relayed end of the posting chain, - uncheck it. -* **Clear OAuth configuration** if you want to remove the currently associated - Twitter account from your friendica account you have to check this box and - then hit the submit button. The saved settings will be deleted and you have - to reconfigure the Twitter connector to be able to relay your public - postings to a Twitter account. - License ======= diff --git a/twitter/twitter.php b/twitter/twitter.php index 905c054a..704f6193 100644 --- a/twitter/twitter.php +++ b/twitter/twitter.php @@ -1,7 +1,7 @@ * Author: Michael Vogel