Differences

This shows you the differences between two versions of the page.

--- plugin:feedaggregator [2015-12-17 05:56] – samwilson
+++ plugin:feedaggregator [2016-01-03 03:28] – More info about automating. samwilson
@@ Line 25: / Line 25: @@
 Install using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. 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.
+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 =====
@@ Line 42: / Line 42: @@
 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:
+* * * * 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:
+* * * * curl --silent http://example.org/dokuwiki/news?purge=true
 ===== Change Log =====
 {{rss>https://github.com/samwilson/dokuwiki-plugin-feedaggregator/commits/master.atom date}}