====== feedaggregator Plugin ====== ---- plugin ---- description: A plugin for aggregating multiple news feeds onto a single wiki page author : Sam Wilson email : sam@samwilson.id.au type : syntax,action lastupdate : 2015-12-17 compatible : 2015-08-10a, 2014-09-29 depends : conflicts : similar : tags : rss, feed, news, simplepie, embed downloadurl: https://github.com/samwilson/dokuwiki-plugin-feedaggregator/zipball/master bugtracker : https://github.com/samwilson/dokuwiki-plugin-feedaggregator/issues sourcerepo : https://github.com/samwilson/dokuwiki-plugin-feedaggregator/ donationurl: screenshot_img : ---- ===== Installation ===== Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually. The actual retrieval of the feeds is done by browsing to ''%%http://example.org/dokuwiki/?do=feedaggregator%%''. This URL should be pinged regularly by cron or some quasi-cron web service; see the //[[#Automating]]// section below for more information. ===== Usage ===== Define the feeds to be included with one URL on each line: ~~NOCACHE~~ http://www.theguardian.com/uk/technology/rss http://rss.slashdot.org/Slashdot/slashdotMain Note the use of ''[[:wiki:syntax#control_macros|~~NOCACHE~~]]''. For other configuration options, please see the plugin's section in your site's Configuration Manager. ===== Automating ===== The feed-update URL should be called regularly by a cron (or other task-scheduling) service. If you set up a system to do this, then you should set a ''token'' in the plugin configuration; this will prevent the possibility of other requests wasting system resources by also requesting this URL. An example cron entry looks like the following: 34 * * * * curl --silent http://example.org/dokuwiki/?do=feedaggregator&token=tok123 If you use an automated update system, then you can do away with ''%%~~NOCACHE~~%%'' in the page text and instead force-purge the cache after the update operation. To do this, add a second cron entry similar to the following: 44 * * * * curl --silent http://example.org/dokuwiki/news?purge=true ===== Change Log ===== {{rss>https://github.com/samwilson/dokuwiki-plugin-feedaggregator/commits/master.atom date}}