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.
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.
- Log in to your WordPress site, and go to Plugins > Add New.
- Type "eventbrite api" in the search field on the right, and click Install Now.
- Click the "Activate Plugin" link when the download is done, and you'll be back on the Installed Plugins screen.
- At the top of the screen, click "Install Keyring" in the admin notice.
- 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.
- Log in to your Eventbrite account, preferably in a separate tab from your WordPress site.
- Click "Create a new app". If you don't see the button, head to My Account > Developer > App Management.
- 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).
- On the Installed Plugins page of your WordPress site, click on "Connect to Eventbrite".
- Select "Eventbrite" from the list of available services.
- 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).
- Save the changes, and click "Back".
- We now have Eventbrite configured, so let's authorize our WordPress website! Click on "Eventbrite" (the word, not "Manage").
- 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.
- 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
- 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.
- In the Page Attributes box, choose "Eventbrite Events" from the Template dropdown, and click Update to save your changes.
- Go to that page, and after a moment, you will see your Eventbrite events load in.
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:
- Make sure you have an active connection to Eventbrite (in Tools > Keyring), and that clicking "test" is successful.
- Verify the Eventbrite Events template is assigned to your page.
- Be sure you have at least one active, public event on Eventbrite.com.
- If these are fine and you still have no events, just disconnect and then reconnect Eventbrite again ("Connecting to Eventbrite" above). This will force the plugin to check again, regardless of what it has saved.
- If you still have problems, let us know in the forums; we'll be happy to 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 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: