File: info.txt

==============================================
XML Currency Reader class
==============================================
This class implements support for xml currencies files, usually provided by central banks. It's a general class,
who must be extended with particulary classes (e.g. BNR_reader.class)

abstract class XML_currency
Variables:
    abstract protected function parse_rate_contents($content, $currency = 'EUR');
    abstract protected function parse_domdoc();

    protected $xmlpath
    protected $allow_url_fopen;
    protected $xml_content;
    protected $domdoc

Methods:
    public function __construct() 
    public function parse_xml() 
    protected function get_xml_content()
    protected function DOMconnector()


----------------------------------------
class BNR_reader extends XML_currency
Variables:
    inherited ones
    protected $xmlpathl => here the URL for xml file

Methods:
    inherited ones
    public function parse_rate_contents($content, $currency = 'EUR')
    public function parse_domdoc()


==============================================
USAGE FOR BNR READER CLASS:
==============================================
Usage is very simple, just call parse_xml method on a class object,
and then display on your page the needed value. More on index.php.


==============================================
XML FILE:
http://www.bnro.ro/nbrfxrates.xml
==============================================


==============================================
RETURNING ARRAY FORMAT:
==============================================

Array
(
    [0] => National Bank of Romania
    [1] => 2008-10-24
    [2] => Array
        (
            [0] => Array
                (
                    [currency] => AUD
                    [rate] => 1.8022
                    [multiplier] => 1
                )

            [1] => Array
                (
                    [currency] => BGN
                    [rate] => 1.8854
                    [multiplier] => 1
                )

...

            [19] => Array
                (
                    [currency] => XAU
                    [rate] => 65.5854
                    [multiplier] => 1
                )

            [20] => Array
                (
                    [currency] => XDR
                    [rate] => 4.2963
                    [multiplier] => 1
                )

        )
)

==============================================
HOW TO EXTEND THE XML_CURRENCY_READER CLASS
==============================================
This is very simple. Just create a class who extends the XML_Currency_reader.class
and add some content to $xmlpath (the xml file URL), and also two particulary methods:

parse_domdoc - who parse the xml content and returns it in your specified form (depends on the xml structure)
parse_rate_contents - (optional) method used to retrieve a currency from parsed content. You can also use
a direct array approach, but this methods makes it more intuitive.