gnu-social/plugins/OStatus
Mikael Nordfeldth ab4113168f PuSH 0.4: No outgoing 'sync' verifications. Feed renewal script. No auto-renewal.
Among other things (such as permanent subscriptions), Pubsubhubbub 0.4
removed the "sync" verification method. This means that any incoming
PuSH subscription requests that follow the 0.4 spec won't really
_require_that we handle it as a background process, but if we were to
try direct verification of the subscription - and fail - there's no way
we could  pick up the ball again. So _essentially_ we require background
processing with retries.

This means we must implement something like the "poorman cron" or
similar, so background processing can be handled
on-demand/on-site-visit. This is how Friendica, Drupal etc. handles it
and is necessary for environments where we can't run separate queue
daemons.

When the poorman-cron-ish thing is implemented, auto-renewal will work
for all users.

PuSH 0.4 spec:
    https://pubsubhubbub.googlecode.com/git/pubsubhubbub-core-0.4.html
More on PuSH 0.4 release (incl. breaking changes):
    https://groups.google.com/forum/#!msg/pubsubhubbub/7RPlYMds4RI/2mIHQTdV3aoJ
2013-11-02 20:02:28 +01:00
..
actions PuSH 0.4: No outgoing 'sync' verifications. Feed renewal script. No auto-renewal. 2013-11-02 20:02:28 +01:00
classes PuSH 0.4: No outgoing 'sync' verifications. Feed renewal script. No auto-renewal. 2013-11-02 20:02:28 +01:00
extlib/phpseclib Latest phpseclib stuff and moved into its own dir. 2013-10-05 00:22:14 +02:00
images First steps on converting FeedSub into the pub/sub basis for OStatus communications: 2010-02-08 11:15:29 -08:00
js Changing js .live calls to .on for jquery 2.x 2013-09-10 18:52:09 +02:00
lib Salmon only has one "rel" value now, so start deprecating 2013-11-01 17:00:12 +01:00
locale Localisation updates from http://translatewiki.net. 2012-06-30 11:10:38 +00:00
scripts PuSH 0.4: No outgoing 'sync' verifications. Feed renewal script. No auto-renewal. 2013-11-02 20:02:28 +01:00
tests Making sure scripts and tests check for GNUSOCIAL defined (instead of STATUSNET) 2013-09-28 15:20:10 +02:00
theme/base/css Style cleanup for ostatus forms. 2011-08-26 12:51:55 -04:00
OStatusPlugin.php Notice metadata for WebFinger. Not sure if implemented properly. 2013-11-01 17:37:18 +01:00
README Update translator documentation. 2011-04-11 00:39:51 +02:00

README

Plugin to support importing and exporting notices through Atom and RSS feeds.
The OStatus plugin concentrates on user-to-user cases for federating StatusNet
and similar social networking / microblogging / blogging sites, but includes
low-level feed subscription systems which are used by some other plugins.

Uses PubSubHubbub for push feed updates; currently non-PuSH feeds cannot be
subscribed unless an external PuSH hub proxy is used.


Configuration options available:

$config['ostatus']['hub']
    (default internal hub)
    Set to URL of an external PuSH hub to use it instead of our internal hub
    for sending outgoing updates in user and group feeds.

$config['ostatus']['hub_retries']
    (default 0)
    Number of times to retry a PuSH send to consumers if using internal hub


Settings controlling incoming feed subscription:

$config['feedsub']['fallback_hub']
    To subscribe to feeds that don't have a hub, an external PuSH proxy hub
    such as Superfeedr may be used. Any feed without a hub of its own will
    be subscribed through the specified hub URL instead. If the external hub
    has usage charges, be aware that there is no restriction placed to how
    many feeds may be subscribed!

    $config['feedsub']['fallback_hub'] = 'https://superfeedr.com/hubbub';

$config['feedsub']['hub_user']
$config['feedsub']['hub_password']
    If using the fallback hub mode, these settings may be used to provide
    HTTP authentication credentials for contacting the hub. Default hubs
    specified from feeds are assumed to not require


For testing, shouldn't be used in production:

$config['ostatus']['skip_signatures']
    (default use signatures)
    Disable generation and validation of Salmon magicenv signatures

$config['feedsub']['nohub']
    (default require hub)
    Allow low-level feed subscription setup for feeds without hubs.
    Not actually usable at this stage, OStatus will check for hubs too
    and we have no polling backend. (The fallback hub option can be used
    with a 3rd-party service to provide such polling.)

Todo:
* better support for feeds that aren't natively oriented at social networking
* make use of tags/categories from feeds
* better repeat handling