event-list-example.md

#Display your event list in HTML# The easiest way to display an event on your existing website is to use one of Eventbrite's available widgets. However, if you organize a lot of events, and are looking for a way to automatically keep your site up-to-date using PHP, then this guide should come in handy.

##Install an API client## First, download the PHP Eventbrite API client and add it to your site's codebase.

##Initialize the API client## Load the API Client library, and add your Eventbrite authentication tokens to initialize the client. Your API / Application key is required. Adding an Eventbrite user_key is only required for accessing private events or other user data.

<?php
    include "Eventbrite.php"; 

    $authentication_tokens = array(
        'app_key'  => 'YOUR_APP_KEY',
        'user_key' => 'YOUR_USER_KEY');

    $eb_client = new Eventbrite( $authentication_tokens );
?>

##Access your list of events## For more information about the functions that are available through the Eventbrite API, see the Eventbrite API documentation For this example, we will use the user_list_events API method. You could also use the event_search or organizer_list_events API methods, depending on your needs.

<?php 
    try {
        $events = $eb_client->user_list_events();
    } catch ( Exception $e ) {
        // Be sure to plan for potential error cases 
        // so that your application can respond appropriately

        //var_dump($e);
        $events = array();
    }
?>

##Display your event listing as HTML## Now that you have your events, convert them to HTML for display

<?= Eventbrite::eventList( $events, 'eventListRow'); ?>

The resulting HTML output should look similar to this:

<div class="eb_event_list">
    <div class='eb_event_list_item' id='evnt_div_1485261457'>
        <span class='eb_event_list_date'>Tue, May  4</span>
        <span class='eb_event_list_time'> 1:00 pm</span>
        <a class='eb_event_list_title' href='http://www.eventbrite.com/event/1485261457'>API_EVENT_TEST2</a>
        <span class='eb_event_list_location'>my place</span>
    </div>
    <div class='eb_event_list_item' id='evnt_div_1472940605'>
        <span class='eb_event_list_date'>Tue, May  3</span>
        <span class='eb_event_list_time'> 1:00 pm</span>
        <a class='eb_event_list_title' href='http://www.eventbrite.com/event/1485261457'>API_EVENT_TEST1</a>
        <span class='eb_event_list_location'>my place</span>
    </div>
</div>

##Customize the event listing by adding your own CSS## This example stylesheet template should help you get started.

<style type="text/css">
.eb_event_list_item{
  padding-top: 20px;
}
.eb_event_list_title{
  position: absolute;
  left: 220px;
  width: 300px;
  overflow: hidden;
}
.eb_event_list_date{
  padding-left: 20px;
}
.eb_event_list_time{
  position: absolute;
  left: 150px;
}
.eb_event_list_location{
  position: absolute;
  left: 520px;
}
</style>

##Done!## That should be all the information that you will need to create your own automatically-updated event listing on your PHP-based site. A working example page based on this guide should come bundled with the API client. You will just need to add your authentication tokens in order to get it working.

##Additional event list customization## If this guide's resulting HTML event list does not meet your needs, you can always define your own custom function, and then pass it to Eventbrite::eventList() to convert each event into whatever you like. Here is an example demonstrating how that might work -

First, define your own custom HTML rendering function:

$custom_render_function = function($evnt){
    $time = strtotime($evnt->start_date);
    if( isset($evnt->venue) && isset( $evnt->venue->name )){ 
        $venue_name = $evnt->venue->name;
    }else{
        $venue_name = 'online';
    }   
    $event_html = "<div class='eb_event_list_item' id='evnt_div_"
                . $evnt->id ."'><span class='eb_event_list_date'>"
                . strftime('%a, %B %e', $time) . "</span><span class='eb_event_list_time'>" 
                . strftime('%l:%M %P', $time) . "</span><a class='eb_event_list_title' href='"
                . $evnt->url."'>".$evnt->title."</a><span class='eb_event_list_location'>"
                . $venue_name . "</span></div>\n";
    return $event_html;
}

Then, use it to convert your events into HTML:

$event_list_html = Eventbrite::eventList( $events, $custom_render_function);