API-Plesk version 1.00
======================

The given module is intended for interaction with the XML API of the Plesk hosting panel. API is realized not completely, but there is a full support of operations with Account, Domains and Templates. Also there is a module Net::Plesk, but there were censures on its flexibility and expansibility therefore this has been written.

API::Plesk module gives the convenient interface for addition of new functions. Extensions represent modules in a folder Plesk with definitions of demanded functions. Each demanded operation is described by two functions: op and op_response_parse. The first sub generates XML query to Plesk, the second is responsible for parse XML answer and its representation in Perl Native Structures. As a template for a writing of own expansions is better to use API/Plesk/Account.pm. In module API::Plesk::Methods we can find service functions for a writing our extensions.

INSTALLATION

To install this module type the following:

    perl Makefile.PL
    make
    make test
    make install

TESTS
	
!! WARNING: Do not do this on the production servers, only on test environment !!

If you want to perform tests on working panels, use the following environment variables:

  online=1
  plesk_url=https://192.168.1.1:8443/enterprise/control/agent.php
  plesk_password=qwerty
  plesk_username=admin
  template_name=name
  template_id=1
  new_tariff=name_1
	
Instead "make test" use "online=1 .... new_tariff=name_1 make test".

DEPENDENCIES

This module requires these other modules and libraries:

    Carp (standard),
    Data::Dumper,
    Getopt::Long,
    HTTP::Request,
    LWP::UserAgent,
    Test::More.

AUTHOR
    Odintsov Pavel nrg[at]cpan.org

COPYRIGHT AND LICENCE

Copyright (C) 2008 by Odintsov Pavel.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.