plugins/OStatus/README

   1 Plugin to support importing and exporting notices through Atom and RSS feeds.
   2 The OStatus plugin concentrates on user-to-user cases for federating StatusNet
   3 and similar social networking / microblogging / blogging sites, but includes
   4 low-level feed subscription systems which are used by some other plugins.
   5
   6 Uses PubSubHubbub for push feed updates; currently non-PuSH feeds cannot be
   7 subscribed unless an external PuSH hub proxy is used.
   8
   9
  10 Configuration options available:
  11
  12 $config['ostatus']['hub']
  13     (default internal hub)
  14     Set to URL of an external PuSH hub to use it instead of our internal hub
  15     for sending outgoing updates in user and group feeds.
  16
  17 $config['ostatus']['hub_retries']
  18     (default 0)
  19     Number of times to retry a PuSH send to consumers if using internal hub
  20
  21
  22 Settings controlling incoming feed subscription:
  23
  24 $config['feedsub']['fallback_hub']
  25     To subscribe to feeds that don't have a hub, an external PuSH proxy hub
  26     such as Superfeedr may be used. Any feed without a hub of its own will
  27     be subscribed through the specified hub URL instead. If the external hub
  28     has usage charges, be aware that there is no restriction placed to how
  29     many feeds may be subscribed!
  30
  31     $config['feedsub']['fallback_hub'] = 'https://superfeedr.com/hubbub';
  32
  33 $config['feedsub']['hub_user']
  34 $config['feedsub']['hub_password']
  35     If using the fallback hub mode, these settings may be used to provide
  36     HTTP authentication credentials for contacting the hub. Default hubs
  37     specified from feeds are assumed to not require
  38
  39
  40 For testing, shouldn't be used in production:
  41
  42 $config['ostatus']['skip_signatures']
  43     (default use signatures)
  44     Disable generation and validation of Salmon magicenv signatures
  45
  46 $config['feedsub']['nohub']
  47     (default require hub)
  48     Allow low-level feed subscription setup for feeds without hubs.
  49     Not actually usable at this stage, OStatus will check for hubs too
  50     and we have no polling backend. (The fallback hub option can be used
  51     with a 3rd-party service to provide such polling.)
  52
  53 Todo:
  54 * better support for feeds that aren't natively oriented at social networking
  55 * make use of tags/categories from feeds
  56 * better repeat handling