How Do I Customise The Templates?

Summary
– To best fit with your theme, start with an appropriate theme template as a base. E.g. use single.php as a base single-event.php.
– The function reference contains details and examples of the functions you can use

How Do I Customise My Templates?

1. Identify the template to edit

The table below indicates which templates are used for which pages. Other (non-page) templates exist, for example, templates for the event list shortcode and widget.

Template What its used for
single-event.php The event’s page
event-meta-single-event.php Event details, usedy by single-event.php
archive-events.php The events page, day, month, and year archive
taxonomy-event-category.php Event category pages
taxonomy-event-venue.php Event venue pages

If you want to edit an event’s page you want single-event.php. If you only want to edit the event’s meta information (that appears just before the content on single-event.php by default), you’ll want event-meta-single-event.php

2. Copy the template(s) into your theme

This is important, as changes to plug-in files are lost when you update. Once the templates are in your theme the plug-in will know to use them rather than the default ones. (They must have the same name!)

3. Edit! Edit! Edit!

You can now freely edit the templates however you wish. Be sure to checkout the function reference for documentation of the functions available to you (for displaying maps, venue information, event categories, dates etc).

If you’re editing a template to fit with your theme – I’d suggest using an existing template in your theme as a base or guide for your event template. Feel free to use Event Organiser’s default template as a reference to help you.