Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here

eventbrite-api

The Eventbrite API plugin brings the power of Eventbrite to WordPress, for both users and developers.

Subscribe to updates I use eventbrite-api


Statistics on eventbrite-api

Number of watchers on Github 50
Number of open issues 21
Average time to close an issue about 1 month
Main language PHP
Average time to merge a PR 26 days
Open pull requests 5+
Closed pull requests 1+
Last commit almost 3 years ago
Repo Created about 5 years ago
Repo Last Updated over 1 year ago
Size 1.01 MB
Organization / Authorautomattic
Contributors5
Page Updated
Do you use eventbrite-api? Leave a review!
View open issues (21)
View eventbrite-api activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating eventbrite-api for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Eventbrite API WordPress Plugin

The Eventbrite API plugin brings the power of Eventbrite to WordPress, for both users and developers.

Overview

Users

By connecting to your Eventbrite account, events can be displayed directly on your WordPress.org website, complete with event details and ticket information. Events will blend in with the design of any theme, and events can be filtered by organizer or venue, just like post archives.

Developers

As a developer, you get simple-to-use tools for integrating Eventbrite into your themes or plugins. Use the helper functions to remove the complexity and heavy-lifting of API calls, and take advantage of assorted template tags for displaying various event information.

Requirements

Keyring

Keyring is required for the Eventbrite API plugin to work. Once it's installed with an active connection to Eventbrite, the Eventbrite API plugin will be able to display events.

If needed, admin notices will give helpful links and prompting to get Keyring and the Eventbrite API plugin up and running. These notices will appear on the Dashboard, PLugins, Tools, and Settings admin pages until issues are resolved.

Classes

Eventbrite API Classes Overview

Eventbrite_API

  • makes calls to the API
  • handles option for the token
  • defines supported endpoints

Eventbrite_Requirements

  • ensures Keyring is installed, activated
  • ensures an active Eventbrite connection
  • provides admin notification prompts

Eventbrite_Manager

  • uses Eventbrite_API to make API calls
  • validates all query args and values to ensure no wasted API calls
  • handles storing and returning transients
  • prepares API results into the format needed by Eventbrite_Event

Eventbrite_Query

  • like WP_Query for Eventbrite events (it extends WP_Query)
  • creates a secondary loop
  • supported arguments, passed as an array
    • display_private: (boolean) Include user events marked as Private. Default is false. Note that this changes the endpoint called from event_search to user_owned_events. See the Eventbrite API docs for details.
    • limit: (integer) Return a maximum number of results.
    • organizer_id: (integer) Return only events for a certain organizer.
    • p: (integer) Get a single event.
    • post__not_in: (array) Remove certain events by ID from the results.
    • venue_id: (integer) Return only events for a certain venue.
    • category_id: (integer) Return only events for a certain category.
    • subcategory_id: (integer) Return only events for a certain subcategory.
    • format_id: (integer) Return only events for a certain format.

Eventbrite_Event

  • like WP_Post for Eventbrite events
  • does not extend WP_Post, as that class is marked final
  • object properties
    • ID (integer)
    • post_title (string)
    • post_content (string)
    • post_date (string)
    • post_date_gmt (string)
    • url (string)
    • logo_url (string)
    • start (object)
    • end (object)
    • organizer (object)
    • venue (object)
    • public (boolean)
    • tickets (object)

Eventbrite_Templates

  • extends the Template Hierarchy for handling Eventbrite templates
  • adds rewrite rules for templates

Functions

Helper Functions

eventbrite_get_events( $params, $force )

  • Get user-owned events (both public and private are returned by default).
  • $params: (array, optional) Accepted parameters and values
  • $force: (boolean, optional) Force a fresh API call, ignoring any available transient. Default is false.

eventbrite_get_event( $id, $force )

  • Retrieve a single user-owned event.
  • $id: (integer, required) Eventbrite event id
  • $force: (boolean, optional) Force a fresh API call, ignoring any available transient. Default is false.

eventbrite_search( $params, $force )

  • Search all public Eventbrite events.
  • $params: (array, optional) Accepted parameters and values. Note that not passing any parameters, while technically valid, will usually result in timeout errors. Limiting the search to user-owned events can be done by passing user.id => Eventbrite_API::$instance->get_token()->get_meta( 'user_id' ).
  • $force: (boolean, optional) Force a fresh API call, ignoring any available transient. Default is false.

Template Tags

eventbrite_is_single( $query )

  • Determine if we on an Eventbrite single view.
  • $query: (object, optional) Accepts an Eventbrite_Query object.
  • Returns: (boolean) true if the passed or current query is for an event single view, false otherwise.

eventbrite_is_event( $post )

  • Check if a given or current post is an Eventbrite event.
  • $post: (object or integer, optional) Accepts a post/event object, or an ID.
  • Returns: (boolean) true if it's an Eventbrite_Event object or the ID of a valid event, false otherwise.

eventbrite_paging_nav( $events )

  • Output pagination HTML for the index views.
  • Based on wp_paginate_links().
  • $events: (object, required) Requires a valid Eventbrite_Query object. This avoids having to mess with the $wp_query object.

eventbrite_event_meta()

  • Outputs meta information for an event: event time, venue, organizer, and a Details link to the event single view.
  • On the single view, the Details link goes to the event's page on eventbrite.com.

eventbrite_event_time()

  • Output an event's local time, with date, starting, and end time.
  • Example: December 8 2014, 7:00 PM - 10:00 PM

eventbrite_event_venue()

  • Access the current event's venue properties: address, resource_uri, id, name, latitude, longitude

eventbrite_event_organizer()

  • Access the current event's organizer properties: description, logo, resource_uri, id, name, url, num_past_events, num_future_events

eventbrite_event_category()

  • Access the current event's category properties: resource_uri, id, name, name_localized, short_name, short_name_localized

eventbrite_event_subcategory()

  • Access the current event's subcategory properties: resource_uri, id, name, name_localized, short_name, short_name_localized

eventbrite_event_format()

  • Access the current event's format properties: resource_uri, id, name, name_localized, short_name, short_name_localized

eventbrite_event_start()

  • Access the current event's start time properties: timezone, local, utc

eventbrite_event_end()

  • Access the current event's end time properties: timezone, local, utc

eventbrite_ticket_form_widget()

eventbrite_ticket_form_widget_height()

  • Calculates what height an event's ticket form <iframe> should be (pretty rough).
  • Height is calculated with a rough assortment of variables; see here for details.

eventbrite_event_eb_url()

  • Get the URL to the current event on eventbrite.com.
  • Returns: (string) The eventbrite.com URL

eventbrite_is_multiday_event()

  • Checks if the current event spans two or more calendar days (based on UTC time).
  • Returns: (boolean) true if the date is different for the start and end times, false if they're the same.

Filters

eventbrite_templates

  • Adjust the array of valid Eventbrite templates, used for determining body classes.

eventbrite_meta_separator

  • Define the markup used to separate event meta.
  • Default: <span class="sep"> &middot; </span>

eventbrite_event_meta

  • Filter the final HTML for an event's meta info.

eventbrite_paginate_links_args

  • Adjust the arguments passed to the paginate_links() template tag (used by eventbrite_paging_nav()).

eventbrite_event_eb_url

  • Filter an event's URL to its eventbrite.com page.

eventbrite_event_venue

  • Modify the current event's venue properties (see template tag above).

eventbrite_event_organizer

  • Modify the current event's organizer properties (see template tag above).

eventbrite_event_start

  • Modify the current event's start time properties (see template tag above).

eventbrite_event_end

  • Modify the current event's end time properties (see template tag above).

eventbrite_ticket_form_widget

  • Filter the final HTML for the ticket form widgets.

eventbrite_ticket_form_widget_height

  • Adjust the <iframe> height used when outputting a ticket form widget.

eventbrite_api_expansions

  • Adjust the expansions requested on all API calls to Eventbrite.
eventbrite-api open issues Ask a question     (View All Issues)
  • almost 3 years Organizer ID can exceed maximum integer value on 32-bit installs
  • almost 3 years Redesign of Eventbrite widget results in scrollbars and hidden Register buttons
  • about 3 years Event Listing
  • about 3 years filter_event_permalink filters any call to get_permalink while event is the global post
  • over 3 years Allow proper support of additional endpoints through filters.
  • over 3 years Wordpress installed in subdirectory
  • about 4 years Default endpoint does not include events that are sold out or only announced
  • about 4 years Failing to Authorise, unhelpful error message
  • over 4 years Feature request: Calendar View for EB plugin
  • over 4 years Single views and venue/organizer archives don't work on templates assigned to subpages
  • over 4 years wpautop issue
  • almost 5 years Simplify the Keyring UI page.
  • almost 5 years Make showing private events editable by user.
eventbrite-api open pull requests (View All Pulls)
  • Allow sort_by to be set when searching for events
  • Locale and show_series_parent parameters
  • Enabling force flag
  • EB Plugin Enhancements V2
  • Match 10 digit event IDs.
eventbrite-api questions on Stackoverflow (View All Questions)
  • I am not getting address of event in Eventbrite API search respose
  • How to process ticket payment from EventBrite API v3
  • Using Expansions in the Eventbrite API
  • Object of class stdClass could not be converted to string Eventbrite API
  • Not able to fetch Latitude and longitude from eventbrite api
  • Eventbrite API Request Parameter
  • Parse JSON response from Eventbrite API in Ruby
  • eventbrite Api how to call in function file
  • How to locate Venue Map using eventbrite Api in other app
  • Eventbrite API - custom form registration in website
  • Eventbrite API and Pagination
  • How to find attendee details of a particular Order in Eventbrite API
  • Can the EventBrite API be used to post events that use a registration link (i.e. 3rd party registration)?
  • How can I get only specified fields back from Eventbrite API
  • EventBrite API - batch requesting ticket_classes for recurring event fails
  • Eventbrite API v3 Remove an Organizer
  • Post request to eventbrite API via uri in rails
  • Eventbrite API throws InternetConnectionException
  • How can I delete an event using the Eventbrite API?
  • Pull all users / events from eventbrite API
  • Using Eventbrite API to login to an app
  • Eventbrite API create private event
  • Merge eventbrite api response with wordpress CPT
  • Is there documentation of what is needed to port from V1 to V3 of the Eventbrite API?
  • EventBrite API - How Do I Get Only Live Events for my User?
  • Eventbrite API not returning Events
  • Accessing the organizer profile image Eventbrite API
  • Eventbrite API - List only upcoming events - PHP
  • Repeated events in Eventbrite API
  • Calling Eventbrite API from .Net results in 401
eventbrite-api list of languages used
Other projects in PHP