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.

JasonDugmore

EtienneS

Robiin

FooEvents

colin82

lidias

The Events Calendar by FooEvents is the simplest way to display any post, page or custom post type in a dynamic events calendar on your WordPress website. Whether you use a third-party events plugin, list events using posts, or create landing pages for each event using your favorite page builder, the Events Calendar by FooEvents makes it possible to display any event in an events calendar on your website.
<a href="https://demo.fooevents.com/standalone-calendar/?ref=calendar" rel="nofollow ugc">Try the live demo</a>
<h3>📅 How it Works</h3>
Simply enable the event features on a post, page or custom post type and set the date and time of the event. Any post, page, or custom post type that is enabled as an event will then display in your events calendar. This unique and flexible approach means that almost any post type can be treated as an event and displayed in an events calendar. This gives you complete flexibility to create events using custom code, a third-party events plugin, or simply create a custom event page using your favorite page builder and display it in the calendar.
Adding the events calendar to the front-end of your website is done using a simple events calendar shortcode or events calendar widget. Both the events calendar shortcode and events calendar widgets include various options that can be configured to determine which posts, pages or custom post types are displayed in the calendar.
<h3>✨ Features</h3>
<ul>
<li>Add event details to any post, page or custom post type and display these items in an events calendar.</li>
<li>Add an events calendar on any page with the events calendar shortcode or events calendar widget. The shortcode seamlessly integrates with most page builders and only takes a few seconds to add.</li>
<li>Click on an event displayed in the calendar and proceed to the relevant post or page.</li>
<li>Display multiple events calendars on a single page using multiple shortcodes. All you need to do is make sure that each shortcode has a different ID.</li>
<li>In addition to the traditional events calendar view, you can also display events in a list format. You can set the list view to filter the events by day, week, month or year.</li>
<li>When configuring an event, you can set the background and text color of the event label that is displayed in the events calendar view. For the list view, a colored dot will appear next to the event’s name.</li>
<li>By default, the events calendar shortcode will display the current month by default, however, you can set the events calendar to load a specific future or past date.</li>
<li>Set the event calendar to start the week on either Monday or Sunday based on what suits you best.</li>
<li>Specify the number of events to display in both the events calendar and list views.</li>
<li>The time format is adjustable, allowing you to present it as per your preference.</li>
<li>Configure the time format to display based on your preference.</li>
<li>Set the events calendar to hide weekends if your events only take place during the week.</li>
<li>Set the events calendar to only show specific events or posts using their ID’s.</li>
<li>Change the look of your events calendar using our built-in events calendar themes.</li>
<li>Works with almost any WordPress theme.</li>
<li>Integrates perfectly with the <a href="https://www.fooevents.com" rel="nofollow ugc">FooEvents for WooCommerce</a> plugin making it possible to also sell tickets and bookable services.</li>
</ul>
<h3>⚡ Use Cases</h3>
<ul>
<li>School activity events calendar: Display school-related activities in an events calendar on your school website. This is perfect for students, teachers, and parents to stay up to date with important dates, holidays, activities, shows, sporting events etc.</li>
<li>Company events calendar: Inform employees and stakeholders about internal events, training sessions, product launch dates, wellness activities, company holidays, and corporate milestones.</li>
<li>Meetups: Organize informal gatherings or groups with shared interests and display upcoming meetings, topics, and locations in an events calendar.</li>
<li>Community Center: Showcasing events, classes, workshops, and gatherings taking place at the community center.</li>
<li>Activities events calendar: Often used by restaurants, resorts, cruise ships or holiday destinations to inform guests of daily or weekly activities, shows or available excursions.</li>
<li>Event Management: Promoters, venues or organizations can showcase upcoming events like concerts, webinars, or workshops. Users can view event details and book tickets when used together with the <a href="https://www.fooevents.com" rel="nofollow ugc">FooEvents for WooCommerce</a> plugin.</li>
<li>Recreational clubs: Sports and recreation clubs can display training sessions, matches, and other club-related events for members in an events calendar.</li>
<li>Community or local government: Publicizing community events, town hall meetings, trash collection days or other important local dates in an events calendar.</li>
<li>Holiday special events calendar: Retailers or e-commerce sites can use an events calendar to highlight special sales, promotions, or product launches aligned with specific dates or holidays.</li>
<li>Health & fitness: Gyms or health clubs can list fitness classes, sessions with personal trainers or special wellness events in an events calendar on their website.</li>
<li>Cultural & religious groups: Places of worship or cultural organizations can post schedules for religious ceremonies, festivals, and cultural events relevant to their community on their website using the events calendar.</li>
</ul>
<h3>🎟️ Sell Tickets and Bookable Services</h3>
The Events Calendar by FooEvents is also fully compatible with the <a href="https://www.fooevents.com" rel="nofollow ugc">FooEvents for WooCommerce</a> plugin which makes it possible to sell branded tickets to more advanced events such as multi-day events and bookable services.
FooEvents offers many <a href="https://www.fooevents.com/features/" rel="nofollow ugc">advanced features</a> that add event management functionality to your website including <a href="https://www.fooevents.com/ticket-themes/" rel="nofollow ugc">free ticket themes</a> and a <a href="https://www.fooevents.com/apps/" rel="nofollow ugc">free check-ins app</a>.
<ul>
<li><a href="https://www.fooevents.com/products/fooevents-for-woocommerce/" rel="nofollow ugc">FooEvents for WooCommerce (core plugin)</a>: Sell tickets with no commission or ticket fees and manage free registration for practically any type of physical or virtual event such as a concert, class, conference, tour, webinar, fundraiser or sports fixture. </li>
<li><a href="https://www.fooevents.com/products/fooevents-bookings/" rel="nofollow ugc">FooEvents Bookings</a>: Sell access to bookable events, venues, classes and services. Let your customers check availability on your website and book a space or slot. No phone calls or emails, 100% self-service. The Events Calendar by FooEvents plugin integrates seamlessly with FooEvents Bookings. Each bookable slot is displayed in the calendar and can be selected when clicked.</li>
<li><a href="https://www.fooevents.com/products/fooevents-pdf-tickets/" rel="nofollow ugc">FooEvents PDF Tickets</a>: Attach event tickets or confirmations as PDF files to the email that is sent to the attendee or ticket purchaser.</li>
<li><a href="https://www.fooevents.com/products/fooevents-custom-attendee-fields/" rel="nofollow ugc">FooEvents Custom Attendee Fields</a>: Capture customized attendee fields at checkout so you can tailor FooEvents according to your unique event requirements. This is useful for acquiring additional information from attendees such as clothing sizes, meal preferences, demographic information, waiver acceptance etc.</li>
<li><a href="https://www.fooevents.com/products/fooevents-multi-day/" rel="nofollow ugc">FooEvents Multi-day</a>: The FooEvents Multi-day plugin is an extension for FooEvents that lets you sell tickets to events that run over multiple calendar or sequential days. This is an essential plugin if you have an event that runs longer than a day or single session and requires multiple check-ins for each attendee. When installed, the FooEvents Multi-day plugin will also add multi-day capabilities to posts, pages and custom post types.</li>
<li><a href="https://www.fooevents.com/products/fooevents-seating/" rel="nofollow ugc">FooEvents Seating</a>: The FooEvents Seating plugin is an extension for FooEvents that allows your guests or attendees to select their seats at checkout based on the layout of your venue. This plugin can be used to specify rows and seats in a conference room or theater, tables and the number of chairs at the table etc. You can create VIP sections or restrict attendees to seats in other higher or lower tiered areas.</li>
<li><a href="https://www.fooevents.com/products/fooevents-express-check-in/" rel="nofollow ugc">FooEvents Express Check-in</a>: The FooEvents Express Check-in plugin is an extension for FooEvents that makes checking in and managing attendees at your event a fast and effortless process. The intuitive interface allows you to search for attendees in a matter of seconds or you can connect a Bluetooth or USB barcode scanner to your computer in order to scan tickets instead of typing. You also have the option of automatically checking in attendees to further speed up the process.</li>
<li><a href="https://www.fooevents.com/features/apps/" rel="nofollow ugc">Check-ins App</a>: There’s no need to struggle with clumsy spreadsheets or kill trees when you can manage event check-ins with our free, easy to use iOS and Android apps. The FooEvents Check-ins app gives you the tools to manage access to your event like a pro and it even works in offline mode and supports 15 different languages!</li>
<li><a href="https://www.fooevents.com/products/ticket-themes/" rel="nofollow ugc">FooEvents Ticket Themes</a>: Transform the appearance of your tickets and make your event stand out with our FREE Ticket Themes. If you have some basic coding knowledge, the Starter Theme can be used as a template to design your own tickets from scratch.</li>
</ul>
<h3>🔌 Integrations</h3>
Straight out of the box, the Events Calendar by FooEvents can be used by any third-party plugin that creates events using a custom post type. All you need to do is head to the Events Calendar by FooEvents settings and add the custom post type as a supported event post type.
<h3>Documentation and Support</h3>
The most current documentation for the Events Calendar by FooEvents plugin can be found in the <a href="https://help.fooevents.com/docs/topics/fooevents-plugins/fooevents-calendar/" rel="nofollow ugc">FooEvents Help Center</a>.
You can also purchase a <a href="https://www.fooevents.com/products/fooevents-calendar/" rel="nofollow ugc">support package</a> for the Events Calendar by FooEvents plugin should you require any technical support.

Events Calendar by FooEvents


A few months ago, I had the distinct pleasure of encountering your esteemed plugin during my company's endeavors to identify and test better alternatives to our existing event plugins, with a view to enhancing the management of our client's sites.



I feel compelled to share that this plugin has, without any shadow of a doubt, become my definitive preference. Its polished code, flexibility, and admirable absence of unnecessary elements have left me quite impressed.



I can, with confidence, say it stands unmatched to any other solution I have had the opportunity to review until the present day.


Premier Event Management Plugin

The simplest way to display any post, page or custom post type in a dynamic events calendar on your WordPress website.

Atomic Events Calendar vs Events Calendar by FooEvents