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.

dFactory

<p><a href="http://www.dfactory.eu/plugins/events-maker/" rel="nofollow ugc">Events Maker</a> is a fully featured event management plugin from <a href="http://www.dfactory.eu/" rel="nofollow ugc">dFactory</a> including recurring events, locations management, full calendar, iCal feed/files support and google maps integration.</p>
<h4>Powerful, flexible events management</h4>
<p>Events Maker allows you to easily create and manage your events. But at the same time is powerful and very flexible in customization.</p>
<h4>Responsive Events Calendar</h4>
<p>Users can browse for your events in a beautiful, responsive events calendar and display all events for the selected month, week od day.</p>
<h4>Automatic iCal support</h4>
<p>Events Maker automatically generates an iCal feed/files for all your events, categories, tags, locations, organizers and single events which can be used to import event information into calendar applications such as Google Calendar, iCalendar, Outlook, ThunderBird, etc.</p>
<h4>Locations with Google Maps</h4>
<p>Support for event locations and Google Maps has never been easier. Thanks to the geolocation you won’t need to mess around with latitude and longitude.</p>
<h4>WPML & Polylang compatibility</h4>
<p>Events Maker allows you to create and manage events, categories, locations and organizers in different languages using WPML or Polylang. So now, if you build a multilingual website, you won’t have to worry about the multilingual capability anymore.</p>
<h4>Recommended Community Themes:</h4>
<p>Browse beautiful WordPress themes compatible with Events Maker.</p>
<ul>
<li><a href="http://themeforest.net/item/brentwood-golf-course-theme/13653957?ref=dfactory" rel="nofollow ugc">Brentwood</a> – Golf Course Theme</li>
<li><a href="http://themeforest.net/item/wise-mountain-vineyard-and-winery-theme/12368303?ref=dfactory" rel="nofollow ugc">Wise Mountain</a> – Vineyard and Winery Theme</li>
<li><a href="http://themeforest.net/item/the-food-truck-wordpress-theme/12995476?ref=dfactory" rel="nofollow ugc">The Food Truck</a> – Restaurant Theme</li>
<li><a href="http://themeforest.net/item/rock-harbor-church-wordpress-theme/10909693?ref=dfactory" rel="nofollow ugc">Rock Harbor</a> – Church WordPress Theme</li>
<li><a href="http://themeforest.net/item/growler-brewery-wordpress-theme/9177719?ref=dfactory" rel="nofollow ugc">Growler</a> – Brewery WordPress Theme</li>
<li><a href="http://themeforest.net/item/dining-restaurant-wordpress-theme-for-chefs/8294419?ref=dfactory" rel="nofollow ugc">Dining Restaurant</a> – WordPress Theme For Chefs</li>
</ul>
<p>Your favorite theme’s not listed here? Ask the theme developer to make it work with Events Maker – it’s quite simple.</p>
<h4>Features include:</h4>
<ul>
<li>Easy Events management</li>
<li>Built using WordPress custom post types, custom taxonomies and custom post fields</li>
<li>Ajax Events Calendar</li>
<li>Event Search with customizable attributes</li>
<li>Display options for single events</li>
<li>Multiple Tickets and Pricing</li>
<li>Locations list page</li>
<li>Organizers list page</li>
<li>Full Calendar page</li>
<li>Automatic iCal feed/files support</li>
<li>Advanced recurring events, including daily, monthly, yearly and custom occurrences</li>
<li>Compatibility with Twenty Thirteen, Twenty Fourteen and Twenty Fifteen themes </li>
<li>Featured events</li>
<li>Event Categories and Tags</li>
<li>Event Ogranizers</li>
<li>Organizers contact details and image</li>
<li>Event Locations</li>
<li>Breadcrumb navigation</li>
<li>Google maps</li>
<li>Duplicating events</li>
<li>Builtin event gallery</li>
<li>RSS feed support</li>
<li>Customizeable template files</li>
<li>Events sorting</li>
<li>HTML description for event taxonomies</li>
<li>Google Rich Snippets ready</li>
<li>7 Events widgets</li>
<li>Multiple custom functions</li>
<li>Advanced hooks for developers</li>
<li>Custom permissions for Events</li>
<li>Multisite support</li>
<li>Compatible with WPML & Polylang</li>
<li>Compatible with SEO plugins</li>
<li>Customizable permalink structure</li>
<li>.pot file for translations included</li>
</ul>
<h4>Future plans:</h4>
<ul>
<li>Front-end events submissions</li>
<li>Event registration system</li>
</ul>


Events Maker by dFactory

Fully featured event management system including recurring events, locations management, full calendar, iCal feed/files, google maps and more.

Atomic Events Calendar vs Events Maker by dFactory