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

Bastien Ho

NOUS Open Usefull &amp; Simple

leroysabrina

unecologeek

Adds some meta-data to posts to convert them into full calendar events. 
Each event can be exported into ical(.ics), outlook(vcs), or Google Calendar. 
Geolocation works thanks to openstreetmap.

It can also fetch the weather, but doesn’t bring the sun 🙂

Follow <a href="https://twitter.com/wpeventpost" rel="nofollow ugc">@wpeventpost</a> on Twitter for latest news.

Examples on <a href="https://event-post.com/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp.org" rel="nofollow ugc">event-post.com</a>

<h3>Post metas</h3>

Date attributes

<ul>
<li>Begin Date</li>
<li>End Date</li>
<li>Color</li>
<li>Event Status</li>
<li>Event Attendance Mode</li>
</ul>

Location attributes

<ul>
<li>Address</li>
<li>GPS coordinates</li>
<li>Event Virtual Location</li>
</ul>

WooCommerce compliant

You can enable event features on Woocommerce products. The event will be displayed on the product page. Moreover, the product price will be displayed in event list, calendar, map and timeline.

This, way, you can sell tickets for your events, effortlessly and without any additional plugin.

Weather attribute (for a given location and date if possible)

<ul>
<li>Weather

<ul>
<li>Temperature</li>
<li>Weather</li>
</ul></li>
</ul>

<h3>Usage</h3>

<a href="https://event-post.com/docs/event-post/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp.org" rel="nofollow ugc">Plugins/themes developpers documentation</a>

<h3>Blocks & Shortcodes</h3>

The plugin comes with several blocks/shortcodes which allows to:

<ul>
<li><code>[events_list]</code>: display a list of events</li>
<li><code>[events_map]</code>: display a map of events</li>
<li><code>[events_cal]</code>: display a calendar of events</li>
<li><code>[event_details]</code>: display a detail of the current event</li>
<li><code>[event_term]</code>: display the date range of a given term based on all events it contains</li>
</ul>

<h3>[events_list]</h3>

<h4>Query parameters</h4>

<ul>
<li>nb=5 (number of post, -1 is all, default: 5)</li>
<li>future=1 (boolean, retrieve, or not, events in the future, default = 1)</li>
<li>past=0 (boolean, retrieve, or not, events in the past, default = 0)</li>
<li>cat=” (string, select posts only from the selected category, default=null, for all categories)</li>
<li>tag=” (string, select posts only from the selected tag, default=null, for all tags)</li>
<li>tax_name=” (string, custom taxonomy name)</li>
<li>tax_term=” (string, the term for above taxonomy)</li>
<li>geo=0 (boolean, retreives or not, only events which have geolocation informations, default=0)</li>
<li>order=”ASC” (string (can be “ASC” or “DESC”)</li>
<li>orderby=”meta_value” (string (if set to “meta_value” events are sorted by event date, possible values are native posts fields : “post_title”,”post_date” etc…)</li>
</ul>

<h4>Display parameters</h4>

<ul>
<li>thumbnail=” (Bool, default:false, used to display posts thumbnails)</li>
<li>thumbnail_size=” (String, default:”thmbnail”, can be set to any existing size : “medium”,”large”,”full” etc…)</li>
<li>excerpt=” (Bool, default:false, used to display posts excerpts)</li>
<li>style=” (String, add some inline CSS to the list wrapper)</li>
<li>type=”div” (string, possible values are : div, ul, ol default=div)</li>
<li>title=” (string, hidden if no events is found)</li>
<li>before_title='<h3>’ (string (default <h3>)</li>
<li>after_title='</h3>’ (string (default </h3>)</li>
<li>container_schema=” (string html schema to display list)</li>
<li>item_schema=” (string html schema to display item)</li>
</ul>

example:

<pre><code>

[events_list future=1 past=1 cat="actuality" nb=10]
</code></pre>

container_schema default value:

<blockquote>
 <%type% class=”event_loop %id% %class%” id=”%listid%” style=”%style%” %attributes%> 
 %list% 
 </%type%>
</blockquote>

item_schema default value:

<blockquote>
 <%child% class=”event_item %class%” data-color=”%color%”> 
 <a href=”%event_link%”> 
 %event_thumbnail% 
 <h5>%event_title%</h5> 
 </a> 
 %event_date% 
 %event_cat% 
 %event_location% 
 %event_excerpt% 
 </%child%>
</blockquote>

<h3>[events_map]</h3>

<ul>
<li>nb=5 (number of post, -1 is all, default: 5)</li>
<li>future=1 (boolean, retreive, or not, events in the future, default = 1)</li>
<li>past=0 (boolean, retreive, or not, events in the past, default = 0)</li>
<li>cat=” (string, select posts only from the selected category, default=null, for all categories)</li>
<li>tag=” (string, select posts only from the selected tag, default=null, for all tags)</li>
<li>tax_name=” (string, custom taxonomy name)</li>
<li>tax_term=” (string, the term for above taxonomy)</li>
<li>tile=” (string (default@osm.org, OpenCycleMap, mapquest, osmfr, 2u, satelite, toner), sets the map background, default=default@osm.org)</li>
<li>title=” (string (default)</li>
<li>zoom=” (number or empty (default, means fit to points)</li>
<li>before_title='<h3>’; (string (default <h3>)</li>
<li>after_title='</h3>’ *(string (default </h3>)**</li>
<li>thumbnail=” * (Bool, default:false, used to display posts thumbnails)*</li>
<li>excerpt=” (Bool, default:false, used to display posts excerpts)</li>
<li>list=” (String (“false”, “above”, “below”, “right”, “left”) default: “false”, Display a list of posts)</li>
</ul>

example:

<pre><code>

[events_map future=1 past=1 cat="actuality" nb="-1"]
</code></pre>

<h3>[events_cal]</h3>

<ul>
<li>cat=” (string, select posts only from the selected category, default=null, for all categories)</li>
<li>date=” (string, date for a month. Absolutly : 2013-9 or relatively : -1 month, default is empty, current month</li>
<li>datepicker=1 (boolean, displays or not a date picker)</li>
<li>mondayfirst=0 (boolean, weeks start on monday, default is 0 (sunday)</li>
<li>display_title=0 (boolean, displays or not events title under the day number)</li>
<li>tax_name=” (string, custom taxonomy name)</li>
<li>tax_term=” (string, the term for above taxonomy)</li>
</ul>

example:

<pre><code>

[events_cal cat="actuality" date="-2 months" mondayfirst=1 display_title=1]
</code></pre>

<h3>[event_details]</h3>

<ul>
<li>attribute string (date, start, end, address, location). The default value is NULL and displays the full event bar



[event_details attribute=”address”]</li>
</ul>

<h3>Hooks</h3>

<a></a>

<h4>Filters</h4>

<ul>
<li>eventpost_add_custom_box_position</li>
<li>event_post_class_calendar_link</li>
<li>eventpost_columns_head</li>
<li>eventpost_contentbar</li>
<li>eventpost_default_list_shema</li>
<li>eventpost_get</li>
<li>eventpost_get_items</li>
<li>eventpost_get_post_types</li>
<li>eventpost_get_single</li>
<li>eventpost_getsettings</li>
<li>eventpost_item_scheme_entities</li>
<li>eventpost_item_scheme_values</li>
<li>eventpost_list_shema</li>
<li>eventpost_listevents</li>
<li>eventpost_maps</li>
<li>eventpost_multisite_get</li>
<li>eventpost_multisite_blogids</li>
<li>eventpost_params</li>
<li>eventpost_printdate</li>
<li>eventpost_printlocation</li>
<li>eventpost_bulk_edit_fields</li>
<li>eventpost_quick_edit_fields</li>
<li>eventpost_retreive</li>
<li>event-post-rich-result</li>
<li>eventpost_shortcode_slug</li>
</ul>

<h4>Actions</h4>

<ul>
<li>evenpost_init</li>
<li>eventpost_add_custom_box</li>
<li>eventpost_custom_box_date</li>
<li>eventpost_custom_box_loc</li>
<li>after_eventpost_generator</li>
<li>eventpost_getsettings</li>
<li>eventpost_settings_form</li>
<li>eventpost_after_settings_form</li>
</ul>

Event post

The only WordPress plugin using native posts as full calendar events with begin and end date, geolocation, color and weather.

Atomic Events Calendar vs Event post