Lehel Mátyus

Atomic Events Calendar is built for developers and agencies who need events in WordPress without the overhead of full event management plugins.
Instead of starting from scratch on every project, Atomic Events Calendar gives you:
– A ready-to-use Events post type 
– Essential event fields (date, venue, type, etc.) 
– Developer-friendly shortcodes to display and filter events 
– A robust theming structure for easy overrides and custom designs
✨ Think of it as a lightweight framework disguised as a plugin: everything you need to set up events quickly, with the freedom to extend and customize as you like.
Perfect for agencies that want full control over their event implementations—without the bloat.
<h3>Features</h3>
<ul>
<li>Developer-Friendly – Clean code structure with services architecture</li>
<li>Responsive Design – Built with Tailwind CSS for modern, responsive layouts</li>
<li>Structured Data for Search Engines – Automatic JSON-LD schema markup for better SEO and rich snippets</li>
<li>Custom Post Type – Dedicated ‘atomic-event’ post type with all necessary fields</li>
<li>Template Override System – Easy theme integration with template hierarchy</li>
<li>Shortcode Support – Display events anywhere with <code>[atomic-events]</code> shortcode</li>
<li>Featured Events – Mark and display featured events prominently</li>
<li>Location Management – Complete address fields (street, city, state, country, postcode)</li>
<li>Date & Time Support – Start/end dates with time support</li>
<li>Image Support – Featured images with captions</li>
<li>Member-Only Events – Restrict events to members only</li>
<li>Performance Caching – Automatic shortcode caching with smart invalidation</li>
</ul>
Basic usage is through shortcode:
<pre><code>[atomic-events filter max='10' columns='3' featured='0' 
 skip_first_x='0' skip_first_x_featured='1' order='ASC']
</code></pre>
<h3>How can I customize the event template?</h3>
The plugin provides a default template for single events, but you can override it in your theme:
<ol>
<li>Child Theme (recommended): Copy the template to <code>child-theme/atomic-events/single/single-atomic-event.php</code></li>
<li>Parent Theme: Copy the template to <code>parent-theme/atomic-events/single/single-atomic-event.php</code></li>
</ol>
The plugin will automatically use your theme’s version instead of the default.
See the example template in <code>templates/theme-override-example.php</code> for reference.
<h4>My event pages show 404 errors</h4>
If you experience 404 errors when viewing event pages: 
1. Go to WordPress Admin → Events → Settings 
2. Click “Flush Rewrite Rules” 
3. If that doesn’t work, go to Settings → Permalinks and click “Save Changes”
<h3>Template Structure</h3>
The plugin provides a comprehensive template override system. You can override any template by creating files in your theme:
<pre>
 your-theme/
 └── atomic-events/
 │ ├── cards/
 │ │ ├── card-item-default.php
 │ │ ├── card-item-featured.php
 │ │ ├── card-list-header-default.php
 │ │ └── card-list-footer-default.php
 │ ├── single/
 │ │ └── single-atomic-event.php
 │ ├── content/
 │ │ └── single-event.php
 │ 
</pre>
<h3>Template Hierarchy</h3>
The plugin follows WordPress template hierarchy for single event pages. Templates are loaded in this order of priority:
<ol>
<li>Child Theme: <code>child-theme/atomic-events/single/single-atomic-event.php</code></li>
<li>Parent Theme: <code>parent-theme/atomic-events/single/single-atomic-event.php</code></li>
<li>Plugin Default: <code>plugin/templates/single/single-atomic-event.php</code></li>
</ol>
<h3>Template Override System</h3>
The plugin uses a custom template loader that checks for theme templates first, then falls back to the plugin’s default template. This ensures:
– Theme compatibility: Works with any WordPress theme 
– Customization flexibility: Easy to override in themes 
– Update safety: Plugin updates won’t break custom templates 
– Developer-friendly: Clear hierarchy and fallback system
Template Hierarchy Priority:
<ol>
<li>Child Theme: <code>child-theme/atomic-events/[template-name].php</code></li>
<li>Parent Theme: <code>parent-theme/atomic-events/[template-name].php</code></li>
<li>Plugin Default: <code>plugin/templates/[template-name].php</code></li>
</ol>
Available Templates: 
– Shortcode Templates: Override how events appear in lists and grids 
– Single Event Templates: Customize individual event page layouts 
– Content Templates: Modify event content display
The default template includes: 
– WordPress header/footer integration 
– Event model for accessing custom fields 
– Template loader for modular content parts 
– Proper WordPress loop structure
<h3>Custom Fields Available</h3>
When creating custom templates, you have access to these event fields:
<pre>
$event_model = new AtomicEventModel(get_the_ID());

// Basic event data
$event_model->get_title();
$event_model->get_event_start_date();
$event_model->get_event_end_date();
$event_model->get_event_venue();
$event_model->get_event_location_city();
$event_model->get_event_country();
$event_model->get_event_location_state();
$event_model->get_event_location_region();

// Event settings
$event_model->is_featured();
$event_model->is_member_only();
$event_model->get_event_all_day();

// Additional data
$event_model->get_event_outbound_link();
$event_model->get_event_tag();
$event_model->get_event_image_id();
$event_model->get_permalink();
</pre>
<h3>Creating Custom Templates</h3>
<ol>
<li>Copy the example template from <code>templates/theme-override-example.php</code></li>
<li>Place it in your theme at the appropriate path</li>
<li>Customize the template as needed</li>
<li>Test thoroughly to ensure proper functionality</li>
</ol>
<h3>Hooks and Filters</h3>
The plugin provides several hooks for customization:
<pre>
// Filter the template path
add_filter('atomic_events_template_path', 'my_custom_template_path', 10, 2);

// Filter event data before display
add_filter('atomic_events_event_data', 'my_custom_event_data', 10, 2);

// Filter whether to show event in lists
add_filter('atomic_events_should_show_in_list', 'my_custom_visibility_logic', 10, 2);
</pre>
<h3>Shortcode Parameters</h3>
The <code>[atomic-events]</code> shortcode supports these parameters:
– <code>filter</code>: “future” or “past” (default: “future”) 
– <code>max</code>: Maximum number of events (default: 20) 
– <code>columns</code>: Number of columns (default: 3) 
– <code>featured</code>: Show only featured events (true/false) 
– <code>skip_first_x</code>: Skip first X events 
– <code>skip_first_x_featured</code>: Skip first X featured events 
– <code>order</code>: “ASC” or “DESC” (default: “ASC”)
<h3>Best Practices</h3>
<ol>
<li>Always use child themes for customizations</li>
<li>Test with different themes to ensure compatibility</li>
<li>Use the event model for accessing custom fields</li>
<li>Follow WordPress coding standards</li>
<li>Document custom modifications</li>
<li>Test thoroughly before deployment</li>
</ol>

Atomic Events Calendar

Atomic Events Calendar: A lightweight WordPress events framework that gives agencies full control without the bloat.

Satinder Singh

CoolHappy

Cool Plugins

Events Calendar Addons

<a href="https://eventscalendaraddons.com/plugin/event-single-page-builder-pro/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=top_description" rel="nofollow ugc">Event Single Page Builder</a> is an addon for <a href="https://stellarwp.pxf.io/tec" rel="nofollow ugc">The Events Calendar</a> plugin that helps you create custom single event page templates. Instead of using the default event layout, you can design a custom event page template that matches your website style and overall theme.
This extension helps you create a modern event calendar layout with full control over layout, colors, template display condition, and date format. You can replace the default single event page layout of The Events Calendar with your own custom design.
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/50FBrcqoB-M?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
<h3>Live Demos</h3>
👉 View FREE Demo: <a href="https://eventscalendaraddons.com/event/blood-donation-camp-in-delhi/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_free&utm_content=below_video" rel="nofollow ugc">Single Event Page Template</a>
👉 View PRO Demos: Design single event, category, venue, and organizer page layouts.
<ul>
<li>
Design page templates in Elementor (PRO)
<ul>
<li><a href="https://eventscalendaraddons.com/event/ghost-music-band-performance/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_elementor&utm_content=below_video" rel="nofollow ugc">Single Event Page</a>: Create fully custom single event page templates using Elementor.</li>
<li><a href="https://eventscalendaraddons.com/events/category/training/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_elementor&utm_content=below_video" rel="nofollow ugc">Category Page</a>: Build stylish event category archive layouts.</li>
<li><a href="https://eventscalendaraddons.com/venue/rotary-blood-bank-delhi/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_elementor&utm_content=below_video" rel="nofollow ugc">Venue Page</a>: Customize venue pages and display all events of that venue.</li>
<li><a href="https://eventscalendaraddons.com/organizer/xyz-club/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_elementor&utm_content=below_video" rel="nofollow ugc">Organizer Page</a>: Design organizer detail pages and show related events.</li>
</ul>
</li>
<li>
Pre-built templates for Non-Elementor sites (PRO)
<ul>
<li><a href="https://eventscalendaraddons.com/event/womens-marathon-in-london/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_prebuilt&utm_content=below_video" rel="nofollow ugc">Single Event Page Template</a>: Use ready-made templates for single event pages.</li>
<li><a href="https://eventscalendaraddons.com/events/category/wedding/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_prebuilt&utm_content=below_video" rel="nofollow ugc">Category Page Template</a>: Quick setup with pre-designed event category layouts.</li>
<li><a href="https://eventscalendaraddons.com/venue/cc-venue-oakland/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_prebuilt&utm_content=below_video" rel="nofollow ugc">Venue Page Template</a>: Ready-to-use venue page design.</li>
<li><a href="https://eventscalendaraddons.com/organizer/ride-it-up/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_prebuilt&utm_content=below_video" rel="nofollow ugc">Organizer Page Template</a>: Structured organizer page layout with event listing.</li>
</ul>
</li>
</ul>
<a href="https://eventscalendaraddons.com/demos/event-single-page-builder-pro/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=demo_pro&utm_content=below_video" rel="nofollow ugc">View All PRO Demos</a>
<h3>Plugin Features</h3>
<ul>
<li>Custom Single Event Page Template: Replace the default single event page layout of The Events Calendar with a clean and modern event template design.</li>
<li>Apply Template to All Events: Automatically apply the same custom event page layout to all your published events without editing them individually.</li>
<li>Date & Time Format Control: Choose how the event date and time should appear on your single event page based on your country format and preference.</li>
<li>Primary Color & Display Conditions: Select template display condition and colorsto match your website branding and theme style.</li>
<li>Custom CSS Option: Add your own CSS to further customize the event layout.</li>
<li>Fully Responsive Layout: The event single page template is fully responsive and works smoothly on mobile, tablet, and desktop devices.</li>
</ul>
<h3>PRO Features</h3>
<ul>
<li>
<a href="https://eventscalendaraddons.com/doc/elementor-event-page-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Single Event Page Builder for Elementor</a>: Design fully custom single event page templates using Elementor’s drag-and-drop editor with dynamic event widgets.
<ul>
<li><a href="https://eventscalendaraddons.com/doc/elementor-event-category-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Events Category Page</a>: Create custom event category archive layouts in Elementor.</li>
<li><a href="https://eventscalendaraddons.com/doc/elementor-event-venue-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Venue Page</a>: Design dedicated venue pages and display all events of that venue.</li>
<li><a href="https://eventscalendaraddons.com/doc/elementor-event-organizer-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Organizer Page</a>: Build organizer detail pages and dynamically show related events.</li>
</ul>
To design category, venue, and organizer layouts in Elementor, the <a href="https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=pro_features" rel="nofollow ugc">Events Widgets</a> plugin must be installed along with Event Single Page Builder.
</li>
<li>
<a href="https://eventscalendaraddons.com/doc/elementor-event-speakers-sponsors-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Add Speakers & Sponsors Section</a>: Display speakers and sponsors blocks on your event page using the <a href="https://eventscalendaraddons.com/plugin/events-speakers-and-sponsors/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=pro_features" rel="nofollow ugc">Events Speakers & Sponsors</a> plugin.
</li>
<li>
Pre-built Templates for Non-Elementor Sites:
<ul>
<li><a href="https://eventscalendaraddons.com/doc/single-event-page-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Single Event Page Template</a>: Use ready-made templates for single event pages.</li>
<li><a href="https://eventscalendaraddons.com/doc/category-page-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Category Page Template</a>: Quickly set up event category archive layouts.</li>
<li><a href="https://eventscalendaraddons.com/doc/organizer-page-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Organizer Page Template</a>: Display organizer details along with their events.</li>
<li><a href="https://eventscalendaraddons.com/doc/venue-page-template/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Venue Page Template</a>: Display venue details and all related events.</li>
</ul>
</li>
<li>
<a href="https://eventscalendaraddons.com/doc/events-multiple-templates/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features" rel="nofollow ugc">Apply Multiple Templates to Different Events</a>: Assign different templates based on event category or specific events.
</li>
</ul>
<h3>Why Use Event Single Page Builder with The Events Calendar?</h3>
If you run an event website, training portal, conference platform, festival site, or community events directory and use The Events Calendar WordPress event plugin to manage your events, you may notice that the default single event page layout has design limitations. This addon helps you create branded and professional single event page templates.
With PRO features, you can also design category, venue, and organizer page layouts to manage a complete event website. Display all events from a specific venue on its own page, show all events by a particular organizer, or organize events by category in a clean and structured format using this powerful WordPress event plugin setup.
<h3>Other Extensions For <a href="https://stellarwp.pxf.io/tec" rel="nofollow ugc">The Events Calendar</a></h3>
If you are using The Events Calendar WordPress plugin, you can extend its functionality further with these powerful addons:
<ul>
<li><a href="https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Events Widgets for Elementor & The Events Calendar</a>: Display events inside Elementor using list, grid, carousel, slider, and other advanced layouts with full styling control.</li>
<li><a href="https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Events Shortcodes for The Events Calendar</a>: Show events anywhere on your website using simple shortcodes in list, grid, timeline, or calendar format.</li>
<li><a href="https://eventscalendaraddons.com/plugin/events-speakers-and-sponsors/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Events Speakers & Sponsors</a>: Add dedicated speakers and sponsors sections to your event pages with structured layouts.</li>
<li><a href="https://eventscalendaraddons.com/plugin/the-events-calendar-modules-for-divi/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Events Calendar Modules for Divi</a>: Display The Events Calendar events using custom Divi modules built specifically for Divi Builder pages and layouts.</li>
</ul>
<h3>Other Plugins by <a href="https://cooltimeline.com/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=homepage&utm_content=other_plugins" rel="nofollow ugc">Cool Plugins</a></h3>
Cool Plugins has also built many WordPress plugins for different use cases:
<ul>
<li><a href="https://coolformkit.com/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins" rel="nofollow ugc">Cool FormKit</a>: Advanced Elementor form fields and conditional logic addon.</li>
<li><a href="https://cooltimeline.com/plugin/cool-timeline-pro/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins" rel="nofollow ugc">Cool Timeline</a>: Create vertical and horizontal timeline layouts.</li>
<li><a href="https://coolplugins.net/product/autopoly-ai-translation-for-polylang/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins" rel="nofollow ugc">AutoPoly</a>: AI translation addon for Polylang multilingual sites.</li>
<li><a href="https://locoaddon.com/?utm_source=epta_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins" rel="nofollow ugc">LocoAI</a>: AI-powered translation helper for Loco Translate.</li>
</ul>
Use of Third-Party Services: To improve the plugin experience, this plugin connects to the Cool Plugins API to display related plugins information inside its dashboard. It also offers optional usage tracking and an optional feedback form during deactivation. Data is sent only after explicit user consent. No hidden tracking is performed, and no frontend visitor or personal site user data is collected. For complete details, please review our <a href="https://my.coolplugins.net/terms/usage-tracking/" rel="nofollow ugc">Data Usage Policy</a>, <a href="https://my.coolplugins.net/terms/" rel="nofollow ugc">TOS</a>, and <a href="https://my.coolplugins.net/terms/privacy-policy/" rel="nofollow ugc">Privacy Policy</a>. It also uses <a href="https://github.com/CMB2/CMB2/tree/develop?tab=GPL-3.0-1-ov-file" rel="nofollow ugc">CMB2</a> for the settings panel (GPL licensed).
Disclaimer: Event Single Page Builder For The Events Calendar is developed by Cool Plugins and is not affiliated with or endorsed by The Events Calendar team (a product of StellarWP, Liquid Web). Some links in this plugin or its readme may be affiliate links, meaning we may earn a commission at no extra cost to you.

Event Single Page Builder For The Events Calendar

The Events Calendar addon to create custom single event page templates and replace the default event single page layout with your own branded design.

Atomic Events Calendar vs Event Single Page Builder For The Events Calendar