6 * PubSub is a protocol which fasten up RSS fetching:
7 * - Every time a new link is posted, Shaarli notify the hub.
8 * - The hub notify all feed subscribers that a new link has been posted.
9 * - Subscribers retrieve the new link.
12 use pubsubhubbub\publisher\Publisher
;
13 use Shaarli\Config\ConfigManager
;
14 use Shaarli\Feed\FeedBuilder
;
15 use Shaarli\Plugin\PluginManager
;
16 use Shaarli\Render\TemplatePage
;
19 * Plugin init function - set the hub to the default appspot one.
21 * @param ConfigManager $conf instance.
23 function pubsubhubbub_init($conf)
25 $hub = $conf->get('plugins.PUBSUBHUB_URL');
28 $conf->set('plugins.PUBSUBHUB_URL', 'https://pubsubhubbub.appspot.com/');
35 * Adds the hub URL in ATOM and RSS feed.
37 * @param array $data Template data.
38 * @param ConfigManager $conf instance.
40 * @return array updated template data.
42 function hook_pubsubhubbub_render_feed($data, $conf)
44 $feedType = $data['_PAGE_'] == TemplatePage
::FEED_RSS
? FeedBuilder
::$FEED_RSS : FeedBuilder
::$FEED_ATOM;
45 $template = file_get_contents(PluginManager
::$PLUGINS_PATH . '/pubsubhubbub/hub.'. $feedType .'.xml');
46 $data['feed_plugins_header'][] = sprintf($template, $conf->get('plugins.PUBSUBHUB_URL'));
53 * Publish to the hub when a link is saved.
55 * @param array $data Template data.
56 * @param ConfigManager $conf instance.
58 * @return array unaltered data.
60 function hook_pubsubhubbub_save_link($data, $conf)
63 index_url($_SERVER) .'feed/atom',
64 index_url($_SERVER) .'feed/rss',
67 $httpPost = function_exists('curl_version') ? false : 'nocurl_http_post';
69 $p = new Publisher($conf->get('plugins.PUBSUBHUB_URL'));
70 $p->publish_update($feeds, $httpPost);
71 } catch (Exception
$e) {
72 error_log(sprintf(t('Could not publish to PubSubHubbub: %s'), $e->getMessage()));
79 * Http function used to post to the hub endpoint without cURL extension.
81 * @param string $url Hub endpoint.
82 * @param string $postString String to POST.
86 * @throws Exception An error occurred.
88 function nocurl_http_post($url, $postString)
90 $params = array('http' => array(
92 'content' => $postString,
93 'user_agent' => 'PubSubHubbub-Publisher-PHP/1.0',
96 $context = stream_context_create($params);
97 $fp = @fopen($url, 'rb', false, $context);
99 throw new Exception(sprintf(t('Could not post to %s'), $url));
101 $response = @stream_get_contents($fp);
102 if ($response === false) {
103 throw new Exception(sprintf(t('Bad response from the hub %s'), $url));
109 * This function is never called, but contains translation calls for GNU gettext extraction.
111 function pubsubhubbub_dummy_translation()
114 t('Enable PubSubHubbub feed publishing.');