X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/d5e65e582a34ae2494fee493ddcb2b959e4a4bce..651cdd4b2a85f4e5f9d298a7eea7d0e6d94442b1:/doc/plugins/pinger.mdwn diff --git a/doc/plugins/pinger.mdwn b/doc/plugins/pinger.mdwn index f2dd12e62..f37979ac6 100644 --- a/doc/plugins/pinger.mdwn +++ b/doc/plugins/pinger.mdwn @@ -7,18 +7,14 @@ plugin to set up a loosely coupled mirror network, or a branched version of a wiki. By pinging the mirror or branch each time the main wiki changes, it can be kept up-to-date. - \[[!ping from="http://mywiki.com/" - to="http://otherwiki.com/ikiwiki.cgi?do=ping"]] +To configure what URLs to ping, use the [[ikiwiki/directive/ping]] +[[ikiwiki/directive]]. -The "from" parameter must be identical to the url of the wiki that is doing -the pinging. This is used to prevent ping loops. +The [[!cpan LWPx::ParanoidAgent]] Perl module is strongly recommended. +The [[!cpan LWP]] module can also be used, but is susceptible +to server-side request forgery. -The "to" parameter is the url to ping. The example shows how to ping -another ikiwiki instance. - -The [[!cpan LWP]] perl module is used for pinging. Or the [[!cpan -LWPx::ParanoidAgent]] perl module is used if available, for added security. -Finally, the [[!cpan Crypt::SSLeay]] perl module is needed to support pinging +The [[!cpan Crypt::SSLeay]] perl module is needed to support pinging "https" urls. By default the pinger will try to ping a site for 15 seconds before timing