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.

AyeCode

Paolo

Stiofan

The Events Calendar add-on for <a href="https://wordpress.org/plugins/geodirectory/" title="Best Directory Plugin for WordPress" rel="ugc">GeoDirectory</a> is a compelling way to feature events on your directory, using Custom Post Types (CPT). This events calendar plugin creates the CPT Events, by adding time and date to a standard listing. Users can now choose to list a place or an event.
<h4>Recurring Events Included</h4>
Do you host the same event every day, or every second week, or every 3 months, or once every 4 years? The Events Calendar for GeoDirectory has your back!
You can set events as recurring type daily, weekly, monthly, yearly and even pick custom dates. 
The recurring interval can be from 1 to 30.
So if you select type weekly and interval 2, the events will happen every 2 weeks.
<h4>Events Custom Fields</h4>
Add unlimited custom fields to your events out of the box with our add event form builder.
<h4>Events Calendar Widgets, Shortcodes or Blocks</h4>
It’s easy to sort events by selecting “upcoming,” “today,” “past” or “all” and display custom events lists, grids and a simple events calendar anywhere using Widgets, Shortcodes or Blocks. By default, events are ordered with the upcoming event first.
<h4>Events Locator</h4>
The Events Calendar for GeoDirectory is a full-featured Events Locator too. Events are easily displayed on a map, allowing user to locate your events with ease. Easily show distance from them and driving directions.
<h4>Premium add-ons</h4>
<ul>
<li><a href="https://wpgeodirectory.com/downloads/location-manager/" title="Allows to create a global directory" rel="nofollow ugc">SEO Location Manager</a> – Create a global Events Directory with unique pages for Countries, Regions, Cities, and Neighbourhoods. Also create an an events calendar of virtual Events without a physical address.</li>
<li><a href="https://wpgeodirectory.com/downloads/pricing-manager/" title="Allows to monetize your Events" rel="nofollow ugc">Pricing Manager</a> – Set prices for the Events Submission on your Events Calendar & Directory. Enable/disable features per price. It uses our free <a href="https://wordpress.org/plugins/invoicing/" title="GetPaid plugin for WordPress" rel="ugc">GetPaid Plugin</a> to manage payments, taxes, and invoices.</li>
<li><a href="https://wpgeodirectory.com/downloads/custom-post-types/" title="Allows to extend your directory categorization" rel="nofollow ugc">Custom Post Types</a> – Create unlimited events custom post type, each with its own custom fields, prices and more.</li>
<li><a href="https://wpgeodirectory.com/downloads/multiratings-and-reviews/" title="Allows you to extend your rating and reviews categorization" rel="nofollow ugc">MultiRatings and Reviews</a> – Extend the review system allowing multiple rating categories (e.g., service, quality, price), add images to reviews and other cool features.</li>
<li><a href="https://wpgeodirectory.com/downloads/advanced-search-filters/" title="Allows you to extended search with custom filters" rel="nofollow ugc">Advance search filters</a> – Turns any Events custom field into an advance filter of the search widget. Adds smart autocompletes, geolocation, and much more. Search Events by date.</li>
<li><a href="https://wpgeodirectory.com/downloads/buddypress-integration/" title="integrates Buddypress with The events Calendar for GeoDirectory" rel="nofollow ugc">Buddypress Integration</a> – Smoothly integrates The events Calendar for GeoDirectory with Buddypress.</li>
<li><a href="https://wpgeodirectory.com/downloads/claim-manager/" title="Allows users to claim their Events" rel="nofollow ugc">Claim Listing Manager</a> – Allow events owners to claim existing listings about their events and fine-tune them. Add/edit images, link to places (venues) and show an ‘owner-verified’ badge on the listing. Now with force upgrade/paid option.</li>
<li><a href="https://wpgeodirectory.com/downloads/marker-cluster/" title="To avoid overcrowded maps" rel="nofollow ugc">Marker Cluster</a> – Avoid cluttered maps by using numbered markers at high zoom levels. Now with super fast server-side clustering!</li>
<li><a href="https://wpgeodirectory.com/downloads/ajax-duplicate-alert/" title="Events already exists?" rel="nofollow ugc">Duplicate alert</a> – Alert users when they add an event with the same title (or other details) as another event.</li>
<li><a href="https://wpgeodirectory.com/downloads/custom-google-maps/" title="Customize your maps look and feel" rel="nofollow ugc">Custom Map Styles</a> – Modify the look and feel of all Maps widgets via an intuitive user interface, with color pickers and simple-to-use options.</li>
<li><a href="https://wpgeodirectory.com/downloads/social-importer/" title="Import 1 Event at a time from Facebook!" rel="nofollow ugc">Social Importer</a> – Import events from Facebook. One listing at a time, no bulk scraping.</li>
<li><a href="https://wpgeodirectory.com/downloads/gd-recaptcha/" title="Stop spammers!" rel="nofollow ugc">GD reCAPTCHA</a> – Banish spam by adding the No CAPTCHA reCAPTCHA widget to any GeoDirectory form.</li>
<li><a href="https://wpgeodirectory.com/downloads/franchise-manager/" title="Franchise Manager" rel="nofollow ugc">Franchise Manager</a> – Allows users to submit Events that span into multiple locations.</li>
<li><a href="https://wpgeodirectory.com/downloads/list-manager/" title="List Manager" rel="nofollow ugc">List Manager</a> – Allows users to create their lists of events and make them public to other users.</li>
<li><a href="https://wpgeodirectory.com/downloads/wp-all-import/" title="WP All Import" rel="nofollow ugc">WP All Import</a> – Use the power of WP All Import to import your listings from anywhere with this add-on that integrates Wp All Import with The Events Calendar for GeoDirectory</li>
<li><a href="https://wpgeodirectory.com/downloads/embeddable-ratings-badge/" title="Embeddable Ratings Badge" rel="nofollow ugc">Embeddable Ratings Badge</a> – Let users embed their Events info with current ratings on their site, styled the way they want.</li>
<li><a href="https://wpgeodirectory.com/downloads/compare-listings/" title="Compare Listings" rel="nofollow ugc">Compare Listings</a> – Let your users compare Events side by side and compare vital info about the Events.</li>
</ul>
<h4>Go Pro – Become a member!</h4>
Get your hands on all the Events Calendar for GeoDirectory premium add-ons and themes. Sign up at <a href="https://wpgeodirectory.com/downloads/membership/" title="Get GeoDirectory membership." rel="nofollow ugc">wpgeodirectory.com</a>.

Events Calendar for GeoDirectory

Events Calendar add-on for GeoDirectory  allows to extend your GeoDirectory powered website with a versatile event manager.

Atomic Events Calendar vs Events Calendar for GeoDirectory