Eventbrite API

Description

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

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.

As a theme or plugin developer, you get simple-to-use tools for making any theme or plugin Eventbrite-compatible. 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.

Eventbrite logo used by permission. Banner photo by Daniel Robert Dinu, licensed under CC0.

Installation

The Eventbrite API plugin also requires the Keyring plugin, which is used for managing the user’s connection to eventbrite.com. Keyring needs to be installed, activated, and using a connection to eventbrite.com for any events to display on the website.

If the eventbrite API plugin is installed but missing Keyring or an eventbrite.com connection, admin notices will prompt the user with helpful links.

  1. Upload eventbrite-api.zip or search for it from the Plugins > Add New admin page.
  2. Activate the plugin through the Plugins menu.
  3. Repeat these steps for the Keyring plugin.
  4. Log in to your Eventbrite account, create an app, and authorize Keyring.
  5. Assign the Eventbrite Events page template to a page. This will be the page that shows your Eventbrite events.

For more detailed instructions, see the Eventbrite API user assistance page.

FAQ

Are there more detailed instructions for Keyring and getting connected to Eventbrite?

Yes! Check out the user assistance page on the Eventbrite API website, and post to the forums if you need any further help.

Events don’t quite look like the rest of the theme – how can I fix it?

While a theme doesn’t need to know about the plugin to display events, it’s always best if the theme developer optimizes their theme for Eventbrite. You can post on the theme’s forum and send them this link. You can also send an email to themes@wordpress.com and we’ll see what we can do to help. The following themes have already been optimized:

I’m a theme developer; how can I make my theme Eventbrite-optimized?

Assuming your theme is based on Underscores, most of the work is already done for you. Just load the theme, and compare your markup to that of the plugin’s included templates. Make your own copies, adjusting the markup as needed, and then assign your templates in an add_theme_support call. Most themes can be done in under ten minutes. More details can be found at the Eventbrite API GitHub repo.

What Eventbrite endpoints are supported?

The following endpoints are currently supported, with more on the way. Open an issue on GitHub to request support for others.

Where can I get detailed documentation for working with the plugin?

All development for Eventbrite API plugin is done through the GitHub repo, and detailed documentation can be found on the repo’s GitHub page.

Who made this plugin?

This plugin was developed by Automattic, in direct partnership with Eventbrite. The Eventbrite name and logo are used by permission.

Reviews

Works great. If I can install… you can!

I installed the plugin, then the keyring, followed simple directions, created a page just by changing template on the page. The folks who wrote these programs did all the heavy lifting. Thank you!

Works… with effort

Got it working in the end, with substantial effort. I feel like this plugin is good in theory, but flawed in several key ways.

1.) The set up is complex and not intuitive. Even as an experienced WordPress developer I needed to go back and forth between my site, Eventbrite and at least 3 different sets of installation instructions which for some odd reason are not compiled into one official and easily identifiable place. Got there in the end… but the effort just doesn’t feel worth the reward

2.) As others have mentioned, it does not get new Eventbrite events automatically. You have to manually disconnect and reconnect constantly. How annoying. And a time sink because it wasn’t mentioned clearly in the docs.

3.) The difference from Eventbrite’s own widget does not seem worth the trouble IMO unless you had a very large number of events and didn’t want to manage the listing text in two places. For a single event Eventbrite’s embedable widget is a much easier and quicker way to achieve the same end result.

4.) I would really love to have seen screenshots and/or demo of this before going to all this effort. A small peeve…. but after spending an hour or so getting this working only to find it was not the best solution for my use-case it really leaves a bad taste. Sorry guys.

Tips for other users

  • Create your events in Eventbrite first, THEN connect Eventbrite account. Otherwise the plugin can’t get the events and it will show nothing.
  • Make sure your Eventbrite events are PUBLIC
  • If you do add new events or change event settings you’ll need to manually delete then re-add Eventbrite in Tools > Keyring. This forces it to get the new events manually.
  • Take a look at Eventbrite’s own widgets as an alternative option for simple single event integration.

Doesn't Update/Refresh

Before you install this plugin, plus Keyring, be sure that you understand that this does NOT have the capability to update/refresh. From the admin, “Unfortunately, there’s currently no way for Eventbrite to inform the WordPress site of new events and force it to refresh.” Read full post.

This important limitation should be in the plugin description. For me, that pretty much zeroes out the value of the plugin. That means that whoever is populating the EB events must also have admin access to WordPress to disconnect/reconnect Keyring and Eventbrite EVERY time a new event is added.

I hope that EB can develop a more full-featured and robust plugin so that I can pitch its functionality to clients as an easy solution.

Read all 11 reviews

Contributors & Developers

“Eventbrite API” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Eventbrite API” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.12 – December 12, 2016

  • Fix display of Eventbrite ticket iframes.
  • Improve page template handling.
  • Make the full uploaded logo available in the event object.

1.0.11 – May 30, 2016

  • Support the status parameter in Eventbrite_Query when displaying private events.
  • Have date formats reflect the admin settings.
  • Improve the URL format to avoid occasional issues with the Eventbrite API.

1.0.10 – October 7, 2015

  • Fix bug from when Eventbrite_Query args conflict with the loading URL.
  • Fix bugs involving organizer events not owned by the user.
  • Add filters for transient names and API responses.
  • Fix PHP warnings when certain ticket information is not available.

1.0.9 – October 4, 2015

  • Increase timeout for Eventbrite API calls.
  • Add a filter for expansions.

1.0.8 – August 18, 2015

  • Fix bug where Eventbrite would not load for logged-in users, other than the user that created the Eventbrite connection.

1.0.7 – August 9, 2015

  • Add support for the nopaging query parameter (props @otterly).
  • Add support for the category_id, subcategory_id, and format_id query parameters (props @moust).

1.0.6 – August 2, 2015

  • Avoid caching and filtering on invalid API responses.
  • Improve rewrite rules flushing on page saves and template changes.

1.0.5 – April 23, 2015

  • Add expansions, to handle breaking changes to the API planned for May 13, 2015.

1.0.4 – April 2, 2015

  • Update to logo handling; Eventbrite announced a sudden breaking change to happen April 7th, 2015.
  • Fix bug affecting detection of logos in events.

1.0.3 – January 31, 2015

  • Display Edit link only if user is logged in with appropriate capabilities.
  • Only output event logo markup if one exists. Corrects broken image icon in Firefox.

1.0.2 – January 21, 2015

  • Add filter for transient expiry.

1.0.1 – December 12, 2014

  • Add an anonymous referral code to OAuth connections so Eventbrite can gauge adoption on WordPress.

1.0 – December 1, 2014

  • Initial release.