Á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.

Timely Calendar Team

The <a href="https://time.ly/solutions/all-in-one-event-calendar-wordpress-plugin/" rel="nofollow ugc">Timely All-in-One Events Calendar</a> is a FREE events calendar plugin, trusted by 150,000+ event creators around the globe, including Mastercard, AT&T, Adobe, Stanford University, the University of Bristol, and the California State government.
It allows you to easily create, manage and share your events with the rest of the world, whether they are in-person, virtual or hybrid.
<iframe loading="lazy" title="Timely All-in-One Event Calendar WordPress Plugin" width="750" height="422" src="https://www.youtube.com/embed/Nb7y_GsaQjQ?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>
<h4>🗓️ The Best Events Calendar WP Plugin</h4>
Our events calendar plugin is the most advanced website calendar system available for WordPress. It was created with the latest technology, and combines a beautiful and modern design with a powerful set of features.
Our plugin is known in the WP community for its great UI/UX and attractive visuals. In addition, it has built-in RSVP and ticketing features so you can collect registrations and sell tickets directly from your calendar. Timely is considered by experts as one of the most advanced WP calendar plugins available in the market.
Besides being fully customizable and extremely easy to use, Timely’s plugin is 100% mobile responsive, and accessible for the community with disabilities.
…all WITHOUT needing a coder or designer…saving you time and money.
<h4>❤️ The Events Calendar Most Loved by Event Creators Around the World</h4>
Timely’s <a href="https://time.ly/solutions/all-in-one-event-calendar-wordpress-plugin/" rel="nofollow ugc">All-in-One Event Calendar</a> is made for freelancers and solo entrepreneurs, who are looking for a free but powerful event calendar to start or power up their event-related business.
If you are an event planner or event manager, and work for a small, medium or large organization that needs more sophisticated event management tools, check out our <a href="https://time.ly/solutions/event-calendar-software/" rel="nofollow ugc">Event Calendar Software</a>, our <a href="https://time.ly/event-management-software-features/" rel="nofollow ugc">enterprise level features</a>, and <a href="https://time.ly/pricing/" rel="nofollow ugc">paid plans</a>.
<h4>🌟 Features</h4>
Our free events calendar plugin is feature-rich. Download the plugin and get all the following features for FREE:
<ul>
<li>Beautiful and attractive event calendar for your website.</li>
<li>Several out of the box calendar themes for you to choose from.</li>
<li>Customize your theme, colours and fonts to personalize your calendar appearance to match your brand and style, as well as header, footer and CSS.</li>
<li>Display your public calendar on week, month or agenda views. Additional calendar views available on paid plans.</li>
<li>Setup different views for calendar on mobile and on desktop.</li>
<li>Easy event creation and publishing.</li>
<li>Create in-person, virtual and hybrid events.</li>
<li>Single day, multiple days, all day events.</li>
<li>Recurring events, including complex patterns.</li>
<li>Duplicate events with ease.</li>
<li>Set the timezone of your events, and display it on either yours or your website visitors’ timezone.</li>
<li>Event venue and organizer tag system. Add multiple event organizers to your events.</li>
<li>Search box to search for events by keyword, as well as by date, month and year.</li>
<li>Filtering events by categories, tags, organizers and venues. Custom filters available on paid plans.</li>
<li>Colour-coded events based on category.</li>
<li>Media library to facilitate media upload.</li>
<li>Featured event images and category images.</li>
<li>Allow or disallow your audience to subscribe to your calendar.</li>
<li>Easy importing events using CSV or ICS files. Additional calendar import options available on paid plans.</li>
<li>Social share buttons, so your audience can share events directly from your calendar.</li>
<li>Calendar and events are SEO-optimized, Event Schema ready and with Good Web Core Vitals.</li>
<li>Your calendar can be embedded into a WordPress page without needing to create template files or modify the theme.</li>
<li>Collect event registrations (RSVP) or sell event tickets directly from your event calendar, with a pay per use charge.</li>
<li>Free support via written documentation and video tutorials available on our <a href="https://help.time.ly/" rel="nofollow ugc">Help Center</a>.</li>
</ul>
Timely is a <a href="https://time.ly/blog/cloud-vs-on-premise-pros-and-cons-for-event-platforms/" rel="nofollow ugc">cloud-based solution</a>, so you can do all this and more without sacrificing your website storage space or performance.
What are you waiting for? Download <a href="https://time.ly/solutions/all-in-one-event-calendar-wordpress-plugin/" rel="nofollow ugc">Timely All-in-One Event Calendar Plugin</a> now and sign up for a free account!
<h4>🌐 Languages</h4>
Timely’s application dashboard has been translated into the following languages (in alphabetical order): Dutch | English | French | German | Italian | Norwegian | Portuguese (BR) | Portuguese (PT) | Spanish
Timely’s events calendar public interface has been translated into the following languages(in alphabetical order): Arabic | Chinese | Danish | Dutch | English (UK) | English (US) | French | German | Italian | Japanese | Korean | Norwegian | Polish | Portuguese(BR) | Portuguese (PT) | Spanish | Turkish | Swedish | Vietnamese. Other languages are available upon request.
<h4>💁🏼‍♀️ Service</h4>
The <a href="https://time.ly/solutions/all-in-one-event-calendar-wordpress-plugin/" rel="nofollow ugc">All-in-One Event Calendar</a> is a SaaS service provided by <a href="https://time.ly/" rel="nofollow ugc">Time.ly</a>. After installing the plugin, you will need to create and activate a Timely free account in order to use it.
While free accounts are free, we may require you to input your credit card details in order to create an account with us. This request is mainly aimed at preventing spam registrations and verifying your authenticity. Moreover, providing your credit card upfront allows you to utilize our integrated event registration and ticketing system, if you wish to do so. Please note that the use of our integrated event registration and ticketing system is subject to <a href="https://time.ly/legal/ticketing-terms-of-service/" rel="nofollow ugc">Timely Ticketing Terms of Service</a>. This particular Service is not provided free of charge, and fees are based on usage. Therefore, if you choose not to use our registration or ticketing system, no charges will be imposed. Currently, we charge 2.5% + US$ 0.90 per registration or ticket sold (fees are paid by ticket buyers, unless you choose to cover them).
If you are looking for more advanced features, like more calendar view options, more importing events functionalities, integrated event submission form, and social media integrations, check our <a href="https://time.ly/event-management-software-features" rel="nofollow ugc">feature list</a> and consider upgrading to one of our <a href="https://time.ly/pricing/" rel="nofollow ugc">premium paid plans</a>.
<h4>🤓 Some Geeky Facts</h4>
<ul>
<li>Responsive and works perfectly on all devices (desktop, laptop, tablet and mobile).</li>
<li>Compatible with major web-browsers (Chrome, Safari, iOS, Android, Edge, Firefox and Internet Explorer v.11).</li>
<li>Accessible for individuals with disabilities (Section 508 and WCAG 2.1 AA Level compliant)</li>
<li>Average uptime is 99.5%</li>
<li>HTML5 dashboard</li>
<li>Available short-code</li>
</ul>
<h4>📒 Read More</h4>
Want more information on Timely’s events calendar WordPress plugin? Have a look at:
<ul>
<li>Timely <a href="https://time.ly/demo/" rel="nofollow ugc">Demo Events Calendar</a></li>
<li>Timely Official <a href="https://time.ly/" rel="nofollow ugc">Homepage</a></li>
<li>Timely <a href="https://help.time.ly/event-management/" rel="nofollow ugc">Help Center</a></li>
<li>Timely <a href="https://help.time.ly/ems-video-tutorials/" rel="nofollow ugc">Video Tutorials</a></li>
<li>Timely <a href="https://time.ly/why-timely/customer-testimonials/" rel="nofollow ugc">Reviews and Customer Testimonials</a></li>
<li>Timely <a href="https://time.ly/blog/category/case-study/" rel="nofollow ugc">Case Studies</a></li>
<li>Timely <a href="https://time.ly/newsroom/" rel="nofollow ugc">Press Mentions</a></li>
<li>Timely <a href="https://time.ly/blog/" rel="nofollow ugc">Event Management Blog</a></li>
<li>Also follow Timely on <a href="https://www.linkedin.com/company/timely/" rel="nofollow ugc">LinkedIn</a>, <a href="https://www.facebook.com/timely.network" rel="nofollow ugc">Facebook</a> and <a href="https://twitter.com/_timely" rel="nofollow ugc">Twitter</a>.</li>
</ul>
Please note that we DO NOT provide live support to free users. Free WordPress calendar plugin users are only supported with self service user documentation and video tutorials that can be found on our <a href="https://help.time.ly/" rel="nofollow ugc">Help Center</a>. You can also check the <a href="https://wordpress.org/support/plugin/all-in-one-event-calendar/" rel="ugc">All-in-One Event Calendar forum here on WordPress.org</a>, which is the place where community members help one another.
If you need official customer support from us, consider upgrading to a <a href="https://time.ly/pricing/" rel="nofollow ugc">paid plan</a>.
Please note that we no longer support Timely’s WP events calendar version 3.0.0 (old platform), 2.6.8 or older (deprecated / superseded). If you are having issues with these versions, we recommend migrating to the new platform by downloading and installing the plugin again. Do not forget to create a back up of your WP installation database before doing that.
Still have questions about our event management software solutions? Please <a href="https://time.ly/contact/" rel="nofollow ugc">contact us</a>.
<h4>⚖️ Legal</h4>
By creating or activating an account and/or embedding the code into a website, you agree to Timely’s <a href="https://time.ly/terms-of-service/" rel="nofollow ugc">Terms of Service</a> and policies. Please note that to provide you with our services, we sometimes send you service announcements and other information.
To learn more about what personal data we collect from you and how we use it, please check our <a href="https://time.ly/privacy-policy/" rel="nofollow ugc">Privacy Policy</a>.

Timely All-in-One Events Calendar


stay away for now. the plugin is not compatible with php 8.1 and produces tons of warnings and errors


not compatible with php 8.1

Timely All-in-One Events Calendar is a free WordPress plugin trusted by 150,000+ event creators worldwide. Easily create, manage and share events.

Atomic Events Calendar vs Timely All-in-One Events Calendar