Pre-Work for Hand Over The Keys

The Eventbrite Events WordPress plugin will allow you to pull in your event data from Eventbrite, but it does not include your actual website assets or theme. It is simply a means to pipe event data to a new website that is unmanaged by Eventbrite. This means that the work required to stand up your website can and should be completed as soon as possible, prior to installing and activating the plugin. Below is a high-level overview of the process:

1. Secure a new web hosting provider (e.g. GoDaddy, Dreamhost, etc)
   .

2. Install WordPress on new web host
   Note: Many web hosts now offer tools to automatically install WordPress
   .

3. Download, install and activate third-party plugins from list provided via text file
   .

4. Install and activate WordPress theme
   Important: If the website was utilizing a parent/child theme setup, the parent theme (gold-parent_s) will have been included in the website files and will also need to be installed and activated
   .

5. Expand the TAR file of Media Library files and upload the files into the wp-content/uploads folder inside the WordPress installation
   .

6. Import the XML file of WordPress content

Eventbrite Events Plugin

The Eventbrite Events plugin is a custom WordPress plugin that facilitates the connection of event data entered by a client in their Eventbrite account and displays it on the frontend of their WordPress website. The plugin pulls event data from Eventbrite, adds rich Microdata to the feed, then wraps the data in easy to style classes. Eventbrite is providing a copy of this plugin to clients who have chosen the “Hand Over The Keys” option and it will enable you to recreate your current website off of the Eventbrite website platform. As a reminder, the Eventbrite Events plugin will be completely unsupported by Eventbrite moving forward.

Plugin Overview

• All event data lives in the Eventbrite Admin and not within WordPress. Any changes to event data (e.g. title, image, date, time, etc.) will continue to be made in Eventbrite and the plugin will subsequently update the content on the website.

• The event data is populated on the website through a series of shortcodes. All shortcodes are modular and will adjust to its container size, whether it be in a sidebar or on a page.

• Events are displayed on three main pages that each website should always include: Listing, Event Detail Page (EDP) and Calendar

• All event data will be pre-wrapped with Microdata. When you add other important info, such as address, phone number, etc., we recommend wrapping it with the correct Microdata tags. This makes websites highly effective for search engines and customers.

• The order of event data cannot be changed. With that said, it can be moved around quite a lot through CSS. If you need more leverage to manipulate the design we recommend jQuery being used as well.

• In addition to the data feed, the plugin supplies its own style sheet to establish an initial structure to event data that can be overwritten in your theme.

• If your website was built by the Eventbrite (or Ticketfly) team prior to 2018, then it is likely that it was utilizing the Eventbrite Events Mobile plugin in addition to the Eventbrite Events plugin. Instead of a mobile responsive website, the Mobile plugin provides a mobile optimized version of your website. While we recommend taking the time to make your website mobile responsive, the Mobile plugin is available for download and more information can be found below.

• Most websites built by the Eventbrite team utilizes FontAwesome for social, ticket and decorative icons. While this may be included in the provided theme files, it is not built into the plugin itself so you may need to set it up for your new website.

Initial Plugin Setup

Once the Eventbrite Events plugin is installed and activated on your WordPress website, there will be a Settings panel for the plugin in the wp-admin of your website. This panel features critical fields the plugin will use to connect to your Eventbrite account. In order to facilitate this connection, follow the steps outlined below. If you are working with a developer, as the client, you'll need to complete steps 1-3, while the rest can be completed by the developer. Ask your developer for login credentials to your website's wp-admin and make sure you're logged into your Eventbrite account before starting.

1. In Your Eventbrite Account: A user with an Admin role in your organization will need to create an API Key by going to the API Key Management page in their account. You can navigate to this page within your Eventbrite account by going to Account Settings > Developer Links > API Keys. (More information can be found here.)

   • Note: If you have multiple websites, you'll need to set up an API Key for each website.

   • For Application URL, use your website URL.

   • For OAuth Redirect URI, use the URL located at the top of the Settings panel in the wp-admin (Eventbrite > Settings).

2. In your WordPress Admin: Once generated, add the API Key and Client Secret to the Oauth Settings section of the Eventbrite Events plugin Settings panel in the wp-admin. Click Save Changes at the bottom of the page.

• Note: If you would like tagged headliner and support artists to display on your website, submit your API Key to request the feature flag. (More information can be found in the Notable Feature & Functionality Updates below.)

3. Once the Settings panel reloads, a new "Generate Auth Token API" button should appear under the API Key and Client Secret fields. Click the button and follow the prompts to allow the plugin to access your Eventbrite account. If successful, the organizations and venues that you have access to should appear under the Event Data Settings section.

• Reminder: You can only pull in events from organizations and venues your account has access to.

4. In the Event Data Settings section, select the appropriate data source and then select the organizations or venues to pull events from. Events can only be pulled in from either organizations or venues, but not both. To choose multiple organizations or venues, hold down the Ctrl (PC) or Command (Mac) key and click on your desired items.

5. Fill in the fields and make your desired selections in the Customization and Google Analytics sections. We recommend keeping the Enable CSS box checked.

6. Click Save Changes at the bottom of the page. If you already have shortcodes set up, you'll start to see event data populate on the frontend.

Notable Feature & Functionality Updates

In order to make the Eventbrite Events plugin available off of Eventbrite's internal website platform, extensive development work was done to turn the existing multi-site plugin into a single site plugin. While we made every effort to keep all existing features and functionality intact, there are some notable differences with the updated plugin due to technical limitations. Even with this, we are still confident that you will be able to retain the key elements of your website's design and functionality for a smooth business transition.

• Calendar: The calendar view only displays month-by-month, as opposed to showing all months on a single page. With this change, comes some markup changes in the calendar output that will require you to make CSS adjustments in your style sheet. The previous markup used <table>, <tr> and <td>, while the new markup uses <div> and <section>. In order to have the calendar appear as it did on the Eventbrite platform, make sure to update all instances of the HTML table markup.

• Email Sign Up: There is no built-in email sign up functionality that works with the Eventbrite Campaigns tool. If you want to continue capturing email sign ups on your website, we recommend setting up a Google Form or other third-party method to collect email addresses and then importing them into the Campaigns tool. Other third-party email sign ups (e.g. Mailchimp, Hive, etc) will continue to function as they did before.

• Extended Artist Data: Artist images, bios, genres, and links that are generated from the extended artist database will not pull into the Event Detail Page (EDP). The event summary and event description will still appear on the EDP and we recommend adding all artist info and additional event content into those fields during event creation for display on your website.

• Headliner / Support: In order to display and differentiate between tagged headliner and support artists, your unique API key will need a feature flag enabled. Once you have generated your API Key during the Initial Plugin Setup, please fill out this Headliner & Support Feature Flag Request Form to have the feature flag enabled for your API Key. Form submissions will be reviewed on an on-going basis, but please be patient after submitting your API Key while the Eventbrite team processes your request. If you prefer to only use event title and do not need the tagged headliner and support artists, you may skip this step.

• Listview: All event listings will paginate after 50 events. There is no option to list all available events on a single page.

• Org Filtering: On individual shortcodes (e.g. [eb_listview]), you must use org IDs as opposed to organization profile IDs. If the XML export of your WordPress content included org filtering on a shortcode, you will need to replace the organizer profile IDs with org IDs. If you are unsure of the difference between organizer profile IDs and org IDs, reach out to Eventbrite Support.

Shortcodes

A link to documentation of available configurations of the plugin can be found on the Eventbrite Plugin Help page in the wp-admin (Eventbrite > Help). A list of the available shortcodes that work with the plugin are listed at the top of the page. Clicking on the options link beside each listed shortcode will allow you to skip to the documentation specific to that shortcode.

Common Shortcodes Overview

Listview [eb_listview]

This is a chronological list of upcoming events. By default, it includes the event image, event details and ticket link or event status for each event in a three-column format.

Calendar [eb_calendar]

This displays all upcoming events in a calendar format, one month at a time. When a week passes, that week/row collapses to continue showing only upcoming events and no past events are shown. The entire calendar can be synced to iCal or Google Calendar via the calendar icons that appear in the top right corner (unless hidden by shortcode option or CSS).

Event Detail Page (EDP) [eb_event_details]

This displays all of the details for a particular event, as well as the ticket button or event status. This includes event description, calendar syncing and social sharing options.

More Upcoming Shows [eb_upcoming]

A simple list of upcoming shows in chronological order. This only displays the event date and title.

Event Search [eb_searchform]

This is a custom search widget created specifically for this plugin. We cannot use the standard WordPress search since the event data lives in Eventbrite and not within the actual WordPress site.

Just Announced [eb_justannounced]

This is similar to the simple event list that the Upcoming Shows shortcode produces, but in this list, events that would otherwise be at the bottom of a chronological list are bubbled up based on different criteria. The Just Announced list sorts events based on their publish date in Eventbrite.

Customizing Shortcode Outputs

You can customize the type of data that is displayed by including, excluding or setting parameters for a variety of data objects available for events.

Some examples:

• [eb_listview imagesize="large"] Displays a larger version of the event image

• [eb_listview exclude="age-restriction"] Hides the age restriction for an event

• [eb_listview type="justannounced"] Lists events based on publish date/time

Eventbrite Events Mobile Plugin

The Eventbrite Events Mobile plugin takes the event data entered by a client in their Eventbrite account and displays it on a mobile optimized website. This mobile optimized website does not have the variety or flexibility that the desktop site offers, but it provides an optimized mobile experience so that event info and ticket purchase are available anywhere. Most websites built before 2018 utilize the Mobile plugin. A quick way to check is to adjust your screen size to see if your site is mobile responsive. If the layout and/or content responds or adapts based on the size of screen, your website is mobile responsive and not using the Mobile plugin.

Within the wp-admin, there is a Settings panel for the Mobile plugin (Eventbrite > Mobile) and there is a section within the Eventbrite Plugin Help page that provides details on customization. The two main customizable parts of the Mobile plugin are the Mobile Header and Mobile Menu.

• Mobile Header: This provides the client’s identity and brand, but due to the limited space, the mobile header typically only shows the client’s logo or name. This must be manually done, as it does not get created automatically. The mobile header should be a png file that is 364px x 88px, that still looks sharp at 50% size (for retina screen devices) It should be named “mobile-header.png” and uploaded to the images directory in your theme.
  

• Mobile Menu: A navigation menu can be added and can be used to add links to other pages within your website that are not event related (e.g. About) or to add a link to an external website. Non-event related pages will show up as static pages on the mobile optimized website, stripped of any styling present on the desktop version. The mobile optimized pages are not customizable.