Árpád 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

<a href="https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=top_description" rel="nofollow ugc">Events Shortcodes</a> is an addon for The Events Calendar plugin that adds the missing shortcode functionality to The Events Calendar plugin. With this plugin, you can easily display your events on any page or post.
<iframe loading="lazy" title="Display your events in Gutenberg Editor using our Events shortcode plugin" width="750" height="422" src="https://www.youtube.com/embed/uL3ToWGncbM?feature=oembed" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
Whether you want to display your events in a list, grid, timeline, or minimal list layout, this plugin makes it simple by adding a shortcode. It’s a time-saving tool that allows you to highlight key events in a visually appealing way without needing advanced coding skills.
<a href="https://eventscalendaraddons.com/demos/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=check_demos" rel="nofollow ugc">Check Plugin Demos</a> | <a href="https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=get_pro#pricing" rel="nofollow ugc">Get Pro</a>
<h3>Free Version Demos</h3>
<a href="https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_list" rel="nofollow ugc">Events List</a>|<a href="https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-timeline/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_timeline" rel="nofollow ugc">Events Timeline</a>|<a href="https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-minimal-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=minimal_list" rel="nofollow ugc">Events Minimal List</a>
Pro Version Demos
<a href="https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-grid/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_grid" rel="nofollow ugc">Events Grid</a>|<a href="https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-carousel/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_carousel" rel="nofollow ugc">Events Carousel</a>|<a href="https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-slider/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_slider" rel="nofollow ugc">Events Slider</a>
<h3>Key Features</h3>
<ul>
<li>Shortcode Friendly: Easily generate and customize shortcodes with different parameters. Just copy, paste, and display events anywhere on your site.
<ul>
<li>Shortcode:[events-calendar-templates category=”all” template=”default” style=”style-1″ date_format=”default” start_date=”” end_date=”” limit=”10″ order=”ASC” hide-venue=”no” time=”future” socialshare=”no”]</li>
</ul>
</li>
<li>Multiple Layouts: The events shortcode plugin offers a variety of layouts, such as List, Minimal, or Timeline layouts. You can select one according to your website’s design.</li>
<li>Pre-defined Styles: You can choose a predefined style for the selected layout according to your preferences.</li>
<li>Date Formats: Easily customize how dates are displayed by choosing from various formats. Whatever format you prefer, it will automatically be applied to the shortcode.</li>
<li>Event Type: Choose how you want your events to be displayed. Show upcoming events to highlight future opportunities, past events to showcase your achievements, or both for a complete overview.</li>
<li>Order & Sorting: You can sort events in ascending or descending order based on their dates to display the oldest or newest events.</li>
<li>Number of Events: Set a limit for how many events you want to display.</li>
<li>Filter Events: Use filters to display particular events by category.</li>
<li>Date-Based Event: Easily show events between specific dates. This means you can choose to showcase events between any dates, whether a particular week, month, or custom time period.</li>
<li>Compatibility with Elementor: Events Shortcode easily integrates with Elementor, allowing you to display your events effortlessly. You can add and customize events on your pages without any complex coding.</li>
<li>Fully Responsive: This plugin is fully responsive, ensuring that your events display perfectly on all screen sizes.</li>
</ul>
<h3>Upgrade to Pro Features</h3>
<ul>
<li>Filter events: Easily filter events by category, venue, or organizer.</li>
<li>Search & filter bar: Add a search and filter bar for improved navigation.</li>
<li>Advanced layouts: Access layouts such as Grid, Timeline, Carousel, Masonry, Accordion, and Calendar.</li>
</ul>
<a href="https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=events_shortcode_pro#pricing" rel="nofollow ugc">Upgrade to Pro</a>
<h3>More Addons For The Events Calendar</h3>
In addition to the Events Shortcodes plugin, there are more addons available to extend the features of The Events Calendar plugin:
<ul>
<li><a href="https://eventscalendaraddons.com/plugin/event-single-page-builder-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=epta_more_addons" rel="nofollow ugc">Events Single Page Builder Pro</a>– Design stunning single event pages with Elementor using pre-built templates and 20+ customizable widgets.</li>
<li><a href="https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=ectbe_more_addons" rel="nofollow ugc">Events Widgets Pro</a>– Show events list, grid, carousel, and more in Elementor pages using The Events Calendar Elementor Widgets.</li>
<li><a href="https://wordpress.org/plugins/events-calendar-modules-for-divi/" rel="ugc">Events Calendar Modules for Divi</a>– Display The Events Calendar Events directly inside Divi with Customizable List or Grid Layouts.</li>
</ul>
DISCLAIMER: Events Shortcode For The Events Calendar plugin is developed by the Cool Plugins team and is not affiliated with or developed by the official team of The Events Calendar plugin, which is a part of StellarWP, the software arm of Liquid Web. Some of the links in this content may be affiliate links, which means we may earn a commission at no extra cost to you if you purchase through these links.
<h3>✍ Special Thanks!</h3>
Special thanks to the famous <a href="https://theeventscalendar.pxf.io/plugin" rel="nofollow ugc">The Events Calendar ⇗</a> plugin authors for creating an awesome plugin for events management.

Events Shortcodes For The Events Calendar


This plugin is pretty self explanatory. The interface is simple and you won't break anything if you play around until you find the right settings for your calendar display. It's sort of the star of the plugins for "The Events Calendar" plugin addons provided by this developer.  Well done, @CoolPlugins!


Decent display of complex information

Easily add The Events Calendar shortcode or Gutenberg event block on any page and show upcoming events list.

Atomic Events Calendar vs Events Shortcodes For The Events Calendar