Árpád 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.

Spiffy Plugins

Bev at Spiffy Plugins

<p>Manage and display your events in a responsive calendar with multiple views, widgets and shortcodes. Color-coded categories and recurrence support. The premium <a href="https://spiffyplugins.ca/spiffycalendar/bonus-add-ons/" rel="nofollow ugc">Bonus Add-Ons</a> supplements the plugin with additional themes, customizer support, ICS export, front end submit, CSV import/export and custom fields.</p>
<blockquote>
<p><a href="https://spiffyplugins.ca/spiffycalendar" rel="nofollow ugc">Demo and Documentation</a></p>
<p><a href="https://spiffyplugins.ca/spiffycalendar/css-snippets/" rel="nofollow ugc">Click here</a> for helpful CSS snippets.</p>
<p><a href="https://spiffyplugins.ca/spiffycalendar/bonus-add-ons/" rel="nofollow ugc">Click here</a> to learn about Bonus Add-Ons.</p>
</blockquote>
<h3>Features</h3>
<h4>Post/page displays:</h4>
<ul>
<li>Standard monthly calendar grid that toggles to a list view</li>
<li>Category filter in the monthly calendar grid</li>
<li>Responsive 3-column event listing</li>
<li>Mini-calendar view for compact displays</li>
<li>Weekly calendar grid</li>
<li>Today’s events list</li>
<li>Upcoming events list</li>
</ul>
<h4>Widgets:</h4>
<ul>
<li>Featured event</li>
<li>Today’s events list</li>
<li>Upcoming events list</li>
<li>Mini Calendar</li>
</ul>
<h4>Categories:</h4>
<ul>
<li>Color-coded categories</li>
<li>Option to display category color as background or foreground on the standard calendar grid</li>
<li>Displays may be filtered by category list</li>
<li>Optional sort categories alphabetically </li>
<li>Live category filter on the full calendar</li>
</ul>
<h4>Other features:</h4>
<ul>
<li>Mouse-over details for each event</li>
<li>Choice of popup, columns or expanded display of lists</li>
<li>Events can display their author (optional)</li>
<li>Add custom CSS styles or just use the defaults</li>
<li>Display upcoming events in your MailPoet newsletters</li>
<li>Display week number in the full calendar</li>
<li>Filters to allow additional formatting</li>
<li>Optional responsive display for the full size calendar</li>
<li>Optional drop down boxes to quickly change month and year</li>
<li>Front end quick links to edit/delete events for logged in admins</li>
</ul>
<h4>Enter and display for each event:</h4>
<ul>
<li>title, </li>
<li>description, </li>
<li>location,</li>
<li>link to Google map,</li>
<li>event category, </li>
<li>status,</li>
<li>link, </li>
<li>event start/end date</li>
<li>event start/end time</li>
<li>event recurrence details</li>
<li>event hiding details</li>
<li>event image</li>
<li>custom fields <a href="https://spiffyplugins.ca/spiffycalendar/bonus-add-ons/" rel="nofollow ugc">(premium)</a></li>
</ul>
<h4>Schedule a wide variety of recurring events.</h4>
<ul>
<li>Events can repeat on a daily (set numbers of days), weekly, monthly (by date), monthly (by day of week) or yearly basis</li>
<li>Repeats can occur indefinitely or a limited number of times</li>
<li>Events can span more than one day</li>
</ul>
<h4>Hide all events for specific days:</h4>
<ul>
<li>Hide repeating event for a single day such as a holiday</li>
<li>Hide full days of events that span more than one day</li>
<li>Substitute new title to replace hidden events</li>
<li>Select override based on category</li>
</ul>
<h4>Easy to use events manager in admin dashboard</h4>
<ul>
<li>Comprehensive settings panel for admin</li>
<li>User groups other than admin can be permitted to manage events</li>
<li>Authors can be restricted to editing their own events only</li>
</ul>
<p><strong>BONUS FEATURES AVAILABLE WITH DONATION</strong></p>
<ul>
<li>Premium themes</li>
<li>Live theme customizer</li>
<li>ICS export</li>
<li>Front End submit form with captcha</li>
<li>Front End edit/delete events</li>
<li>Import/Export events via CSV</li>
<li>Custom fields</li>
</ul>
<p><a href="https://spiffyplugins.ca/spiffycalendar/bonus-add-ons/" rel="nofollow ugc">Learn more about bonus add-ons</a></p>


Spiffy Calendar

Manage and display your events in a responsive calendar with multiple views, widgets and shortcodes. Color-coded categories and recurrence support.

Atomic Events Calendar vs Spiffy Calendar