How to Customize the Single Event Page

Single event pages in EventON are powered by the core plugin and can be fully customized by overriding the default template files in your active WordPress theme. This allows you to integrate EventON’s single event display seamlessly with your theme’s styling and layout structure (e.g., headers, footers, sidebars).

By overriding the single-ajde_events.php template, you control the overall structure of the single event page, including hooks for content, sidebars, and additional elements. This guide walks you through the process step by step, including the updated template code based on EventON version 4.5.5+ standards.

Important Notes:

• Always use a child theme to avoid losing customizations during theme updates.
• This template follows WordPress coding standards and is inspired by the Twenty Thirteen theme. If your theme has unique structures, you may need to add custom CSS to resolve styling conflicts.
• Test changes on a staging site before going live.

Step 1: Create /eventon folder

1. Navigate to your active theme’s directory (e.g., wp-content/themes/your-theme-name/ or your child theme).
2. Create a new folder named eventon inside the theme folder. The path should look like: wp-content/themes/your-theme-name/eventon/

This folder will hold all EventON template overrides.

Step 2: Copy and Customize the Template File

1. Locate the default single-ajde_events.php in the EventON plugin directory: wp-content/plugins/eventON/single-ajde_events.php
2. Copy this file into your new eventon folder: wp-content/themes/your-theme-name/eventon/single-ajde_events.php
3. Open the copied file in a code editor and edit the file content to your custom layout. Be sure to retain the eventON single event do_action() filters in place.

Current single-ajde_events.php file will look like this. You can edit the HTML structure, while making sure the do_action() hooks remain in place, so the event content is added properly.

<?php	
/*
 *	The template for displaying single event
 *
 *	Override this tempalte by coping it to ....yourtheme/eventon/single-ajde_events.php
 *	This template is built based on wordpress twentythirteen theme standards and may not fit your custom
 *	theme correctly, in which case you may have to add custom styles to fix style issues
 *
 *	@Author: AJDE
 *	@EventON
 *	@version: 4.5.5
 */


// Exit if accessed directly
if ( ! defined( 'ABSPATH' ) ) {	exit; }	

do_action('eventon_before_header');	


// you can also pass a lang value in below function to create fixed lang single event page.
// this value will be overriden by language corresponding events
do_action('eventon_before_main_content');

?>	
<div id='main'>
	<div class='evo_page_body'>

		<?php do_action('eventon_single_content_wrapper');?>

			<?php /* The loop */ ?>
			<?php while ( have_posts() ) : the_post(); ?>

				<?php evo_get_template_part('content','single-event');?>
				
			<?php endwhile; ?>	

		<?php	do_action('eventon_single_sidebar');	// DEP ?>

		<?php	do_action('eventon_single_after_loop');	?>

	</div><!-- #primary -->	

</div>	

<?php 	do_action('eventon_after_main_content'); 

<?php	
/*
 *	The template for displaying single event
 *
 *	Override this tempalte by coping it to ....yourtheme/eventon/single-ajde_events.php
 *	This template is built based on wordpress twentythirteen theme standards and may not fit your custom
 *	theme correctly, in which case you may have to add custom styles to fix style issues
 *
 *	@Author: AJDE
 *	@EventON
 *	@version: 4.5.5
 */


// Exit if accessed directly
if ( ! defined( 'ABSPATH' ) ) {	exit; }	

do_action('eventon_before_header');	


// you can also pass a lang value in below function to create fixed lang single event page.
// this value will be overriden by language corresponding events
do_action('eventon_before_main_content');

?>	
<div id='main'>
	<div class='evo_page_body'>

		<?php do_action('eventon_single_content_wrapper');?>

			<?php /* The loop */ ?>
			<?php while ( have_posts() ) : the_post(); ?>

				<?php evo_get_template_part('content','single-event');?>
				
			<?php endwhile; ?>	

		<?php	do_action('eventon_single_sidebar');	// DEP ?>

		<?php	do_action('eventon_single_after_loop');	?>

	</div><!-- #primary -->	

</div>	

<?php 	do_action('eventon_after_main_content'); 

Step 3: Test and Debug

1. Save the file and visit a single event page (e.g., /event/your-event-slug/).
2. Clear any caching plugins and check for errors.
3. If issues arise:
   • Enable WordPress debug mode (define(‘WP_DEBUG’, true); in wp-config.php).
   • Verify file permissions (644 for PHP files).
   • Consult EventON’s troubleshooting docs for PHP/JS errors.
   • If you get 404 page → Refersh permalink by visiting Settings > Permalink click save changes.

Additional Resources

• Further Overrides: Customize event cards or tops via content-single-event.php or hooks in the Codex.
• Hooks Reference: See EventON Hooks: Actions & Filters for extending functionality.
• Changelog: Track updates in EventON Changelog.

If you encounter theme-specific issues, share your setup details for more tailored advice. Happy customizing!