Customizing V1 Template Files

👋 This article covers Views 1 (V1), the legacy design of calendar views prior to The Events Calendar 5 and Events Calendar Pro 5. If you are using newer versions, please check out the updated guide for customizing V2 plugin template files.

The Events Calendar and its add-ons come with a number of template files that determine how the plugin looks and behaves. We call these templates views because they create the pages that you see on your site.

Say you want to change the layout of your calendar, but custom CSS won’t cut it by itself. Instead, you can create a custom layout by overriding template files in your own WordPress theme. Every calendar view has a template file, or several of them, that can be customized by overriding them.

We allow template overrides because they are a lot safer than directly editing templated in the plugin folder. Editing the files directly not only causes conflicts that could take down your site, but will cause you to lose your changes the next time you update the plugin. Template overrides keep your custom work in your theme — whether that’s a theme you made from scratch or a child theme based on another theme — so that it’s safe and preserves your work.

Where are the plugin’s template files and where do the template overrides go? Let’s dig into that.

Locating template files

The Events Calendar and its add-ons have a folder in the plugin files called views that contain the template files that are available to customize. For example, you can find the template files for The Events Calendar at wp-content/plugins/the-events-calendar/src/views.

Every plugin is located on your server where WordPress is installed in the /wp-content/plugins folder. Here’s where you can find the template files for each plugin and add-on.

PluginTemplate Files
The Events Calendarthe-events-calendar/src/views
Events Calendar Proevents-calendar-pro/src/views
Event Ticketsevent-tickets/src/views
Event Tickets Plusevent-tickets-plus/src/views
Community Eventsthe-events-calendar-community-events/src/views
Community Ticketsthe-events-calendar-community-events-tickets/src/views
Eventbrite Ticketsthe-events-calendar-eventbrite-tickets/src/views
Filter Barthe-events-calendar-filterbar/src/views

For more information and a list of all the available templates in each plugin and add-on, please check out the Calendar Template Files.

Adding a new folder in your theme

Once you’ve located the template file you want to customize, make a copy of it and save it somewhere for a moment, like your computer desktop.

Next, let’s head over to your theme folder and create a new folder. The folder you is called tribe-events. Not sure where your theme folder is located? It’s where WordPress is installed in the /wp-content/themes folder.

So far, you should have a new folder in your theme located at: /wp-content/themes/your-theme/tribe-events

Now, which plugin or add-on does your copied template file belong to? If it’s The Events Calendar and you are using the classic editor to create event, you can drop copied file directly in the tribe-events folder. If it’s the other plugins or add-ons, then you’ll need to make another folder that correlates with the plugin you are customizing. That includes the following:

PluginFolder
The Events Calendar/tribe-events
Events Calendar Pro/tribe-events/pro
Event Tickets/tribe-events/tickets
Event Tickets  Plus/tribe-events/tickets
Eventbrite Tickets/tribe-events/tickets/eventbrite
Community Events/tribe-events/community
Community Tickets/tribe-events/community/tickets
Filter Bar/tribe-events/filter-bar

There’s a caveat here and it’s events that are created with the WordPress block editor (aka Gutenberg). Those blocks used to create the event page are their own template files and go into a different folder in your theme.

So, instead of putting block template files in the tribe-events folder, create another folder next to it in your theme called tribe. Event blocks will go inside the tribe folder in another folder called events and ticket blocks will go in another folder called tickets.

Here’s how the file structure should look.

your-theme/
├── tribe-events/
└── tribe/
├── events/blocks/
└── tickets/blocks/

Customize the template

Now that you’ve located the template you want to override, made a copy of it, created a new tribe-events folder (or tribe for block templates) in your theme, and put the copied template file in its corresponding plugin folder, you can start customizing!

If you’re feeling stuck at any point in the process, we’ve put together an example of a customization that you can check out that walks through this process one step at a time.

Table of Contents

Details

Report an issue