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

Are you looking for a simple way to add a live events search bar to your website?
<a href="https://coolplugins.net/product/events-search-addon-for-the-events-calendar/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=view_plugin&utm_content=top_description" rel="nofollow ugc">Events Search</a> is an addon for <a href="https://stellarwp.pxf.io/tec" rel="nofollow ugc">The Events Calendar</a> WordPress plugin that lets your visitors quickly search and find upcoming events using an AJAX-powered search box. Instead of browsing long event lists, users can type keywords like event name, venue, organizer, or date and instantly see matching results.
👉 View Demo: <a href="https://eventscalendaraddons.com/demos/events-search-and-filters-pro/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=demo&utm_content=top_description" rel="nofollow ugc">Events Search Bar</a>
You can add a fast and responsive live search bar anywhere using a simple shortcode.
<ul>
<li>
Search Box Shortcode: 
 [events-calendar-search placeholder=”Search Events” show-events=”5″ disable-past-events=”false” layout=”medium” content-type=”advance”]
</li>
<li>
Shortcode Attributes: 
You can control the search box functionality and display using these attributes:
<ul>
<li>placeholder – Change the default search text inside the input field. </li>
<li>show-events – Set how many events appear in the search dropdown (example: <code>5</code>). </li>
<li>disable-past-events – Set to <code>true</code> to show only upcoming events. </li>
<li>layout – Choose search box size: <code>small</code>, <code>medium</code>, or <code>large</code>. </li>
<li>content-type – Choose result style: 
basic – Shows only event title 
advance – Shows event title, date, and extra details</li>
</ul>
</li>
</ul>
<h3>More Addons To Enhance Your Events Website</h3>
If you are using The Events Calendar plugin to manage events, conferences, webinars, workshops, or local meetups, you can extend its functionality with professional addons built specifically for event websites. These addons help you improve event layout design, event listing display, search and filtering options, and overall event management experience on your WordPress website.
<ul>
<li>
<a href="https://eventscalendaraddons.com/plugin/event-single-page-builder-pro/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Event Single Page Builder for The Events Calendar</a>: 
Replace the default event template with a fully <a href="https://eventscalendaraddons.com/doc/elementor-event-page-template/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=docs&utm_content=more_addons" rel="nofollow ugc">custom single event page</a>. Design professional event pages using Elementor and showcase event schedule, venue details, maps, speakers, sponsors, ticket booking buttons, countdown timers, and call-to-action sections. You can also use it on non-Elementor websites using ready-made templates.
</li>
<li>
<a href="https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Events Widgets for Elementor</a>: 
Looking for an event widget for Elementor? This addon provides widgets to show event list, grid, and <a href="https://eventscalendaraddons.com/doc/events-carousel-widget-elementor/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=docs&utm_content=more_addons" rel="nofollow ugc">carousel</a>. You can display events in different layouts and customize event meta fields such as date, venue, organizer, and ticket links.
</li>
<li>
<a href="https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Events Shortcodes for The Events Calendar</a>: 
Display events anywhere on your website using <a href="https://eventscalendaraddons.com/doc/the-events-calendar-shortcode-attributes/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=docs&utm_content=more_addons" rel="nofollow ugc">flexible shortcodes</a>. Show upcoming events, past events, featured events, or category-based event listings in list, grid, slider, timeline, masonry, accordion, and more.
</li>
</ul>
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/uL3ToWGncbM?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>
<ul>
<li>
<a href="https://eventscalendaraddons.com/plugin/events-speakers-and-sponsors/?utm_source=ecsa_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 inside your event pages. Showcase keynote speakers, guest presenters, partners, and sponsors with structured layouts to increase credibility and improve event promotion.
</li>
<li>
<a href="https://eventscalendaraddons.com/plugin/the-events-calendar-modules-for-divi/?utm_source=ecsa_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons" rel="nofollow ugc">Events Calendar Modules for Divi</a>: 
Using Divi theme? Display The Events Calendar events inside Divi Builder using custom event modules and create stylish event list and grid layouts.
</li>
</ul>
<h4>Some Other Cool Plugins</h4>
<ul>
<li><a href="https://cooltimeline.com/plugin/elementor-timeline-widget-pro/" rel="nofollow ugc">Timeline Widget for Elementor</a>: Create vertical and horizontal timelines inside Elementor.</li>
<li><a href="https://coolformkit.com" rel="nofollow ugc">Cool FormKit</a>: Add advanced fields and features to Elementor forms.</li>
<li><a href="https://coolplugins.net/product/autopoly-ai-translation-for-polylang/" rel="nofollow ugc">AutoPoly</a>: Polylang addon to automatically translate WordPress pages and posts using AI.</li>
<li><a href="https://locoaddon.com" rel="nofollow ugc">LocoAI</a>: Translate WordPress plugin strings inside Loco Translate using an AI translator.</li>
<li><a href="https://cryptocurrencyplugins.com/wordpress-plugin/cryptocurrency-widgets-pro/" rel="nofollow ugc">Cryptocurrency Widgets</a>: Display live cryptocurrency prices, charts, and market data.</li>
</ul>
Third-Party Services: This plugin connects to the Cool Plugins server to display information about related plugins inside its dashboard. It also offers optional usage tracking only after explicit user consent (opt-in). No frontend visitor 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>.
Disclaimer: Events Search Addon is developed by <a href="https://coolplugins.net" rel="nofollow ugc">Cool Plugins</a> and is not affiliated with or endorsed by the official team of The Events Calendar. Some links inside this plugin or its readme may be affiliate links, which means we may earn a small commission at no additional cost to you.
<h4>Special Thanks</h4>
Special thanks to the authors of <a href="https://stellarwp.pxf.io/tec" rel="nofollow ugc">The Events Calendar</a> plugin for creating a powerful and widely used event management solution for WordPress.

Events Search For The Events Calendar

Adds an AJAX-based events search bar on any page via shortcode to quickly find any upcoming event created with The Events Calendar plugin.

Atomic Events Calendar vs Events Search For The Events Calendar