If you don't want to implement your own XML reader/parser, you can use one of our helper code packages. For PHP, this package is called Services_Eventfinder, and can be installed through PEAR, using the following command:

pear install http://code.eventfinder.co.nz/Services_Eventfinder-0.1.4.tgz

If you do not have PEAR installed, or you just don't want to use it, you can download Services_Eventfinder without it:

• Services_Eventfinder-0.1.4-PEARless.tgz (37 KiB)
• Services_Eventfinder-0.1.4-PEARless.zip (58 KiB)

• Provides easy access to all of the methods provided by the API
• Provides a simple caching mechanism, to greatly speed up subsequent requests for Eventfinder data

Using Services_Eventfinder can be as simple as:

<?php 
  include 'Services/Eventfinder.php';
  
  $api = new Services_Eventfinder('my_username', 'my_password');
  $events = $api->searchEvents('rugby league');
  
  foreach ($events as $event) {
    echo $event->getName();
  }
?>

For full usage notes, see the accompanying readme.txt file, or the PHPdoc documentation in the code itself.

If you'd rather not muck about with using the API at all, we provide working examples you can modify to fit your purposes.

• Events Calendar - a simple events calendar that allows browsing by event location and category.

The source code for these examples is included with Services_Eventfinder, in your PEAR documentation directory (or, in Services/Eventfinder/examples if you did not use the PEAR install).

Or, you can download a ready to go version, that has everything you need to run each example:

• Event_Calendar-0.1.4.tgz (33 KiB)
• Event_Calendar-0.1.4.zip (51 KiB)

As of version 0.1.0, Services_Eventfinder requires PHP version 5.0 or higher, with the latest stable version recommended. Services_Eventfinder is no longer compatible with PHP 4.

If you absolutely require PHP 4 support, you cand download version 0.0.9, but this version will not be supported in the future.