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.