gnu-social

History

Alexei Sorokin 5bc1b8695e [DATABASE] Disable 'NULL' strings evaluation as SQL NULLs Use $object->sqlValue('NULL') (identical to DataObject_Cast'ing) instead and fix related issues like (email\|sms)settings considering these NULLs as a false positive for the E-Mail address still being set when it's been removed. There could also be security implications to the now-disabled approach of considering 'NULL' strings as SQL NULLs.		2019-11-02 12:21:43 +03:00
..
actions	[LIB_REFACTOR] Fix requires	2019-09-03 03:33:13 +01:00
classes	[DATABASE] Disable 'NULL' strings evaluation as SQL NULLs	2019-11-02 12:21:43 +03:00
lib	[OStatus] Port remote-follow to the RemoteFollow plugin	2019-09-03 03:26:35 +01:00
locale	[PLUGINS] Removed GeoURL as the service doesn't exist anymore	2019-08-24 01:59:36 +01:00
scripts	[OStatus] Add script for profile deduplication and URI fixing	2019-11-03 00:43:21 +00:00
tests	[LIB_REFACTOR] Fix requires	2019-09-03 03:33:13 +01:00
EVENTS.txt	Moved Diaspora specific metadata to own plugin	2015-06-06 13:49:27 +02:00
OStatusPlugin.php	[TheFreeNetwork] First code: Module class and census event	2019-11-03 00:43:21 +00:00
README	[OStatus] Port remote-follow to the RemoteFollow plugin	2019-09-03 03:26:35 +01: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 WebSub (previously named PubSubHubbub or PuSH) for push feed updates;
currently non-WebSub feeds cannot be subscribed unless an external
WebSub hub proxy is used.


Additional functionality:

The RemoteFollow plugin is highly recommended as it is the only way to remote
follow a user in OStatus, it adds a remote follow button to user profiles.

Configuration options available:

$config['ostatus']['hub']
    (default internal hub)
    Set to URL of an external WebSub 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 WebSub 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 WebSub 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