Updated addon descriptions and readme files for several addons.
This commit is contained in:
parent
5c413572c8
commit
bf52de030f
13 changed files with 43 additions and 210 deletions
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Name: App.net Connector
|
* Name: App.net Connector
|
||||||
* Description: app.net postings import and export
|
* Description: Bidirectional (posting and reading) connector for app.net.
|
||||||
* Version: 0.2
|
* Version: 0.2
|
||||||
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -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 register an app at [http://bufferapp.com/developers/api](http://bufferapp.com/developers/api)
|
||||||
|
|
||||||
Please use (your server address)/buffer/connect as Callback URL.
|
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).
|
||||||
|
|
|
@ -4,6 +4,7 @@
|
||||||
* Version: 1.3
|
* Version: 1.3
|
||||||
* Author: Mike Macgirvin <http://macgirvin.com/profile/mike>
|
* Author: Mike Macgirvin <http://macgirvin.com/profile/mike>
|
||||||
* Author: Tobias Hößl <https://github.com/CatoTH/>
|
* Author: Tobias Hößl <https://github.com/CatoTH/>
|
||||||
|
* Status: Unsupported
|
||||||
*
|
*
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|
|
@ -5,6 +5,7 @@
|
||||||
* Description: Posts to a Google+ page with the help of Hootsuite
|
* Description: Posts to a Google+ page with the help of Hootsuite
|
||||||
* Version: 0.1
|
* Version: 0.1
|
||||||
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
||||||
|
* Status: Unsupported
|
||||||
*/
|
*/
|
||||||
|
|
||||||
function gpluspost_install() {
|
function gpluspost_install() {
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
<?php
|
<?php
|
||||||
/**
|
/**
|
||||||
* Name: pump.io Post Connector
|
* Name: pump.io Post Connector
|
||||||
* Description: Post to pump.io
|
* Description: Bidirectional (posting, relaying and reading) connector for pump.io.
|
||||||
* Version: 0.2
|
* Version: 0.2
|
||||||
* Author: Michael Vogel <http://pirati.ca/profile/heluecht>
|
* Author: Michael Vogel <http://pirati.ca/profile/heluecht>
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -26,7 +26,7 @@ function rendertime_page_end(&$a, &$o) {
|
||||||
|
|
||||||
$duration = microtime(true)-$a->performance["start"];
|
$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.'<div class="renderinfo">'.sprintf(t("Performance: Database: %s, Network: %s, Rendering: %s, Parser: %s, I/O: %s, Other: %s, Total: %s"),
|
$o = $o.'<div class="renderinfo">'.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["database"], 3),
|
||||||
round($a->performance["network"], 3),
|
round($a->performance["network"], 3),
|
||||||
|
|
|
@ -1,31 +1,30 @@
|
||||||
StatusNet Connector
|
GNU Social Connector
|
||||||
===================
|
===================
|
||||||
Main authors Tobias Diekershoff and Michael Vogel.
|
Main authors Tobias Diekershoff and Michael Vogel.
|
||||||
|
|
||||||
With this addon to friendica you can give your user the possibility to post
|
With this addon to friendica you can give your users the possibility to post their *public* messages to GNU Social
|
||||||
their public messages to any StatusNet instance. The messages will be strapped
|
and to import their timeline of their legacy GNU Social accounts. The messages will be strapped their rich context
|
||||||
their rich context and shortened to to the character limit of the StatusNet
|
and shortened if necessary.
|
||||||
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.
|
|
||||||
|
|
||||||
Requirements
|
Requirements
|
||||||
------------
|
------------
|
||||||
|
|
||||||
Due to the distributed nature of the StatusNet network, each user who wishes to
|
Due to the distributed nature of the GNU Social network, each user who wishes to
|
||||||
forward public messages to a StatusNet account has to get the OAuth credentials
|
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
|
for themselves, which makes this addon a little bit more user unfriendly than
|
||||||
the Twitter Plugin is. Nothing too geeky though!
|
the Twitter Plugin is. Nothing too geeky though!
|
||||||
|
|
||||||
The inclusion of a shorturl for the original posting in cases when the message
|
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
|
was longer than the maximal allowed notice length requires it, that you have
|
||||||
PHP5+ and curl on your server.
|
PHP5+ and curl on your server.
|
||||||
|
|
||||||
Where to find
|
Where to find
|
||||||
|
-------------
|
||||||
|
|
||||||
In the friendica addon git repository /statusnet/, this directory contains all
|
In the friendica addon git repository /statusnet/, this directory contains all
|
||||||
required PHP files (including the [Twitter OAuth library] [1] by Abraham Williams,
|
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
|
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
|
[1]:https://github.com/abraham/twitteroauth
|
||||||
[2]:http://dentedreality.com.au/projects/slinky
|
[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
|
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
|
User Configuration
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
When the addon is activated the user has to acquire three things in order to
|
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
|
* OAuth Consumer key & secret
|
||||||
|
|
||||||
To get the OAuth Consumer key pair the user has to (a) ask her Friendica admin
|
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
|
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
|
settings under "Connect -> Connections -> Register an OAuth client application
|
||||||
-> Register a new 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
|
After the required credentials for the application are stored in the
|
||||||
configuration you have to actually connect your friendica account with
|
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
|
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
|
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
|
plugin settings will allow you to select to post your public messages to your
|
||||||
StatusNet account.
|
GNU Social 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.
|
|
||||||
|
|
||||||
License
|
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.
|
LICENSE file in the addons directory.
|
||||||
|
|
||||||
[3]: http://opensource.org/licenses/BSD-3-Clause
|
[3]: http://opensource.org/licenses/BSD-3-Clause
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
<?php
|
<?php
|
||||||
/**
|
/**
|
||||||
* Name: GNU Social Connector
|
* Name: GNU Social Connector
|
||||||
* Description: Relay public postings to a connected GNU Social account
|
* Description: Bidirectional (posting, relaying and reading) connector for GNU Social.
|
||||||
* Version: 1.0.5
|
* Version: 1.0.5
|
||||||
* Author: Tobias Diekershoff <https://f.diekershoff.de/profile/tobias>
|
* Author: Tobias Diekershoff <https://f.diekershoff.de/profile/tobias>
|
||||||
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
||||||
|
|
|
@ -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
|
|
12
tumblr/README.md
Normal file
12
tumblr/README.md
Normal file
|
@ -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)
|
|
@ -3,34 +3,18 @@ Twitter Plugin
|
||||||
|
|
||||||
Main authors Tobias Diekershoff and Michael Vogel.
|
Main authors Tobias Diekershoff and Michael Vogel.
|
||||||
|
|
||||||
With this addon to friendica you can give your user the possibility to post
|
With this addon to friendica you can give your users the possibility to post their *public* messages to Twitter and
|
||||||
their *public* messages to Twitter. The messages will be strapped their rich
|
to import their timeline. The messages will be strapped their rich context and shortened to 140 characters length if
|
||||||
context and shortened to 140 characters length if necessary. If shortening of
|
necessary.
|
||||||
the message was performed a link will be added to the Tweet pointing to the
|
|
||||||
original message on your server.
|
|
||||||
|
|
||||||
The addon can also mirror a users Tweets into the ~friendica wall.
|
The addon can also mirror a users Tweets into the ~friendica wall.
|
||||||
|
|
||||||
There is a similar addon for forwarding public messages to
|
Installation
|
||||||
[StatusNet](http://status.net).
|
|
||||||
|
|
||||||
Requirements
|
|
||||||
------------
|
------------
|
||||||
|
|
||||||
To use this plugin you have to register an application for your friendica
|
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.
|
||||||
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
|
After the registration please enter the values for "Consumer Key" and "Consumer Secret" in the [administration](admin/plugins/twitter).
|
||||||
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 than 140 characters requires it, that you have *PHP5+* and
|
|
||||||
*curl* on your server.
|
|
||||||
|
|
||||||
Where to find
|
Where to find
|
||||||
-------------
|
-------------
|
||||||
|
@ -44,91 +28,6 @@ Twitter_.
|
||||||
[1]: https://github.com/abraham/twitteroauth
|
[1]: https://github.com/abraham/twitteroauth
|
||||||
[2]: http://dentedreality.com.au/projects/slinky/
|
[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
|
License
|
||||||
=======
|
=======
|
||||||
|
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
<?php
|
<?php
|
||||||
/**
|
/**
|
||||||
* Name: Twitter Connector
|
* Name: Twitter Connector
|
||||||
* Description: Relay public postings to a connected Twitter account
|
* Description: Bidirectional (posting, relaying and reading) connector for Twitter.
|
||||||
* Version: 1.0.4
|
* Version: 1.0.4
|
||||||
* Author: Tobias Diekershoff <https://f.diekershoff.de/profile/tobias>
|
* Author: Tobias Diekershoff <https://f.diekershoff.de/profile/tobias>
|
||||||
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
* Author: Michael Vogel <https://pirati.ca/profile/heluecht>
|
||||||
|
|
Loading…
Reference in a new issue