Lehel Mátyus

<p>Atomic Events Calendar is built for developers and agencies who need events in WordPress without the overhead of full event management plugins.</p>
<p>Instead of starting from scratch on every project, Atomic Events Calendar gives you:</p>
<p>– A ready-to-use <strong>Events post type</strong><br />
– Essential event fields (date, venue, type, etc.)<br />
– Developer-friendly <strong>shortcodes</strong> to display and filter events<br />
– A robust <strong>theming structure</strong> for easy overrides and custom designs</p>
<p>✨ Think of it as a lightweight <strong>framework disguised as a plugin</strong>: everything you need to set up events quickly, with the freedom to extend and customize as you like.</p>
<p>Perfect for agencies that want full control over their event implementations—without the bloat.</p>
<h3>Features</h3>
<ul>
<li><strong>Developer-Friendly</strong> – Clean code structure with services architecture</li>
<li><strong>Responsive Design</strong> – Built with Tailwind CSS for modern, responsive layouts</li>
<li><strong>Structured Data for Search Engines</strong> – Automatic JSON-LD schema markup for better SEO and rich snippets</li>
<li><strong>Custom Post Type</strong> – Dedicated ‘atomic-event’ post type with all necessary fields</li>
<li><strong>Template Override System</strong> – Easy theme integration with template hierarchy</li>
<li><strong>Shortcode Support</strong> – Display events anywhere with <code>[atomic-events]</code> shortcode</li>
<li><strong>Featured Events</strong> – Mark and display featured events prominently</li>
<li><strong>Location Management</strong> – Complete address fields (street, city, state, country, postcode)</li>
<li><strong>Date & Time Support</strong> – Start/end dates with time support</li>
<li><strong>Image Support</strong> – Featured images with captions</li>
<li><strong>Member-Only Events</strong> – Restrict events to members only</li>
<li><strong>Performance Caching</strong> – Automatic shortcode caching with smart invalidation</li>
</ul>
<p>Basic usage is through shortcode:</p>
<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>
<p>The plugin provides a default template for single events, but you can override it in your theme:</p>
<ol>
<li><strong>Child Theme</strong> (recommended): Copy the template to <code>child-theme/atomic-events/single/single-atomic-event.php</code></li>
<li><strong>Parent Theme</strong>: Copy the template to <code>parent-theme/atomic-events/single/single-atomic-event.php</code></li>
</ol>
<p>The plugin will automatically use your theme’s version instead of the default.</p>
<p>See the example template in <code>templates/theme-override-example.php</code> for reference.</p>
<h4>My event pages show 404 errors</h4>
<p>If you experience 404 errors when viewing event pages:<br />
1. Go to WordPress Admin <span aria-hidden="true" class="wp-exclude-emoji">→</span> Events <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings<br />
2. Click “Flush Rewrite Rules”<br />
3. If that doesn’t work, go to Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Permalinks and click “Save Changes”</p>
<h3>Template Structure</h3>
<p>The plugin provides a comprehensive template override system. You can override any template by creating files in your theme:</p>
<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>
<p>The plugin follows WordPress template hierarchy for single event pages. Templates are loaded in this order of priority:</p>
<ol>
<li><strong>Child Theme</strong>: <code>child-theme/atomic-events/single/single-atomic-event.php</code></li>
<li><strong>Parent Theme</strong>: <code>parent-theme/atomic-events/single/single-atomic-event.php</code></li>
<li><strong>Plugin Default</strong>: <code>plugin/templates/single/single-atomic-event.php</code></li>
</ol>
<h3>Template Override System</h3>
<p>The plugin uses a custom template loader that checks for theme templates first, then falls back to the plugin’s default template. This ensures:</p>
<p>– <strong>Theme compatibility</strong>: Works with any WordPress theme<br />
– <strong>Customization flexibility</strong>: Easy to override in themes<br />
– <strong>Update safety</strong>: Plugin updates won’t break custom templates<br />
– <strong>Developer-friendly</strong>: Clear hierarchy and fallback system</p>
<p><strong>Template Hierarchy Priority:</strong></p>
<ol>
<li><strong>Child Theme</strong>: <code>child-theme/atomic-events/[template-name].php</code></li>
<li><strong>Parent Theme</strong>: <code>parent-theme/atomic-events/[template-name].php</code></li>
<li><strong>Plugin Default</strong>: <code>plugin/templates/[template-name].php</code></li>
</ol>
<p><strong>Available Templates:</strong><br />
– <strong>Shortcode Templates</strong>: Override how events appear in lists and grids<br />
– <strong>Single Event Templates</strong>: Customize individual event page layouts<br />
– <strong>Content Templates</strong>: Modify event content display</p>
<p>The default template includes:<br />
– WordPress header/footer integration<br />
– Event model for accessing custom fields<br />
– Template loader for modular content parts<br />
– Proper WordPress loop structure</p>
<h3>Custom Fields Available</h3>
<p>When creating custom templates, you have access to these event fields:</p>
<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><strong>Copy the example template</strong> from <code>templates/theme-override-example.php</code></li>
<li><strong>Place it in your theme</strong> at the appropriate path</li>
<li><strong>Customize the template</strong> as needed</li>
<li><strong>Test thoroughly</strong> to ensure proper functionality</li>
</ol>
<h3>Hooks and Filters</h3>
<p>The plugin provides several hooks for customization:</p>
<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>
<p>The <code>[atomic-events]</code> shortcode supports these parameters:</p>
<p>– <code>filter</code>: “future” or “past” (default: “future”)<br />
– <code>max</code>: Maximum number of events (default: 20)<br />
– <code>columns</code>: Number of columns (default: 3)<br />
– <code>featured</code>: Show only featured events (true/false)<br />
– <code>skip_first_x</code>: Skip first X events<br />
– <code>skip_first_x_featured</code>: Skip first X featured events<br />
– <code>order</code>: “ASC” or “DESC” (default: “ASC”)</p>
<h3>Best Practices</h3>
<ol>
<li><strong>Always use child themes</strong> for customizations</li>
<li><strong>Test with different themes</strong> to ensure compatibility</li>
<li><strong>Use the event model</strong> for accessing custom fields</li>
<li><strong>Follow WordPress coding standards</strong></li>
<li><strong>Document custom modifications</strong></li>
<li><strong>Test thoroughly</strong> before deployment</li>
</ol>


Atomic Events Calendar

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

Joe Dolson

<p><a href="https://joedolson.com/my-calendar/" rel="nofollow ugc">My Calendar</a> offers easy-to-use WordPress event management with rich options for custom displays. Display individual event calendars in WordPress Multisite, offer multiple views of calendars limited by event categories, locations or author, or show simple text-based lists of your upcoming events.</p>
<h4>Rich Event Calendar Features</h4>
<p>You’ll find enormous design flexibility for your custom calendar. With recurring event support, design customization tools, custom templating, and category and venue support out of the box, My Calendar gives you a great feature set to get your calendar set up.</p>
<h4>Built with Accessibility in Mind</h4>
<p>My Calendar is an events calendar focused on holistic accessibility: providing a positive experience for site visitors and administrators who use assistive technology. It includes built-in settings where you can describe the ADA compliance features of your events and venues. Accessibility is a critical part of your website, so your audience can get equal access and experience to the events you list.</p>
<p>Learn about <a href="https://docs.joedolson.com/my-calendar/event-accessibility/" rel="nofollow ugc">accessible events</a> or <a href="https://demos.joedolson.com/my-calendar/" rel="nofollow ugc">visit the My Calendar demo</a></p>
<h4>Accessibility-first Software</h4>
<p>While My Calendar has a strong focus on backwards compatibility, it is officially built with an accessibility first mindset. That means that if a choice has to be made between improving accessibility and breaking backwards compatibility, the more accessible choice will always come first.</p>
<h4>Premium Event Management</h4>
<p>Looking for more? <a href="https://www.joedolson.com/my-calendar/pro/" rel="nofollow ugc">Buy My Calendar Pro</a>, the premium extension for My Calendar.</p>
<p>My Calendar Pro adds tons of great additional features:</p>
<ul>
<li>Support for user-submitted events,</li>
<li>Custom field creation and management,</li>
<li>integration between posting and event creation,</li>
<li>Import events from outside sources, and</li>
<li>support for sharing events between multiple sites.</li>
</ul>
<h4>Sell Event Tickets</h4>
<p>Do you sell tickets for your events? <a href="https://wordpress.org/plugins/my-tickets/" rel="ugc">Use My Tickets</a> and sell tickets for My Calendar events. Set prices, ticket availability, and sell multiple events at the same time using My Tickets.</p>
<h4>Features:</h4>
<ul>
<li>Calendar grid, card, and list views of events</li>
<li>Month, multi-month, week, or daily view.</li>
<li>Mini-calendar for compact displays (as widget or shortcode)</li>
<li>Widgets: today’s events, upcoming events, mini calendar, event search</li>
<li>Customize templates for event output</li>
<li>Limit views by categories, location, author, or host</li>
<li>Extensive support for recurring events.</li>
<li>Edit or add single dates in recurring events</li>
<li>Rich permissions handling to restrict access to parts of My Calendar</li>
<li>Email notifications when events are scheduled or drafted</li>
<li>Post to X, Bluesky, or Mastodon when events are created (using <a href="https://wordpress.org/plugins/wp-to-twitter/" rel="ugc">XPoster</a>)</li>
<li>Event location management</li>
<li>Fetch events from a remote database. (Sharing events in a network of sites.)</li>
<li>Multisite-friendly</li>
<li>Integrated help page</li>
<li>Shortcode Generator to create customized views of My Calendar</li>
<li>SEO with JSON-LD structured data for events and venues.</li>
<li>Export or subscribe via iCal or Google Calendar.</li>
<li>Completely responsive events views</li>
<li>Extensive <a href="https://docs.joedolson.com/my-calendar/" rel="nofollow ugc">public documentation</a>.</li>
<li>Hundreds of <a href="https://joedolson.github.io/my-calendar/" rel="nofollow ugc">actions and filters for custom development</a></li>
</ul>
<h4>Accessibility</h4>
<p>My Calendar is designed with accessibility in mind. All interfaces – both front and back end – are tested with various assistive technology.</p>
<p>The plugin includes features for showing the accessibility services available for events and at physical venues, as well as providing access to your event information for users with disabilities.</p>
<h4>What’s in My Calendar Pro?</h4>
<ul>
<li>Let your site visitors submit events to your site (pay to post or free!).</li>
<li>Let logged-in users edit their events from the front-end.</li>
<li>Custom field creator</li>
<li>Create events when you publish a blog post</li>
<li>Publish a blog post when you create an event</li>
<li>Advanced search features</li>
<li>Import events from .ics or .csv formats via file or URL.</li>
<li>REST API support for sharing events between multiple sites.</li>
</ul>
<h4>Translations</h4>
<p>Visit <a href="https://translate.wordpress.org/projects/wp-plugins/my-calendar" rel="nofollow ugc">WordPress Translations</a> to check progress or contribute to your language.</p>
<p>Translating my plugins is always appreciated. Visit <a href="https://translate.wordpress.org/projects/wp-plugins/my-calendar" rel="nofollow ugc">WordPress translations</a> to help get your language to 100%!</p>


My Calendar – Accessible Event Manager

Great plugin - I tried many calendars for my class schedule and this was the only one that WORKED! I love all the detailed setup options for developers, with the ability to change text and colors. Haven't played with the templates yet but I'm excited to do so. 

Had an issue and developer was super-responsive, resolving it and fixing with care. Thank you!

Finally - A Robust Calendar that WORKS!


This is a great plugin! I have used this on many different kinds of sites and after several years there has yet to be a problem I have to solve with a calendar that this plugin cannot handle!


Great Plugin for Everything

Accessible WordPress event calendar plugin. Manage single or recurring events, event venues, and display your calendar anywhere on your site.

Atomic Events Calendar vs My Calendar – Accessible Event Manager