/ 
dokuwiki-frontier-client-0.0
/ Dokuwiki::Frontier::Client

NAME

Dokuwiki::Frontier::Client - A Frontier::Client for dokuwiki.

SYNOPSIS

Dokuwiki::Frontier::Client extends the Frontier::Client with the Dokuwiki XML-RPC methods (without namespace) described in the dokuwiki xml-rpc page.

so the call to the wiki.getAllPages (which also require a call to dokuwiki.login) is like:

use Dokuwiki::Frontier::Client;
use YAML ();

my $client = Dokuwiki::Frontier::Client->base('https://di.u-strasbg.fr/')
    or die;

$client->login('editor','s3cr3t')
    or die; 

print YAML::Dump [ $client->getAllPages ];

CONSTRUCTORS

Note that base is just a shortcut for new. those constructions are equivalent:

Dokuwiki::Frontier::Client->base('https://di.u-strasbg.fr/');
Dokuwiki::Frontier::Client->base(url => 'https://di.u-strasbg.fr/');
Dokuwiki::Frontier::Client->new(url => 'https://di.u-strasbg.fr/lib/exe/xmlrpc.php' );

METHODS, INTROSPECTION

%Dokuwiki::Frontier::Client::API is a hash where keys are the Dokuwiki::Frontier::Client methods and values are the Dokuwiki XML-RPC methods. So you can have the list of the mapped functions with:

perl -MDokuwiki::Frontier::Client -E'say for keys %Dokuwiki::Frontier::Client::API'

but please refer to the dokuwiki xml-rpc page for more details.

A REAL WORLD EXAMPLE

use Dokuwiki::Frontier::Client;
use Modern::Perl;
use Net::Netrc;
use YAML;

my $base = 'https://example.com/';
my $host = 'server.example.com';

my $wiki = Dokuwiki::Frontier::Client->base
    ( $host , debug => 1 );

my $credentials = Net::Netrc->lookup($host)
    or die "please add a fake $host machine in your ~/.netrc";

$wiki->login( ($credentials->lpa)[0,1] )
    or die "can't authenticate";

say YAML::Dump [$wiki->getPage('/ficheappli/start')];