View on GitHub

Eventbrite API

The power of Eventbrite on WordPress

Download this project as a .zip file Download this project as a tar.gz file

Assistance

Below you will find more detailed install and setup help, as well as the answers to some commonly-asked questions about using the Eventbrite API plugin.

If you have any questions or comments, please visit our forums, we'll be happy to help.

Installation

The easiest way to get up and running with Eventbrite is to install the Eventbrite API plugin first, and then follow the prompts for activating and connecting the Keyring plugin.

  1. Log in to your WordPress site, and go to Plugins > Add New.
  2. Type "eventbrite api" in the search field on the right, and click Install Now.
  3. Click the "Activate Plugin" link when the download is done, and you'll be back on the Installed Plugins screen.
  4. At the top of the screen, click "Install Keyring" in the admin notice.
  5. A box will pop up with the Keyring plugin already loaded; just click "Install Now" and "Activate Plugin" when it has downloaded.

Great, everything we need is installed and activated now. On to the next step: connecting to Eventbrite.

Connecting to Eventbrite

Because the Eventbrite API plugin can access your Eventbrite account, both your site and eventbrite.com need to know that they're securely speaking to each other. So the first thing we need to do is give the two sites a "secret handshake" to use when talking, so that they're confident that your WordPress site has the proper permissions to access your Eventbrite account.

  1. Log in to your Eventbrite account, preferably in a separate tab from your WordPress site.
  2. Click "Create a new app". If you don't see the button, head to My Account > Developer > App Management.
  3. Fill in the required fields, using whatever info you like. For OAuth Redirect URI, use your WordPress site's domain name, plus "wp-admin/tools.php?page=keyring&action=verify&service=eventbrite", for example, "http://example.com/wp-admin/tools.php?page=keyring&action=verify&service=eventbrite" (without the quotes).
  4. Check the box to agree to Eventbrite's terms of use, and then click "Create Key". We're all set on the Eventbrite side.
  5. On the Installed Plugins page of your WordPress site, click on "Connect to Eventbrite".
  6. Select "Eventbrite" from the list of available services.
  7. We can leave App ID empty. For API Key, use the gray number under the KEYS column. For API Secret, use the Client Secret (click on "Show Client Secret and OAuth Token" to view it).
  8. Save the changes, and click "Back".
  9. We now have Eventbrite configured, so let's authorize our WordPress website! Click on "Eventbrite" (the word, not "Manage").
  10. This will send you to an eventbrite.com page where you click the green "Allow" button to give your WordPress site access to your Eventbrite account.
  11. You'll be back on the Keyring: Managed Connections page in WordPress, with your active connection displayed. Success!

Your WordPress site is ready to display your Eventbrite events. The final step is to assign a page to be the one to display your events.

Assigning a page for your events

  1. Go to Pages in your WordPress admin, and either edit an existing one, or create a new one. Whatever name the page has will be the heading above your events.
  2. In the Page Attributes box, choose "Eventbrite Events" from the Template dropdown, and click Update to save your changes.
  3. Go to that page, and after a moment, you will see your Eventbrite events load in.

Congratulations!

You're all set. Enjoy having your Eventbrite events displayed right along-side your other website content. See below for answers to some common questions.

Frequently Asked Questions (FAQ)

It's not working. How can I troubleshoot it?

There are three things to check, matching setup steps above:

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 makes a theme "Eventbrite-optimized". You can post on the [theme's forum](https://wordpress.org/support/) and send them [this link](https://github.com/Automattic/eventbrite-api).

Many themes available for free in the WordPress.org repository are already Eventbrite-optimized. They include: